JP1 Version 10

JP1/Performance Management - Agent Option for IBM WebSphere Application Server

解説・文法書

3021-3-068

目　　次

前書き

はじめに

第1編　概要編

1.　PFM - Agent for WebSphere Application Serverの概要

1.1　PFM - Agent for WebSphere Application Serverの特長

1.1.1　WebSphere Application Serverのパフォーマンスデータを収集できます

1.1.2　パフォーマンスデータの性質に応じた方法で収集できます

1.1.3　パフォーマンスデータを保存できます

1.1.4　WebSphere Application Serverの運用上の問題点を通知できます

1.1.5　アラームおよびレポートが容易に定義できます

1.1.6　クラスタシステムで運用できます

1.2　パフォーマンスデータの収集と管理の概要

1.3　PFM - Agent for WebSphere Application Serverを使ったパフォーマンス監視の例

1.3.1　パフォーマンス監視の概要

1.3.2　WebSphere Application Serverの稼働状態の監視

1.3.3　JavaVMのCPU使用率の監視

1.3.4　JavaVMのメモリー使用率の監視

1.3.5　スレッドプール使用率の監視

1.3.6　JDBC接続プールの使用率の監視

第2編　構築・運用編

2.　インストールとセットアップ（Windowsの場合）

2.1　インストールとセットアップ

2.1.1　インストールとセットアップの流れ

2.1.2　インストールとセットアップの前に

2.1.3　インストール手順

2.1.4　PFM - Agent for WebSphere Application Serverのセットアップ手順

2.2　アンインストールとアンセットアップ

2.2.1　アンインストールとアンセットアップの前に

2.2.2　アンセットアップ手順

2.2.3　アンインストール手順

2.3　PFM - Agent for WebSphere Application Serverのシステム構成の変更

2.4　PFM - Agent for WebSphere Application Serverの運用方式の変更

2.4.1　パフォーマンスデータの格納先の変更

2.4.2　インスタンス環境の更新の設定

2.4.3　Storeバージョン2.0への移行

2.5　コマンドプロンプトの起動方法

2.6　バックアップとリストア

2.6.1　バックアップ

2.6.2　リストア

2.7　Webブラウザでマニュアルを参照するための設定

2.7.1　設定手順

2.7.2　参照手順

3.　インストールとセットアップ（UNIXの場合）

3.1　インストールとセットアップ

3.1.1　インストールとセットアップの流れ

3.1.2　インストールとセットアップの前に

3.1.3　インストール手順

3.1.4　PFM - Agent for WebSphere Application Serverのセットアップ手順

3.2　アンインストールとアンセットアップ

3.2.1　アンインストールとアンセットアップの前に

3.2.2　アンセットアップ手順

3.2.3　アンインストール手順

3.3　PFM - Agent for WebSphere Application Serverのシステム構成の変更

3.4　PFM - Agent for WebSphere Application Serverの運用方式の変更

3.4.1　パフォーマンスデータの格納先の変更

3.4.2　インスタンス環境の更新の設定

3.4.3　Storeバージョン2.0への移行

3.5　バックアップとリストア

3.5.1　バックアップ

3.5.2　リストア

3.6　Webブラウザでマニュアルを参照するための設定

3.6.1　設定手順

3.6.2　参照手順

4.　クラスタシステムでの運用

4.1　クラスタシステムの概要

4.1.1　HAクラスタシステム

4.2　フェールオーバー時の処理

4.2.1　PFM - Agentホストに障害が発生した場合のフェールオーバー

4.2.2　PFM - Managerが停止した場合の影響

4.3　インストールとセットアップ（Windowsの場合）

4.3.1　インストールとセットアップの流れ

4.3.2　インストールとセットアップの前に

4.3.3　インストール手順

4.3.4　セットアップ手順

4.4　インストールとセットアップ（UNIXの場合）

4.4.1　インストールとセットアップの流れ

4.4.2　インストールとセットアップの前に

4.4.3　インストール手順

4.4.4　セットアップ手順

4.5　アンインストールとアンセットアップ（Windowsの場合）

4.5.1　PFM - Agent for WebSphere Application Serverのアンインストールとアンセットアップの流れ

4.5.2　アンセットアップ手順

4.5.3　アンインストール手順

4.6　アンインストールとアンセットアップ（UNIXの場合）

4.6.1　PFM - Agent for WebSphere Application Serverのアンインストールとアンセットアップの流れ

4.6.2　アンセットアップ手順

4.6.3　アンインストール手順

4.7　PFM - Agent for WebSphere Application Serverのシステム構成の変更

4.8　PFM - Agent for WebSphere Application Serverの運用方式の変更

4.8.1　インスタンス環境の更新の設定

4.8.2　論理ホスト環境定義ファイルのエクスポート・インポート

第3編　リファレンス編

5.　監視テンプレート

監視テンプレートの概要

アラームの記載形式

アラーム一覧

JDBC Connection Pool

JVM Use CPU

JVM Use Memory

Server State

Thread Pool

レポートの記載形式

レポートのフォルダ構成

レポート一覧

J2C Connection Pool Use Rate（最近1時間の履歴レポート）

JDBC Connection Pool Use Rate（最近1か月間の履歴レポート）

JDBC Connection Pool Use Rate（最近24時間の履歴レポート）

JDBC Connection Pool Use Rate（リアルタイムレポート）

JDBC Connection Pool Use Rate（最近1時間の履歴レポート）

JVM Resource Use Rate（最近1か月の履歴レポート）

JVM Resource Use Rate（最近24時間の履歴レポート）

JVM Resource Use Rate（リアルタイムレポート）

JVM Resource Use Rate（最近1時間の履歴レポート）

Lookup Time（最近1時間の履歴レポート）

Method Response Time（最近1時間の履歴レポート）

Response Time（最近1時間の履歴レポート）

Server State（最近1時間の履歴レポート）

Service Time（最近1時間の履歴レポート）

Thread Pool Use Rate（最近1か月間の履歴レポート）

Thread Pool Use Rate（最近24時間の履歴レポート）

Thread Pool Use Rate（リアルタイムレポート）

Thread Pool Use Rate（最近1時間の履歴レポート）

6.　レコード

データモデルについて

レコードの記載形式

ODBCキーフィールド一覧

要約ルール

データ型一覧

フィールドの値

Storeデータベースに記録されるときだけ追加されるフィールド

Storeデータベースに格納されているデータをエクスポートすると出力されるフィールド

レコード一覧

Server State（PD）

Server Information（PI）

EJB（PI_EJB）

J2C Connection Pool（PI_J2C）

JDBC Connection Pool（PI_JDBC）

Java VM（PI_JVM）

ORB（PI_ORB）

Servlet（PI_SVLT）

Thread Pool（PI_THRP）

Transaction（PI_TRNS）

Web Application（PI_WEBA）

Web Container（PI_WEBC）

Web Service（PI_WEBS）

7.　メッセージ

7.1　メッセージの形式

7.1.1　メッセージの出力形式

7.1.2　メッセージの記載形式

7.2　メッセージの出力先一覧

7.3　syslogとWindowsイベントログの一覧

7.4　メッセージ一覧

第4編　トラブルシューティング編

8.　トラブルへの対処方法

8.1　対処の手順

8.2　トラブルシューティング

8.2.1　セットアップやサービスの起動について

8.2.2　コマンドの実行について

8.2.3　レポートの定義について

8.2.4　アラームの定義について

8.2.5　パフォーマンスデータの収集と管理について

8.2.6　その他のトラブルについて

8.3　ログ情報

8.3.1　ログ情報の種類

8.3.2　ログファイルおよびディレクトリ一覧

8.4　トラブル発生時に採取が必要な資料

8.4.1　Windowsの場合

8.4.2　UNIXの場合

8.5　資料の採取方法

8.5.1　Windowsの場合

8.5.2　UNIXの場合

8.6　Performance Managementの障害検知

8.7　Performance Managementシステムの障害回復

付録

付録A　システム見積もり

付録A.1　メモリー所要量

付録A.2　ディスク占有量

付録A.3　クラスタ運用時のディスク占有量

付録B　カーネルパラメーター

付録C　識別子一覧

付録D　プロセス一覧

付録E　ポート番号一覧

付録E.1　PFM - Agent for WebSphere Application Serverのポート番号

付録E.2　ファイアウォールの通過方向

付録F　PFM - Agent for WebSphere Application Serverのプロパティ

付録F.1　Agent Storeサービスのプロパティ一覧

付録F.2　Agent Collectorサービスのプロパティ一覧

付録G　ファイルおよびディレクトリ一覧

付録G.1　PFM - Agent for WebSphere Application Serverのファイルおよびディレクトリ一覧

付録H　バージョン互換

付録I　動作ログの出力

付録I.1　動作ログに出力される事象の種別

付録I.2　動作ログの保存形式

付録I.3　動作ログの出力形式

付録I.4　動作ログを出力するための設定

付録J　JP1/ITSLMとの連携

付録K　各バージョンの変更内容

付録K.1　10-00の変更内容

付録K.2　09-00の変更内容

付録L　このマニュアルの参考情報

付録L.1　関連マニュアル

付録L.2　このマニュアルでの表記

付録L.3　英略語

付録L.4　このマニュアルでのプロダクト名，サービスID，およびサービスキーの表記

付録L.5　Performance Managementのインストール先フォルダの表記

付録L.6　Performance Managementで対応するNNM製品について

付録L.7　KB（キロバイト）などの単位表記について

付録M　用語解説

索引

[他社商品名称に関する表示]

Copyright (C) 2012, Hitachi, Ltd.
Copyright (C) 2012, Hitachi Solutions, Ltd.

前書き

■ 対象製品

●JP1/Performance Management - Manager（適用OS：Windows）

P-2W2C-AAA4　 JP1/Performance Management - Manager　 10-00

製品構成一覧および内訳形名

P-242C-AAA4　 JP1/Performance Management - Manager　 10-00（適用OS：Windows Server 2003）
P-2A2C-AAA4　 JP1/Performance Management - Manager　 10-00（適用OS：Windows Server 2008）

●JP1/Performance Management - Manager（適用OS：UNIX）

P-1J2C-AAA1　 JP1/Performance Management - Manager　 10-00（適用OS：HP-UX 11i V3 (IPF)）
P-812C-AAA1　 JP1/Performance Management - Manager　 10-00（適用OS：Linux 6 (x64)，Linux 6 (x86)）
P-9D2C-AAA1　 JP1/Performance Management - Manager　 10-00（適用OS：Solaris 10 (SPARC)）
P-1M2C-AAA1　 JP1/Performance Management - Manager　 10-00（適用OS：AIX V6.1，AIX V7.1）

●JP1/Performance Management - Base（適用OS：Windows）

P-2W2C-AJA4　 JP1/Performance Management - Base　 10-00

製品構成一覧および内訳形名

P-242C-AJA4　 JP1/Performance Management - Base　 10-00（適用OS：Windows Server 2003）
P-2A2C-AJA4　 JP1/Performance Management - Base　 10-00（適用OS：Windows Server 2008）

●JP1/Performance Management - Base（適用OS：UNIX）

P-812C-AJA1　 JP1/Performance Management - Base　 10-00（適用OS：Linux 6 (x64)，Linux 6 (x86)）
P-9D2C-AJA1　 JP1/Performance Management - Base　 10-00（適用OS：Solaris 10 (SPARC)）
P-1M2C-AJA1　 JP1/Performance Management - Base　 10-00（適用OS：AIX V6.1，AIX V7.1）

●JP1/Performance Management - Web Console（適用OS：Windows）

P-2W2C-ARA4　 JP1/Performance Management - Web Console　 10-00

製品構成一覧および内訳形名

P-242C-ARA4　 JP1/Performance Management - Web Console　 10-00（適用OS：Windows Server 2003）
P-2A2C-ARA4　 JP1/Performance Management - Web Console　 10-00（適用OS：Windows Server 2008）

●JP1/Performance Management - Web Console（適用OS：UNIX）

P-1J2C-ARA1　 JP1/Performance Management - Web Console　 10-00（適用OS：HP-UX 11i V3 (IPF)）
P-812C-ARA1　 JP1/Performance Management - Web Console　 10-00（適用OS：Linux 6 (x64)，Linux 6 (x86)）
P-9D2C-ARA1　 JP1/Performance Management - Web Console　 10-00（適用OS：Solaris 10 (SPARC)）
P-1M2C-ARA1　 JP1/Performance Management - Web Console　 10-00（適用OS：AIX V6.1，AIX V7.1）

●JP1/Performance Management - Agent Option for IBM WebSphere Application Server（適用OS：Windows）

R-1W29W-A1　 JP1/Performance Management - Agent Option for IBM WebSphere Application Server　 10-00

製品構成一覧および内訳形名

R-1529W-A1　 JP1/Performance Management - Agent Option for IBM WebSphere Application Server　 10-00（適用OS：Windows Server 2003）
R-1A29W-A1　 JP1/Performance Management - Agent Option for IBM WebSphere Application Server　 10-00（適用OS：Windows Server 2008）

●JP1/Performance Management - Agent Option for IBM WebSphere Application Server（適用OS：UNIX）

R-1S29W-A1　 JP1/Performance Management - Agent Option for IBM WebSphere Application Server　 10-00（適用OS：Linux 6 (x64)，Linux 6 (x86)）
R-1929W-A1　 JP1/Performance Management - Agent Option for IBM WebSphere Application Server　 10-00（適用OS：Solaris 10 (SPARC)）
R-1M29W-A1　 JP1/Performance Management - Agent Option for IBM WebSphere Application Server　 10-00（適用OS：AIX V6.1，AIX V7.1）

これらの製品には，他社からライセンスを受けて開発した部分が含まれています。

■ 輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。
なお，ご不明な場合は，弊社担当営業にお問い合わせください。

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
BEAは，BEA Systems, Inc.の登録商標です。
BEA JRockitは，BEA Systems, Inc.の商標です。
BEA WebLogic Serverは，BEA Systems, Inc.の登録商標です。
DB2は，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
DB2 Universal Databaseは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
HP-UXは，Hewlett-Packard Development Company, L.P.のオペレーティングシステムの名称です。
IBMは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Lotusは，IBM Corporationの登録商標です。
Lotus Dominoは，IBM Corporationの登録商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Exchange Serverは，米国Microsoft Corporationの商品名称です。
MicrosoftおよびHyper-Vは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Internet Information Serverは，米国Microsoft Corporationの商品名称です。
Microsoft Internet Information Servicesは，米国Microsoft Corporationの商品名称です。
MicrosoftおよびSQL Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
NetWareは，米国Novell, Inc.の登録商標です。
ODBCは，米国Microsoft Corporationが提唱するデータベースアクセス機構です。
OpenViewは，Hewlett-Packard Development Company, L.P.の商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
R/3は，SAP AGのドイツ及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
SAPは，SAP AGのドイツ及びその他の国における登録商標または商標です。
すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
VMware, Virtual SMP, VMotionは，VMware, Inc.の米国および各国での登録商標または商標です。
VMwareおよびESXは，VMware, Inc.の米国および各国での登録商標または商標です。
WebSphereは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Win32は，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows NTは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。
プログラムプロダクト「P-9D2C-AAA1，P-9D2C-ARA1」には，Oracle Corporationまたはその子会社，関連会社が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2C-AAA1，P-9D2C-ARA1」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
This product includes software developed by IAIK of Graz University of Technology.
Oracle and Java are registered trademarks of Oracle and/or its affiliates.
Other company and product names mentioned in this document may be the trademarks of their respective owners.

■ マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記 | 製品名
Internet Explorer | Microsoft(R) Internet Explorer(R)
Windows(R) Internet Explorer(R)
Windows Server 2003 | Windows Server 2003 (x64)または2003 (x64) | Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003, Standard x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition
Windows Server 2003 (x86)または2003 (x86) | Microsoft(R) Windows Server(R) 2003, Enterprise Edition
Microsoft(R) Windows Server(R) 2003, Standard Edition
Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard Edition
Windows Server 2008 | Windows Server 2008 Datacenter | Microsoft(R) Windows Server(R) 2008 R2 Datacenter
Windows Server 2008 Enterprise | Microsoft(R) Windows Server(R) 2008 Enterprise
Microsoft(R) Windows Server(R) 2008 Enterprise without Hyper-V(TM)
Microsoft(R) Windows Server(R) 2008 R2 Enterprise
Windows Server 2008 Standard | Microsoft(R) Windows Server(R) 2008 Standard
Microsoft(R) Windows Server(R) 2008 Standard without Hyper-V(TM)
Microsoft(R) Windows Server(R) 2008 R2 Standard
Win32 | Win32(R)

Windows Server 2003およびWindows Server 2008を総称して，Windowsと表記することがあります。

■ 発行

2012年10月 3021-3-068

■ 著作権

Copyright (C) 2012, Hitachi, Ltd.
Copyright (C) 2012, Hitachi Solutions, Ltd.

はじめに

このマニュアルは，JP1/Performance Management - Agent Option for IBM WebSphere Application Serverの機能や収集レコードなどについて説明したものです。

＜はじめにの構成＞

対象読者

マニュアルの構成

読書手順

このマニュアルで使用する記号

このマニュアルの数式中で使用する記号

図中で使用する記号

フォルダおよびディレクトリの統一表記

このマニュアルでのコマンドの表記

対象読者

このマニュアルは，次の方を対象としています。

稼働監視システムを設計または構築したい方

パフォーマンスデータの収集条件を定義したい方

レポートおよびアラームを定義したい方

収集したパフォーマンスデータを参照して，システムを監視したい方

監視結果を基に，システムへの対策を検討または指示したい方

また， IBM WebSphere Application Serverおよび監視対象システムの運用について熟知していること，およびOSに対する知識があることを前提としています。

なお，JP1/Performance Managementを使用したシステムの構築，運用方法については，次のマニュアルもあわせてご使用ください。

JP1 Version 10 JP1/Performance Management 設計・構築ガイド（3021-3-041）

JP1 Version 10 JP1/Performance Management 運用ガイド（3021-3-042）

JP1 Version 10 JP1/Performance Management リファレンス（3021-3-043）

マニュアルの構成

このマニュアルは，次に示す編から構成されています。なお，このマニュアルはWindows Server 2003，Windows Server 2008，Linux(R)，Solaris，およびAIXの各OS（Operating System）に共通のマニュアルです。OSごとに差異がある場合は，本文中でそのつど内容を書き分けています。

第1編　概要編

JP1/Performance Management - Agent Option for IBM WebSphere Application Serverの概要について説明しています。

第2編　構築・運用編

JP1/Performance Management - Agent Option for IBM WebSphere Application Serverのインストールとセットアップ，およびクラスタシステムでの運用について説明しています。

第3編　リファレンス編

JP1/Performance Management - Agent Option for IBM WebSphere Application Serverの監視テンプレート，収集レコード，およびメッセージについて説明しています。

第4編　トラブルシューティング編

JP1/Performance Management - Agent Option for IBM WebSphere Application Serverでトラブルが発生したときの対処方法について説明しています。

読書手順

このマニュアルは，利用目的に合わせて章を選択して読むことができます。利用目的別にお読みいただくことをお勧めします。

マニュアルを読む目的 | 記述個所
JP1/Performance Management - Agent Option for IBM WebSphere Application Serverの特長を知りたい。 | 1章
JP1/Performance Management - Agent Option for IBM WebSphere Application Serverの機能概要を知りたい。 | 1章
JP1/Performance Management - Agent Option for IBM WebSphere Application ServerをWindowsホストに導入するときの作業を知りたい。 | 2章
JP1/Performance Management - Agent Option for IBM WebSphere Application ServerをUNIXホストに導入するときの作業を知りたい。 | 3章
JP1/Performance Management - Agent Option for IBM WebSphere Application Serverのクラスタシステムでの運用を知りたい。 | 4章
JP1/Performance Management - Agent Option for IBM WebSphere Application Serverの監視テンプレートについて知りたい。 | 5章
JP1/Performance Management - Agent Option for IBM WebSphere Application Serverのレコードについて知りたい。 | 6章
JP1/Performance Management - Agent Option for IBM WebSphere Application Serverのメッセージについて知りたい。 | 7章
障害発生時の対処方法について知りたい。 | 8章

このマニュアルで使用する記号

このマニュアルで使用する記号を次に示します。

記号
意　味

［ ］
ウィンドウ，タブ，メニュー，ダイアログボックス，ダイアログボックスのボタン，ダイアログボックスのチェックボックスなどを示します。
（例）
［メイン］ウィンドウ
［Properties］タブ

パラメーターの指定の個所では，省略可能なパラメーターであることを示します。
（例）
　［users=UNIXユーザー名］
　［groups=UNIXグループ名］

太字
重要な用語，または利用状況によって異なる値であることを示します。

このマニュアルの数式中で使用する記号

このマニュアルの数式中で使用する記号を次に示します。

記号 | 意　味
＊ | 乗算記号を示します。
/ | 除算記号を示します。

図中で使用する記号

このマニュアルの図中で使用する記号を次のように定義します。

フォルダおよびディレクトリの統一表記

このマニュアルでは，Windowsで使用されている「フォルダ」とUNIXで使用されている「ディレクトリ」とが同じ場合，原則として，「ディレクトリ」と統一表記しています。

このマニュアルでのコマンドの表記

Performance Management 09-00以降では，08-51以前のコマンドと互換性を持つ新形式のコマンドが追加されました。このため，このマニュアルではコマンドを次のように表記しています。

新形式のコマンド（08-51以前のコマンド）

（例）

インストール先フォルダ¥tools¥jpcconf agent setup (インストール先フォルダ¥tools¥jpcagtsetup)

この例では，jpcconf agent setupが新形式のコマンドで，jpcagtsetupが08-51以前のコマンドになります。

新形式のコマンドを使用できるのは，PFM - Agentの同一装置内の前提プログラム（PFM - ManagerまたはPFM - Base）のバージョンが09-00以降の場合です。なお，前提プログラムのバージョンが09-00以降の場合でも，08-51以前のコマンドは使用できます。

1.　PFM - Agent for WebSphere Application Serverの概要

この章では，PFM - Agent for WebSphere Application Serverの特長，概要，および運用例について説明します。

＜この章の構成＞

1.1　PFM - Agent for WebSphere Application Serverの特長

1.2　パフォーマンスデータの収集と管理の概要

1.3　PFM - Agent for WebSphere Application Serverを使ったパフォーマンス監視の例

1.1　PFM - Agent for WebSphere Application Serverの特長

PFM - Agent for WebSphere Application Serverは，WebSphere Application Serverのパフォーマンスを監視するために，パフォーマンスデータを収集および管理するプログラムです。

PFM - Agent for WebSphere Application Serverの特長を次に示します。

WebSphere Application Serverの稼働状況を分析できる
監視対象のWebSphere Application Serverから，スレッドプールの使用率などのパフォーマンスデータをPFM - Agent for WebSphere Application Serverで収集および集計し，その傾向や推移を図示することで，WebSphere Application Serverの稼働状況の分析が容易にできます。

WebSphere Application Serverの運用上の問題点を早期に発見し，トラブルの原因を調査する資料を提供できる
監視対象のWebSphere Application Serverの稼働状況に問題の予兆が見られた場合，Eメールなどを使ってユーザーに通知することで，問題点を早期に発見できます。また，その問題点に関連する情報を図示することで，トラブルの原因を調査する資料を提供できます。

PFM - Agent for WebSphere Application Serverを使用するには，PFM - ManagerおよびPFM - Web Consoleが必要です。

PFM - Agent for WebSphere Application Serverについて次に説明します。

＜この節の構成＞

1.1.1　WebSphere Application Serverのパフォーマンスデータを収集できます

1.1.2　パフォーマンスデータの性質に応じた方法で収集できます

1.1.3　パフォーマンスデータを保存できます

1.1.4　WebSphere Application Serverの運用上の問題点を通知できます

1.1.5　アラームおよびレポートが容易に定義できます

1.1.6　クラスタシステムで運用できます

1.1.1　WebSphere Application Serverのパフォーマンスデータを収集できます

PFM - Agent for WebSphere Application Serverを使用すると，WebSphere Application Serverのスレッドプールの使用率など，パフォーマンスデータが収集できます。

注意

PFM - Agent for WebSphere Application Serverでは，7ビットアスキー以外の文字が含まれるパフォーマンスデータは収集できません。

PFM - Agent for WebSphere Application Serverでは，パフォーマンスデータを次のように利用できます。

WebSphere Application Serverの稼働状況をグラフィカルに表示する
パフォーマンスデータは，PFM - Web Consoleを使用して，「レポート」と呼ばれるグラフィカルな形式に加工し，表示できます。レポートによって，WebSphere Application Serverの稼働状況がよりわかりやすく分析できるようになります。
レポートには，次の二種類があります。

リアルタイムレポート
監視しているWebSphere Application Serverの現在の状況を示すレポートです。主に，監視対象の現在の状態や問題点を確認するために使用します。リアルタイムレポートの表示には，収集した時点のパフォーマンスデータが直接使用されます。

履歴レポート
監視しているWebSphere Application Serverの過去から現在までの状況を示すレポートです。主に，監視対象の傾向を分析するために使用します。履歴レポートの表示には，PFM - Agent for WebSphere Application Serverのデータベースに格納されたパフォーマンスデータが使用されます。

問題が起こったかどうかの判定条件として使用する
収集されたパフォーマンスデータの値が何らかの異常を示した場合，ユーザーに通知するなどの処置を設定できます。

1.1.2　パフォーマンスデータの性質に応じた方法で収集できます

パフォーマンスデータは，「レコード」の形式で収集されます。各レコードは，「フィールド」と呼ばれるさらに細かい単位に分けられます。レコードおよびフィールドの総称を「データモデル」と呼びます。

レコードは，性質によって2つのレコードタイプに分けられます。どのレコードにどのパフォーマンスデータが収集されるかは，PFM - Agent for WebSphere Application Serverで定義されています。ユーザーは，PFM - Web Consoleを使用して，どのパフォーマンスデータのレコードを収集するか選択します。

PFM - Agent for WebSphere Application Serverのレコードタイプを次に示します。

Product Intervalレコードタイプ（以降，PIレコードタイプと省略します）
PIレコードタイプのレコードには，1分ごとのJVMランタイムのメモリー使用率など，ある一定の時間（インターバル）ごとのパフォーマンスデータが収集されます。PIレコードタイプは，時間の経過に伴う監視対象の状態の変化や傾向を分析したい場合に使用します。

Product Detailレコードタイプ（以降，PDレコードタイプと省略します）
PDレコードタイプのレコードには，WebSphere Application Serverの稼働状態など，ある時点での監視対象の状態を示すパフォーマンスデータが収集されます。PDレコードタイプは，ある時点での監視対象の状態を知りたい場合に使用します。

各レコードについては，「6. レコード」を参照してください。

1.1.3　パフォーマンスデータを保存できます

収集したパフォーマンスデータを，PFM - Agent for WebSphere Application Serverの「Storeデータベース」と呼ばれるデータベースに格納することで，現在までのパフォーマンスデータを保存し，WebSphere Application Serverの稼働状況について，過去から現在までの傾向を分析できます。傾向を分析するためには，履歴レポートを使用します。

ユーザーは，PFM - Web Consoleを使用して，どのパフォーマンスデータのレコードをStoreデータベースに格納するか選択します。PFM - Web Consoleでのレコードの選択方法については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

1.1.4　WebSphere Application Serverの運用上の問題点を通知できます

PFM - Agent for WebSphere Application Serverで収集したパフォーマンスデータは，WebSphere Application Serverのパフォーマンスをレポートとして表示するのに利用できるだけでなく，WebSphere Application Serverを運用していて問題が起こったり，障害が発生したりした場合にユーザーに警告することもできます。

例えば，JVMランタイムのメモリー使用率が80%を上回った場合，ユーザーにEメールで通知するとします。このように運用するために，「JVMランタイムのメモリー使用率が80%以上」を異常条件のしきい値として，そのしきい値に達した場合，Eメールをユーザーに送信するように設定します。しきい値に達した場合に取る動作を「アクション」と呼びます。アクションには，次の種類があります。

Eメールの送信

コマンドの実行

SNMPトラップの発行

JP1イベントの発行

しきい値やアクションを定義したものを「アラーム」と呼びます。1つ以上のアラームを1つのテーブルにまとめたものを「アラームテーブル」と呼びます。アラームテーブルを定義したあと，PFM - Agent for WebSphere Application Serverと関連づけます。アラームテーブルとPFM - Agent for WebSphere Application Serverとを関連づけることを「バインド」と呼びます。バインドすると，PFM - Agent for WebSphere Application Serverによって収集されているパフォーマンスデータが，アラームで定義したしきい値に達した場合，ユーザーに通知できるようになります。

このように，アラームおよびアクションを定義することで，WebSphere Application Serverの運用上の問題を早期に発見し，対処できます。

アラームおよびアクションの設定方法については，マニュアル「JP1/Performance Management 運用ガイド」の，アラームによる稼働監視について説明している章を参照してください。

1.1.5　アラームおよびレポートが容易に定義できます

PFM - Agent for WebSphere Application Serverでは，「監視テンプレート」と呼ばれる，必要な情報があらかじめ定義されたレポートおよびアラームを提供しています。この監視テンプレートを使用することで，複雑な定義をしなくてもWebSphere Application Serverの運用状況を監視する準備が容易にできるようになります。監視テンプレートは，ユーザーの環境に合わせてカスタマイズすることもできます。監視テンプレートの使用方法については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働分析のためのレポートの作成またはアラームによる稼働監視について説明している章を参照してください。また，監視テンプレートの詳細については，「5.　監視テンプレート」を参照してください。

1.1.6　クラスタシステムで運用できます

クラスタシステムを使うと，システムに障害が発生した場合にも，継続して業務を運用できる信頼性の高いシステムが構築できます。このため，システムに障害が発生した場合でもPerformance Managementの24時間稼働および24時間監視ができます。

クラスタシステムで監視対象ホストに障害が発生した場合の運用例を次の図に示します。

図1-1　クラスタシステムの運用例

同じ設定の環境を2つ構築し，通常運用する方を「実行系ノード」，障害発生時に使う方を「待機系ノード」として定義しておきます。

クラスタシステムでのPerformance Managementの運用については，「4.　クラスタシステムでの運用」を参照してください。

1.2　パフォーマンスデータの収集と管理の概要

パフォーマンスデータの収集方法と管理方法は，パフォーマンスデータが格納されるレコードのレコードタイプによって異なります。PFM - Agent for WebSphere Application Serverのレコードは，次の2つのレコードタイプに分けられます。

PIレコードタイプ

PDレコードタイプ

パフォーマンスデータの収集方法と管理方法について，次に説明します。

パフォーマンスデータの収集方法
パフォーマンスデータの収集方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，Performance Managementの機能について説明している章を参照してください。
収集されるパフォーマンスデータの値については，「6.　レコード」を参照してください。

パフォーマンスデータの管理方法
パフォーマンスデータの管理方法については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

PFM - Agent for WebSphere Application Serverで収集および管理されているレコードのうち，どのパフォーマンスデータを利用するかは，PFM - Web Consoleで選択します。選択方法については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

1.3　PFM - Agent for WebSphere Application Serverを使ったパフォーマンス監視の例

＜この節の構成＞

1.3.1　パフォーマンス監視の概要

1.3.2　WebSphere Application Serverの稼働状態の監視

1.3.3　JavaVMのCPU使用率の監視

1.3.4　JavaVMのメモリー使用率の監視

1.3.5　スレッドプール使用率の監視

1.3.6　JDBC接続プールの使用率の監視

1.3.1　パフォーマンス監視の概要

＜この項の構成＞

(1)　パフォーマンス監視の目的

(2)　ベースラインの選定

(1)　パフォーマンス監視の目的

パフォーマンスを監視することは，WebSphere Application Serverの運用管理では重要な作業です。

PFM - Agent for WebSphere Application Serverを用いたパフォーマンス監視は，主に次の目的で使用できます。

WebSphere Application Serverが正しく動作しているか監視する

パフォーマンスデータを分析し，パフォーマンス低下の原因を発見する

WebSphere Application Serverが正しく動作しているかどうかは，次のような監視によって確認できます。

WebSphere Application Serverの稼働状態の監視

WebSphere Application Serverでは，システムダウンやスローダウンなどパフォーマンスが低下する場合があります。パフォーマンスに影響を与える要因としては，次のようなものがあります。

JavaVMのCPU使用率

JavaVMのメモリー使用率

スレッドプールの使用率

JDBC接続プールの使用率

WebSphere Application Serverを安定稼働させるためには，PFM - Agent for WebSphere Application Serverを用いて，これらのパフォーマンスを正しく監視することが重要です。

(2)　ベースラインの選定

ベースラインの選定とは，システム運用で問題なしと想定されるラインをパフォーマンス測定結果から選定する作業です。

JP1/PFM製品では，ベースラインの値を「しきい値」とすることで，システムの運用を監視します。ベースラインの選定は「しきい値」を決定し，パフォーマンスを監視するにあたっての重要な作業となります。

なお，ベースラインの選定では，次のように実施することをお勧めします。

運用環境の高負荷テスト時など，ピーク時の状態を測定する

WebSphere Application Serverの構成によってしきい値が大きく異なるため，システムリソースや運用環境を変更する場合は，再度ベースラインを測定する

次に，それぞれのパフォーマンスの監視方法について例を挙げて紹介します。なお，この節で説明するパフォーマンス監視のしきい値はあくまで参考値です。具体的なしきい値については，ベースラインを測定し，決定してください。また，具体的な設定項目については，WebSphere Application Serverの運用形態に合わせて，検討する必要があります。

1.3.2　WebSphere Application Serverの稼働状態の監視

予期しないサーバの停止に備えるために，WebSphere Application Serverの稼働状態を監視します。WebSphere Application Serverの稼働状態は，監視テンプレートで提供している「Server State」アラームを使用することで監視できます。

監視テンプレート「Server State」アラームを次の表に示します。

表1-1　監視テンプレート「Server State」アラーム

アラーム | 使用レコード | 使用フィールド | 異常条件 | 警告条件 | 値の見方
Server State | PD | State | State = 0 | State = 0 | WebSphere Application Serverの稼働状態。稼働している場合は1，それ以外の場合は0。

しきい値に対する考え方

Stateフィールドが0の場合，次のような要因が考えられます。

PFM - Agent for WebSphere Application Serverのインスタンス環境の設定が誤っている

監視対象のWebSphere Application Serverが停止している

監視対象のWebSphere Application Serverがハングアップしている

対処方法

PFM - Agent for WebSphere Application Serverのインスタンス環境の設定に誤りがないかを確認してください。

セットアップに誤りがない場合は，監視対象のWebSphere Application Serverが停止していないか，またはハングアップ状態になっていないかを確認し，必要に応じてWebSphere Application Serverを再起動してください。

Server Stateアラームの詳細については，「5.　監視テンプレート」の「Server State」を参照してください。

1.3.3　JavaVMのCPU使用率の監視

WebSphere Application Serverの動作基盤であるJavaVMのCPU使用率を監視することで，WebSphere Application Server全体の処理性能の低下を検出したり，または予測したりできます。

JavaVMのCPU使用率は，監視テンプレートで提供している「JVM Use CPU」アラームを使用することで監視できます。

監視テンプレート「JVM Use CPU」アラームを次の表に示します。

表1-2　監視テンプレート「JVM Use CPU」アラーム

アラーム | 使用レコード | 使用フィールド | 異常条件 | 警告条件 | 値の見方
JVM Use CPU | PI_JVM | CPU Use % | CPU Use % >= 95 | CPU Use % >= 75 | JVMランタイムのCPU使用率（%）。

しきい値に対する考え方

Java VMのCPU使用率が高い場合，WebSphere Application Serverのパフォーマンスが低下していることが考えられます。この場合，リクエストの応答時間が長くなったり，リクエストを受け付けられなくなったりします。

対処方法

CPU使用率が高くなった要因を調査してください。主な要因としては，リクエスト数の増大や，メモリー不足によるガーベッジコレクションの頻発などが考えられます。これらの要因の根本的な原因を調査してください。

JVM Use CPUアラームの詳細については，「5.　監視テンプレート」の「JVM Use CPU」を参照してください。

1.3.4　JavaVMのメモリー使用率の監視

WebSphere Application Serverの動作基盤であるJavaVMのメモリー使用率を監視することで，WebSphere Application Server全体の処理性能の低下を検出したり，または予測したりできます。

JavaVMのメモリー使用率は，監視テンプレートで提供している「JVM Use Memory」アラームを使用することで監視できます。

監視テンプレート「JVM Use Memory」アラームを次の表に示します。

表1-3　監視テンプレート「JVM Use Memory」アラーム

アラーム | 使用レコード | 使用フィールド | 異常条件 | 警告条件 | 値の見方
JVM Use Memory | PI_JVM | Memory Use % | Memory Use % >= 95 | Memory Use % >= 75 | JVMランタイムのメモリー使用率（%）。

しきい値に対する考え方

Java VMのメモリー使用率が高い場合，十分な空きメモリー量を確保できずにガーベッジコレクションが頻発したり，メモリー不足によるアプリケーションエラーが発生してWebSphere Application Serverシステムダウンが発生したりするおそれがあります。

対処方法

メモリー使用率が高くなった要因を調査してください。主な要因としては，リクエスト数の増大や，アプリケーションのメモリーリークの発生が考えられます。リクエスト数の増大が要因の場合は，メモリー量を調整してください。

JVM Use Memoryアラームの詳細については，「5.　監視テンプレート」の「JVM Use Memory」を参照してください。

1.3.5　スレッドプール使用率の監視

スレッドプールの使用率を監視することで，ユーザーに対するサービス応答時間の低下を検出したり，または予測したりできます。

スレッドプールの使用率は，監視テンプレートで提供している「Thread Pool」アラームを使用することで監視できます。

監視テンプレート「Thread Pool」アラームを次の表に示します。

表1-4　監視テンプレート「Thread Pool」アラーム

アラーム | 使用レコード | 使用フィールド | 異常条件 | 警告条件 | 値の見方
Thread Pool | PI_THRP | Thread Pool Use % | Thread Pool Use % >= 90 | Thread Pool Use % >= 80 | スレッドプールの最大サイズに対する使用率（%）。

しきい値に対する考え方

スレッドプールの使用率が高い場合でも，スレッドプールに空きがあるときはパフォーマンスに大きな影響はありません。しかし，スレッドプールに空きがなくなった場合は，スレッド割り当て待ちが発生してリクエストへの応答時間が長くなってしまいます。

対処方法

スレッドプール使用率が高くなった要因を調査してください。主な要因としては，リクエスト数の増大が考えられます。この場合，十分な応答性能が維持できるようにスレッドプールサイズを調整してください。

Thread Poolアラームの詳細については，「5.　監視テンプレート」の「Thread Pool」を参照してください。

1.3.6　JDBC接続プールの使用率の監視

JDBC接続プールの使用率を監視することで，ユーザーに対するサービス応答時間の低下を検出したり，または予測したりできます。

JDBC接続プールの使用率は，監視テンプレートで提供している「JDBC Connection Pool」アラームを使用することで監視できます。

監視テンプレート「JDBC Connection Pool」アラームを次の表に示します。

表1-5　監視テンプレート「JDBC Connection Pool」アラーム

アラーム | 使用レコード | 使用フィールド | 異常条件 | 警告条件 | 値の見方
JDBC Connection Pool | PI_JDBC | Connection Pool Use % | Connection Pool Use % >= 90 | Connection Pool Use % >= 80 | 接続プールの使用率（%）。

しきい値に対する考え方

JDBC接続プールの使用率が高い場合でも，JDBC接続プールに空きがあるときはパフォーマンスに大きな影響はありません。しかし，JDBC接続プールに空きがなくなった場合は，JDBC接続割り当て待ちが発生してリクエストへの応答時間が長くなってしまいます。

対処方法

JDBC接続プールの使用率が高くなった要因を調査してください。主な要因としては，リクエスト数の増大が考えられます。この場合，十分な応答性能が維持できるようにJDBC接続プールサイズを調整してください。

JDBC Connection Poolアラームの詳細については，「5.　監視テンプレート」の「JDBC Connection Pool」を参照してください。

2.　インストールとセットアップ（Windowsの場合）

この章では，PFM - Agent for WebSphere Application Serverのインストールおよびセットアップ方法について説明します。Performance Managementシステム全体のインストールおよびセットアップ方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

＜この章の構成＞

2.1　インストールとセットアップ

2.2　アンインストールとアンセットアップ

2.3　PFM - Agent for WebSphere Application Serverのシステム構成の変更

2.4　PFM - Agent for WebSphere Application Serverの運用方式の変更

2.5　コマンドプロンプトの起動方法

2.6　バックアップとリストア

2.7　Webブラウザでマニュアルを参照するための設定

2.1　インストールとセットアップ

ここでは，PFM - Agent for WebSphere Application Serverをインストールおよびセットアップする手順について説明します。

＜この節の構成＞

2.1.1　インストールとセットアップの流れ

2.1.2　インストールとセットアップの前に

2.1.3　インストール手順

2.1.4　PFM - Agent for WebSphere Application Serverのセットアップ手順

2.1.1　インストールとセットアップの流れ

PFM - Agent for WebSphere Application Serverをインストールおよびセットアップする流れを次の図に示します。

図2-1　インストールとセットアップの流れ

PFM - ManagerおよびPFM - Web Consoleのインストールおよびセットアップの手順は，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

なお，ユーザー入力を必要とするセットアップコマンドは，対話形式で実行するか非対話形式で実行するかを選択できます。

対話形式で実行する場合は，コマンドの指示に従ってユーザーが値を入力する必要があります。

非対話形式で実行する場合は，コマンド実行中に必要となる入力作業をオプション指定や定義ファイルで代替するため，ユーザー入力が不要になります。また，バッチ処理やリモート実行によってセットアップ作業を自動化できるため，管理者の負担や運用コストを低減できます。

コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

2.1.2　インストールとセットアップの前に

PFM - Agent for WebSphere Application Serverをインストールおよびセットアップする前に確認しておく項目について説明します。

＜この項の構成＞

(1)　前提OS

(2)　ネットワークの環境設定

(3)　インストールに必要なOSユーザー権限について

(4)　前提プログラム

(5)　クラスタシステムでのインストールとセットアップについて

(6)　注意事項

(1)　前提OS

PFM - Agent for WebSphere Application Serverが動作するOSを次に示します。

Windows Server 2003

Windows Server 2008

(2)　ネットワークの環境設定

Performance Managementが動作するためのネットワーク環境について説明します。

(a)　IPアドレスの設定

PFM - Agentのホストは，ホスト名でIPアドレスを解決できる環境を設定してください。IPアドレスを解決できない環境では，PFM - Agentは起動できません。

監視ホスト名（Performance Managementシステムのホスト名として使用する名前）には，実ホスト名またはエイリアス名を使用できます。

監視ホスト名に実ホスト名を使用している場合
Windowsシステムではhostnameコマンド，UNIXシステムではuname -nコマンドを実行して確認したホスト名で，IPアドレスを解決できるように環境を設定してください。なお，UNIXシステムでは，hostnameコマンドで取得するホスト名を使用することもできます。

監視ホスト名にエイリアス名を使用している場合
設定しているエイリアス名でIPアドレスを解決できるように環境を設定してください。

監視ホスト名の設定については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

ホスト名とIPアドレスは，次のどれかの方法で設定してください。

Performance Managementのホスト情報設定ファイル（jpchostsファイル）

hostsファイル

DNS（Domain Name System）

注意

Performance Managementは，DNS環境でも運用できますが，FQDN形式のホスト名には対応していません。このため，監視ホスト名は，ドメイン名を除いて指定してください。

複数のLAN環境で使用する場合は，jpchostsファイルでIPアドレスを設定してください。詳細は，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

Performance Managementは，DHCPによる動的なIPアドレスが割り振られているホスト上では運用できません。Performance Managementを導入するすべてのホストに，固定のIPアドレスを設定してください。

PFM - ManagerとPFM - Agent for WebSphere Application ServerをIPv6で通信する場合，PFM - ManagerホストとPFM - AgentホストのそれぞれでIPv6の利用設定を有効にする必要があります。この設定はjpcconf ipv6 enableコマンドで実行しますが，コマンドの実行有無は次のとおりです。

jpcconf ipv6 enableコマンドの実行が必要なケース

それぞれのホストで，IPv4環境からIPv6環境に変更する場合

IPv4環境とIPv6環境が共存していて，PFM - ManagerをIPv4環境からIPv6環境に変更する場合

jpcconf ipv6 enableコマンドの実行が不要なケース

それぞれのホストが，すでにIPv6環境である場合

IPv4環境とIPv6環境が共存していて，PFM - ManagerがIPv6環境である場合

jpcconf ipv6 enableコマンドの実行例を次に示します。

インストール先フォルダ¥tools¥jpcconf ipv6 enable

jpcconf ipv6 enableコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。また，jpcconf ipv6 enableコマンドを実行する条件やタイミングについては，マニュアル「JP1/Performance Management 設計・構築ガイド」のIPv6環境が含まれる場合のネットワーク構成例について説明している章を参照してください。

(b)　ポート番号の設定

Performance Managementプログラムのサービスは，デフォルトで次の表に示すポート番号が割り当てられています。これ以外のサービスまたはプログラムに対しては，サービスを起動するたびに，そのときシステムで使用されていないポート番号が自動的に割り当てられます。また，ファイアウォール環境で，Performance Managementを使用するときは，ポート番号を固定してください。ポート番号の固定の手順は，マニュアル「JP1/Performance Management 設計・構築ガイド」のインストールとセットアップについて説明している章を参照してください。

表2-1　デフォルトのポート番号とPerformance Managementプログラムのサービス（Windowsの場合）

サービス説明
サービス名
パラメーター
ポート番号
備考

サービス構成情報管理機能
Name Server
jp1pcnsvr
22285
PFM - ManagerのName Serverサービスで使用されるポート番号。
Performance Managementのすべてのホストで設定される。

NNM連携機能
NNM Object Manager
jp1pcovsvr
22292
PFM - ManagerおよびPFM - BaseのNNM連携機能で，マップマネージャーとオブジェクトマネージャの間の通信で使用されるポート番号。
PFM - ManagerおよびPFM - Baseがインストールされているホストで設定される。

サービス状態管理機能
Status Server
jp1pcstatsvr
22350
PFM - ManagerおよびPFM - BaseのStatus Serverサービスで使用されるポート番号。
PFM - ManagerおよびPFM - Baseがインストールされているホストで設定される。

JP1/ITSLM連携機能
JP1/ITSLM
－
20905
JP1/ITSLMで設定されるポート番号です。

これらのPFM - Agentが使用するポート番号で通信できるように，ネットワークを設定してください。

(3)　インストールに必要なOSユーザー権限について

PFM - Agent for WebSphere Application Serverをインストールするときは，必ず，Administrators権限を持つアカウントで実行してください。

(4)　前提プログラム

ここでは，PFM - Agent for WebSphere Application Serverをインストールする場合に必要な前提プログラムについて説明します。プログラムの構成図を次に示します。

図2-2　プログラムの構成図

(a)　監視対象プログラム

PFM - Agent for WebSphere Application Serverの監視対象プログラムを次に示します。

IBM WebSphere Application Server V6.0

IBM WebSphere Application Server V6.1

IBM WebSphere Application Server V7.0

IBM WebSphere Application Server Network Deployment V6.0

IBM WebSphere Application Server Network Deployment V6.1

IBM WebSphere Application Server Network Deployment V7.0

これらの監視対象プログラムは，PFM - Agent for WebSphere Application Serverと同一ホストにインストールする必要があります。

(b)　Performance Managementプログラム

監視エージェントには，PFM - AgentとPFM - Baseをインストールします。PFM - BaseはPFM - Agentの前提プログラムです。同一ホストに複数のPFM - Agentをインストールする場合でも，PFM - Baseは1つだけでかまいません。

ただし，PFM - ManagerとPFM - Agentを同一ホストにインストールする場合，PFM - Baseは不要です。

また，PFM - Agent for WebSphere Application Serverを使ってWebSphere Application Serverの稼働監視をするためには，PFM - ManagerおよびPFM - Web Consoleが必要です。

(5)　クラスタシステムでのインストールとセットアップについて

クラスタシステムでのインストールとセットアップは，前提となるネットワーク環境やプログラム構成が，通常の構成のセットアップとは異なります。また，実行系ノードと待機系ノードでの作業が必要になります。詳細については，「4. クラスタシステムでの運用」を参照してください。

(6)　注意事項

ここでは，Performance Managementをインストールおよびセットアップするときの注意事項について説明します。

(a)　環境変数に関する注意事項

Performance ManagementではJPC_HOSTNAMEを環境変数として使用しているため，ユーザー独自に環境変数として設定しないでください。設定した場合は，Performance Managementが正しく動作しません。

(b)　同一ホストにPerformance Managementプログラムを複数インストール，セットアップするときの注意事項

Performance Managementは，同一ホストにPFM - Manager，PFM - Web Console，およびPFM - Agentをインストールすることもできます。その場合の注意事項を次に示します。

PFM - ManagerとPFM - Agentを同一ホストにインストールする場合，PFM - Baseは不要です。この場合，PFM - Agentの前提プログラムはPFM - Managerになるため，PFM - Managerをインストールしてから PFM - Agentをインストールしてください。

PFM - BaseとPFM - Managerは同一ホストにインストールできません。PFM - BaseとPFM - AgentがインストールされているホストにPFM - Managerをインストールする場合は，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Manager，PFM - Agentの順でインストールしてください。また，PFM - Manager とPFM - AgentがインストールされているホストにPFM - Baseをインストールする場合も同様に，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Base，PFM - Agentの順でインストールしてください。

PFM - ManagerがインストールされているホストにPFM - Agentをインストールすると，接続先PFM - ManagerはローカルホストのPFM - Managerになります。この場合，接続先PFM - ManagerをリモートホストのPFM - Managerに変更できません。リモートホストのPFM - Managerに接続したい場合は，インストールするホストにPFM - Managerがインストールされていないことを確認してください。

PFM - AgentがインストールされているホストにPFM - Managerをインストールすると，PFM - Agentの接続先PFM - Managerは自ホスト名に設定し直されます。共通メッセージログに設定結果が出力されています。結果を確認してください。

PFM - Web Consoleがインストールされているホストに，PFM - Agentをインストールする場合は，Webブラウザの画面をすべて閉じてからインストールを実施してください。

Performance Managementプログラムを新規にインストールした場合は，ステータス管理機能がデフォルトで有効になります。ただし，07-50から08-00以降にバージョンアップインストールした場合は，ステータス管理機能の設定状態はバージョンアップ前のままとなります。ステータス管理機能の設定を変更する場合は，マニュアル「JP1/Performance Management 運用ガイド」のPerformance Managementの障害検知について説明している章を参照してください。

ポイント

システムの性能や信頼性を向上させるため，PFM - Manager，PFM - Web Console，およびPFM - Agentはそれぞれ別のホストで運用することをお勧めします。

(c)　バージョンアップの注意事項

古いバージョンのPFM - Agentからバージョンアップする場合の注意事項を次に示します。

なお，バージョンアップの詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録を参照してください。

Performance Managementのプログラムをインストールするときは，ローカルホストのPerformance Managementのプログラムおよびサービスをすべて停止しておいてください。サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

PFM - BaseとPFM - Managerは同一ホストにインストールできません。PFM - BaseとPFM - AgentがインストールされているホストにPFM - Managerをインストールする場合は，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Manager，PFM - Agentの順でインストールしてください。また，PFM - ManagerとPFM - AgentがインストールされているホストにPFM - Baseをインストールする場合も同様に，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Base，PFM - Agentの順でインストールしてください。

バージョン08-00以降のPerformance Managementプログラムでは，Store実行プログラム（jpcsto.exeおよびstpqlpr.exe）の配置先が変更されています。PFM - Agentを08-00以降にバージョンアップする際に，旧配置先のStore実行モジュールは削除されます。

バージョンアップでStoreデータベースのデータモデルバージョンが変更される場合，既存のStoreデータベースが自動的にバージョンアップされるため，一時的にStoreデータベースのディスク占有量が2倍になります。バージョンアップインストールする前に，Storeデータベースの格納先のディスクに十分な空き容量があるかどうか確認してください。必要な空き容量は，現在のStoreデータベースの合計サイズを基準に考慮してください。例えば，現在のStoreデータベースの合計サイズが100ギガバイトの場合，バージョンアップインストールに必要なディスクの空き容量は200ギガバイト以上です。Storeデータベースの格納先ディスクを変更している場合は，変更後のディスク容量に対して考慮してください。

(d)　その他の注意事項

Performance Managementのプログラムが1つもインストールされていない環境に新規インストールする場合は，インストール先フォルダにファイルやフォルダがないことを確認してください。

Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラム（例えばWindowsのイベントビューアなど）を起動したままインストールした場合，システムの再起動を促すメッセージが表示されることがあります。この場合は，メッセージに従ってシステムを再起動し，インストールを完了させてください。

Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラム（例えばWindowsのイベントビューアなど）を起動したままの状態，ディスク容量が不足している状態，またはフォルダ権限がない状態でインストールした場合，ファイルの展開に失敗することがあります。Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラムが起動している場合はすべて停止してからインストールし直してください。ディスク容量不足やフォルダ権限不足が問題である場合は，問題を解決したあとでインストールし直してください。

Performance Managementのプログラムをインストールする場合，次に示すセキュリティ関連プログラムがインストールされていないかどうか確認してください。インストールされている場合，次の説明に従って対処してください。

セキュリティ監視プログラム
セキュリティ監視プログラムを停止するかまたは設定を変更して，Performance Managementのプログラムのインストールを妨げないようにしてください。

ウィルス検出プログラム
ウィルス検出プログラムを停止してからPerformance Managementのプログラムをインストールしてください。
Performance Managementのプログラムのインストール中にウィルス検出プログラムが稼働している場合，インストールの速度が低下したり，インストールが実行できなかったり，または正しくインストールできなかったりすることがあります。

プロセス監視プログラム
プロセス監視プログラムを停止するかまたは設定を変更して，Performance Managementのサービスまたはプロセス，および共通コンポーネントのサービスまたはプロセスを監視しないようにしてください。
Performance Managementのプログラムのインストール中に，プロセス監視プログラムによって，これらのサービスまたはプロセスが起動されたり停止されたりすると，インストールに失敗することがあります。

2.1.3　インストール手順

ここでは，PFM - Agentのプログラムをインストールする順序とCD-ROMの提供媒体からプログラムをインストールする手順について説明します。

＜この項の構成＞

(1)　プログラムのインストール順序

(2)　プログラムのインストール方法

(1)　プログラムのインストール順序

まず，PFM - Baseをインストールし，次にPFM - Agentをインストールします。PFM - BaseがインストールされていないホストにPFM - Agentをインストールすることはできません。

なお，PFM - Managerと同一ホストにPFM - Agentをインストールする場合は，PFM - Manager，PFM - Agentの順でインストールしてください。また，Storeデータベースのバージョン1.0からバージョン2.0にバージョンアップする場合，PFM - AgentとPFM - ManagerまたはPFM - Baseのインストール順序によって，セットアップ方法が異なります。Storeバージョン2.0のセットアップ方法については，「2.4.3　Storeバージョン2.0への移行」を参照してください。

同一ホストに複数のPFM - Agentをインストールする場合，PFM - Agent相互のインストール順序は問いません。

図2-3　プログラムのインストール順序

(2)　プログラムのインストール方法

WindowsホストにPerformance Managementプログラムをインストールするには，CD-ROMの提供媒体を使用する方法と，JP1/NETM/DMを使用してリモートインストールする方法があります。JP1/NETM/DMを使用する方法については，マニュアル「JP1/NETM/DM 運用ガイド1（Windows(R)用）」を参照してください。

OS共通の注意事項

インストールするホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。なお，停止するサービスは，物理ホスト上および論理ホスト上のすべてのサービスです。サービスの停止方法は，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

Windows Server 2008の環境でインストールする場合の注意事項

OSのユーザーアカウント制御機能（UAC）を有効にしている場合は，インストール中にユーザーアカウント制御のダイアログボックスが表示されることがあります。ダイアログボックスが表示された場合は，［続行］ボタンをクリックしてインストールを続行してください。［キャンセル］ボタンをクリックした場合は，インストールが中止されます。

CD-ROMの提供媒体を使用する場合のインストール手順を次に示します。

Performance Managementプログラムをインストールするホストに，Administrators権限でログオンする。

Performance Managementのプログラムおよびサービスを停止する。
Performance Managementのプログラムおよびサービスが起動している場合は，すべて停止してください。

提供媒体をCD-ROMドライブに入れる。
起動したインストーラーの指示に従ってインストールを進めます。
インストール時に定義する情報を次に示します。

ユーザー情報
ユーザー名などを入力します。

インストール先フォルダ
Performance Managementプログラムをインストールするフォルダを指定します。
インストール先フォルダは，［ディレクトリの選択］ダイアログボックスで設定して［OK］ボタンをクリックした時点で作成されます。誤ったフォルダを作成した場合はインストール後にフォルダを削除してください。

プログラムフォルダ
Windowsの［スタート］－［すべてのプログラム］メニューに登録されるプログラムメニュー名を指定します。
デフォルトでは，［Performance Management］が登録されます。

参考

PFM - Web Consoleを除くPerformance Managementインストール先フォルダおよびプログラムフォルダは，そのホストに初めてPerformance Managementプログラムがインストールされるときだけ指定できます。2回目以降のインストールでは，初回のインストール時に指定したフォルダにインストールまたは登録されます。

2.1.4　PFM - Agent for WebSphere Application Serverのセットアップ手順

ここでは，PFM - Agent for WebSphere Application Serverを運用するための，セットアップについて説明します。

[図データ]は使用する環境によって必要になるセットアップ項目，またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。

＜この項の構成＞

(1)　PFM - Agent for WebSphere Application Serverの登録

(2)　インスタンス環境の設定

(3)　ネットワークの設定

(4)　ログのファイルサイズ変更

(5)　パフォーマンスデータの格納先の変更

(6)　PFM - Agent for WebSphere Application Serverの接続先PFM - Managerの設定

(7)　動作ログ出力の設定

(1)　PFM - Agent for WebSphere Application Serverの登録

PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために，PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for WebSphere Application Serverを登録する必要があります。

PFM - Managerのバージョンが08-50以降の場合，PFM - Agentの登録は自動で行われるため，ここで説明する手順は不要です。ただし，PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは手動で登録する必要があります。なお，PFM - Agent for WebSphere Application Serverのデータモデルのバージョンについては，「付録H　バージョン互換」を参照してください。

PFM - Agentの登録の流れを次の図に示します。

図2-4　PFM - Agentの登録の流れ

注意

PFM - Agent の登録は，インスタンス環境を設定する前に実施してください。

すでにPFM - Agent for WebSphere Application Serverの情報が登録されているPerformance Managementシステムに，新たに同じバージョンのPFM - Agent for WebSphere Application Serverを追加した場合，PFM - Agentの登録は必要ありません。

PFM - Managerと同じホストにPFM - Agentをインストールした場合，jpcconf agent setup (jpcagtsetup)コマンドが自動的に実行されます。共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されるので，結果を確認してください。コマンドが正しく実行されていない場合は，コマンドを実行し直してください。コマンドの実行方法については，マニュアル「JP1/Performance Management リファレンス」のコマンドの章を参照してください。

PFM - Agent for WebSphere Application Serverの情報を登録する作業では，PFM - Web Consoleの［レポート階層］画面および［アラーム階層］画面に「WebSphere Application Server」という名前のフォルダが作成されます。［レポート階層］画面で，すでに独自に「WebSphere Application Server」という名前のフォルダまたはファイルを作成していた場合には，名前を変更してから作業を始めてください。

(a)　PFM - Agent for WebSphere Application Serverのセットアップファイルをコピーする

PFM - Agent for WebSphere Application Serverをインストールしたホストにあるセットアップファイルを，PFM - ManagerおよびPFM - Web Consoleをインストールしたホストにコピーします。手順を次に示します。

PFM - Web Consoleが起動されている場合は，停止する。

PFM - Agentのセットアップファイルをバイナリーモードでコピーする。
ファイルが格納されている場所およびファイルをコピーする場所を次の表に示します。

表2-2　コピーするセットアップファイル

コピー先
PFM - Agent の
セットアップファイル

PFMプログラム名
OS
コピー先フォルダ

PFM - Manager
Windows
PFM - Managerのインストール先フォルダ¥setup¥
インストール先フォルダ¥setup¥jpcagt2w.EXE

UNIX
/opt/jp1pc/setup/
インストール先フォルダ¥setup¥jpcagt2u.Z

PFM - Web Console
Windows
PFM - Web Consoleのインストール先フォルダ¥setup¥
インストール先フォルダ¥setup¥jpcagt2w.EXE

UNIX
/opt/jp1pcwebcon/setup/
インストール先フォルダ¥setup¥jpcagt2u.Z

(b)　PFM - Managerホストでセットアップコマンドを実行する

PFM - ManagerでPFM - Agent for WebSphere Application Serverをセットアップするために，次のコマンドを実行します。

PFM - Managerのインストール先フォルダ¥tools¥jpcconf agent setup -key WAS (PFM - Managerのインストール先フォルダ¥tools¥jpcagtsetup agt2)

ここでは，対話形式の実行例を示していますが，jpcconf agent setupコマンドは非対話形式でも実行できます。jpcconf agent setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

注意

コマンドを実行するローカルホストのPerformance Managementのプログラムおよびサービスが完全に停止していない状態でjpcconf agent setup (jpcagtsetup)コマンドを実行した場合，エラーが発生することがあります。その場合は，Performance Managementのプログラムおよびサービスが完全に停止したことを確認したあと，再度jpcconf agent setup (jpcagtsetup)コマンドを実行してください。

PFM - ManagerホストにあるPFM - Agentのセットアップファイルは，この作業が終了したあと，削除してもかまいません。

(c)　PFM - Web Consoleホストでセットアップコマンドを実行する

PFM - Web ConsoleでPFM - Agent for WebSphere Application Serverをセットアップするための次のコマンドを実行します。

PFM - Web Consoleのインストール先フォルダ¥tools¥jpcwagtsetup (PFM - Web Consoleのインストール先フォルダ¥tools¥jpcwagtsetup)

PFM - Web ConsoleホストにあるPFM - Agentのセットアップファイルは，この作業が終了したあと削除してもかまいません。

(2)　インスタンス環境の設定

インスタンス環境の設定では，インスタンス情報の設定を実施します。複数のインスタンス環境を設定する場合は，繰り返し実施します。

(a)　インスタンス情報を設定する

PFM - Agent for WebSphere Application Serverで監視するWebSphere Application Serverのインスタンス情報を設定します。インスタンス情報の設定は，PFM - Agentホストで実施します。

設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に，次の表の情報をあらかじめ確認してください。WebSphere Application Serverのインスタンス情報の詳細については，WebSphere Application Serverのドキュメントを参照してください。

注意

インスタンス環境を設定していない場合，PFM - Agent for WebSphere Application Serverのサービスを起動できません。

表2-3　PFM - Agent for WebSphere Application Serverのインスタンス情報

項目
説明
設定できる値
デフォルト値

WebSphere Application Server Installation Directory
WebSphere Application Serverのインストール先フォルダ。
1～512バイトの半角文字列。
ただし，次の文字は使用できない。
「/」，「*」，「?」，「"」，「<」，「>」，「|」
なし

WebSphere Application Server Version
WebSphere Application Serverのバージョン。
6：V6.0，V6.1
7：V7.0
「6」または「7」。
6

SOAP Connector Port Number
WebSphere Application ServerのSOAPコネクターポート番号。
1024～65535の数値。
8880

User Name※1，※2
WebSphere Application Serverに接続するためのHTTP基本認証のユーザーID。
1～512バイトの半角文字列。
なし

Password※2
WebSphere Application Serverに接続するためのHTTP基本認証のパスワード。
1～256バイトの半角文字列。
なし

TrustStore File Path※3
WebSphere Application ServerのSOAPコネクターポートでSSLを使用している場合※4に，サーバ（WebSphere Application Server）を認証するための，JKS（Java keystore）形式のトラストストアファイル（絶対パス）。※5
1～512バイトの半角文字列。
ただし，次の文字は使用できない。
「/」，「*」，「?」，「"」，「<」，「>」，「|」
なし

TrustStore Password※3
WebSphere Application ServerのSOAPコネクターポートでSSLを使用している場合に，WebSphere Application Serverに接続するためのトラストストアファイルのパスワード。
1～256バイトの半角文字列。
なし

Store Version※6
使用するStoreバージョン。※7
「1.0」または「2.0」。
2.0

注※1

このユーザーには，Monitorセキュリティロールが与えられている必要があります。

注※2

HTTP基本認証を使用していない場合は空白（スペース）にしてください。

注※3

SSLを使用していない場合は空白（スペース）にしてください。

注※4

IBM WebSphere Application Server V6.0またはIBM WebSphere Application Server Network Deployment V6.0において，「グローバル・セキュリティーの使用可能化」オプションを設定している場合。IBM WebSphere Application Server V6.1/V7.0またはIBM WebSphere Application Server Network Deployment V6.1/V7.0において，「管理セキュリティーを使用可能にする」に設定している場合。

注※5

JKS形式のトラストストアファイルは，WebSphere Application Serverに付属の鍵管理ユーティリティ（iKeyman）などで作成できます。

例えば，WebSphere Application Server V6.1の場合，デフォルトではSOAP_CONNECTOR_ADDRESSのSSL構成にNodeDefaultSSLSettingsが設定されていて，default証明書が利用されます。このdefault証明書に対応するサーバ認証用のトラストストアファイルは次の場所にあります。

WebSphere Application Serverのプロファイル・フォルダ¥etc¥DummyClientTrustFile.jks

WebSphere Application Server V6.1がデフォルトのSSL構成の場合は，上記のトラストストアファイルを設定できますが，有効期限があるため注意が必要です。

また，WebSphere Application ServerのSSL構成を変更した場合や任意のサーバ証明書を適用した場合は，その証明書に対応したトラストストアファイルを作成して設定する必要があります。SSL構成の詳細については，WebSphere Application Serverのマニュアルを参照してください。

注※6

JP1/PFM - Agent for WebSphere Application Serverと同一ホスト上のJP1/PFM - ManagerまたはJP1/PFM - Baseが08-10以降で，インスタンス環境を新規に設定する場合に必要です。インスタンス環境を更新するときは指定できません。

注※7

Storeバージョンについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

インスタンス環境を構築するには，jpcconf inst setup (jpcinssetup)コマンドを使用します。

インスタンス環境の構築手順を次に示します。複数のインスタンス環境を設定する場合は，この手順を繰り返し実施します。

サービスキーおよびインスタンス名を指定して，jpcconf inst setup (jpcinssetup)コマンドを実行する。
例えば，PFM - Agent for WebSphere Application Serverのインスタンス名APSVのインスタンス環境を構築する場合，次のように指定してコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf inst setup -key WAS -inst APSV (インストール先フォルダ¥tools¥jpcinssetup agt2 -inst APSV)

インスタンス名には，WebSphere Application Serverのサーバ名など，監視対象のWebSphere Application Serverのインスタンスを一意に識別できる任意の名称を指定してください。
jpcconf inst setup (jpcinssetup)コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

WebSphere Application Serverのインスタンス情報を設定する。
表2-3に示した項目を，コマンドの指示に従って入力してください。省略はできません。デフォルトで表示されている値を入力する場合は，リターンキーだけを押してください。

すべての入力が終了すると，インスタンス環境が構築されます。構築時に入力した内容を変更したい場合は，再度jpcconf inst setup (jpcinssetup)コマンドを実行し，インスタンス環境を更新してください。インスタンス環境の更新については，「2.4.2　インスタンス環境の更新の設定」を参照してください。

構築されるインスタンス環境を次に示します。

インスタンス環境のフォルダ構成
次のフォルダ下にインスタンス環境が構築されます。
物理ホストの場合：インストール先フォルダ¥agt2
論理ホストの場合：環境フォルダ※¥jp1pc¥agt2

注※

環境フォルダとは，論理ホスト作成時に指定した共有ディスク上のフォルダです。

構築されるインスタンス環境のフォルダ構成を次に示します。

表2-4　インスタンス環境のフォルダ構成

フォルダ名・ファイル名 | 説明
agent | インスタンス名 | jpcagt.ini | Agent Collectorサービス起動情報ファイル
jpcagt.ini.model※ | Agent Collectorサービス起動情報ファイルのモデルファイル
log | ログファイル格納フォルダ
store | インスタンス名 | *.DAT | データモデル定義ファイル
backup | バックアップ先フォルダ
dump | エクスポート先フォルダ
import | 標準のデータベースインポート先フォルダ（Storeバージョン2.0の場合）
jpcsto.ini | Agent Storeサービス起動情報ファイル
jpcsto.ini.model※ | Agent Storeサービス起動情報ファイルのモデルファイル
log | ログファイル格納フォルダ
partial | 標準のデータベース部分バックアップ先フォルダ（Storeバージョン2.0の場合）
STPD | PDレコードタイプのパフォーマンスデータ格納先フォルダ（Storeバージョン2.0の場合）
STPI | PIレコードタイプのパフォーマンスデータ格納先フォルダ（Storeバージョン2.0の場合）

注※

インスタンス環境を構築した時点の設定値に戻したいときに使用します。

インスタンス環境のサービスID
インスタンス環境のサービスIDは次のようになります。

プロダクトID 機能ID インスタンス番号 インスタンス名 [ホスト名]

PFM - Agent for WebSphere Application Serverの場合，インスタンス名にはjpcconf inst setup (jpcinssetup)コマンドで指定したインスタンス名が表示されます。
サービスIDについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の，付録に記載されている命名規則を参照してください。

インスタンス環境のWindowsのサービス名
インスタンス環境のWindowsのサービス名は次のようになります。

Agent Collectorサービス：PFM - Agent for WAS インスタンス名 ［論理ホスト名］

Agent Storeサービス：PFM - Agent Store for WAS インスタンス名 ［論理ホスト名］

Windowsのサービス名については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，付録に記載されている命名規則を参照してください。また，論理ホストで運用する場合のWindowsのサービス名については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

(3)　ネットワークの設定[図データ]

Performance Managementを使用するネットワーク構成に応じて，変更する場合に必要な設定です。

ネットワークの設定には次の2つの項目があります。

IPアドレスを設定する
Performance Managementを複数のLANに接続されたネットワークで使用するときに設定します。複数のIPアドレスを設定するには，jpchostsファイルにホスト名とIPアドレスを定義します。設定したjpchostsファイルはPerformance Managementシステム全体で統一させてください。
詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

ポート番号を設定する
Performance Managementが使用するポート番号を設定できます。運用での混乱を避けるため，ポート番号とサービス名は，Performance Managementシステム全体で統一させてください。
ポート番号の設定の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

(4)　ログのファイルサイズ変更[図データ]

Performance Managementの稼働状況を，Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは，デフォルトで2,048キロバイトのファイルが2ファイル使用されます。このファイルサイズを変更したい場合に，必要な設定です。

詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

(5)　パフォーマンスデータの格納先の変更[図データ]

PFM - Agent for WebSphere Application Serverで管理されるパフォーマンスデータを格納するデータベースの保存先，バックアップ先，エクスポート先，またはインポート先のフォルダを変更したい場合に，必要な設定です。

パフォーマンスデータは，デフォルトで，次の場所に保存されます。

保存先：インストール先フォルダ¥agt2¥store¥インスタンス名¥

バックアップ先：インストール先フォルダ¥agt2¥store¥インスタンス名¥backup¥

部分バックアップ先※：インストール先フォルダ¥agt2¥store¥インスタンス名¥partial¥

エクスポート先：インストール先フォルダ¥agt2¥store¥インスタンス名¥dump¥

インポート先※：インストール先フォルダ¥agt2¥store¥インスタンス名¥import¥

注

論理ホストで運用する場合のデフォルトの保存先については，「インストール先フォルダ」を「環境フォルダ¥jp1pc」に読み替えてください。

注※

Storeバージョン2.0使用時だけ設定できます。

詳細については，「2.4.1 パフォーマンスデータの格納先の変更」を参照してください。

(6)　PFM - Agent for WebSphere Application Serverの接続先PFM - Managerの設定

PFM - Agentがインストールされているホストで，そのPFM - Agentを管理するPFM - Managerを設定します。接続先のPFM - Managerを設定するには，jpcconf mgrhost define (jpcnshostname)コマンドを使用します。

注意

同一ホスト上に，複数のPFM - Agentがインストールされている場合でも，接続先に指定できるPFM - Managerは，1つだけです。PFM - Agentごとに異なるPFM - Managerを接続先に設定することはできません。

PFM - AgentとPFM - Managerが同じホストにインストールされている場合，接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合，接続先のPFM - ManagerをほかのPFM - Managerに変更できません。

手順を次に示します。

Performance Managementのプログラムおよびサービスを停止する。
セットアップを実施する前に，ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。
jpcconf mgrhost define (jpcnshostname)コマンド実行時に，Performance Managementのプログラムおよびサービスが起動されている場合は，停止を問い合わせるメッセージが表示されます。

接続先のPFM - Managerホストのホスト名を指定して，jpcconf mgrhost define (jpcnshostname)コマンドを実行する。
例えば，接続先のPFM - Managerがホストhost01上にある場合，次のように指定します。

インストール先フォルダ¥tools¥jpcconf mgrhost define -host host01 (インストール先フォルダ¥tools¥jpcnshostname -s host01)

ここでは，対話形式の実行例を示していますが，jpcconf mgrhost defineコマンドは非対話形式でも実行できます。jpcconf mgrhost defineコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

(7)　動作ログ出力の設定[図データ]

アラーム発生時に動作ログを出力したい場合に必要な設定です。動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。

設定方法については，「付録I 動作ログの出力」を参照してください。

2.2　アンインストールとアンセットアップ

ここでは，PFM - Agent for WebSphere Application Serverをアンインストールおよびアンセットアップする手順について説明します。

＜この節の構成＞

2.2.1　アンインストールとアンセットアップの前に

2.2.2　アンセットアップ手順

2.2.3　アンインストール手順

2.2.1　アンインストールとアンセットアップの前に

PFM - Agent for WebSphere Application Serverをアンインストールおよびアンセットアップするときの注意事項を次に示します。

＜この項の構成＞

(1)　アンインストールに必要なOSユーザー権限に関する注意事項

(2)　ネットワークに関する注意事項

(3)　プログラムに関する注意事項

(4)　サービスに関する注意事項

(5)　その他の注意事項

(1)　アンインストールに必要なOSユーザー権限に関する注意事項

PFM - Agentをアンインストールするときは，必ず，Administrators権限を持つアカウントで実行してください。

(2)　ネットワークに関する注意事項

Performance Managementプログラムをアンインストールしても，servicesファイルに定義されたポート番号は削除されません。

(3)　プログラムに関する注意事項

Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラム（例えばWindowsのイベントビューアなど）を起動したままアンインストールした場合，ファイルやフォルダが残ることがあります。この場合は，手動でインストール先フォルダ以下をすべて削除してください。

Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラム（例えばWindowsのイベントビューアなど）を起動したままアンインストールした場合，システムの再起動を促すメッセージが出力されることがあります。この場合，システムを再起動して，アンインストールを完了させてください。

PFM - BaseとPFM - Agentがインストールされているホストの場合，PFM - BaseのアンインストールはPFM - Agentをアンインストールしないと実行できません。この場合，PFM - Agent，PFM - Baseの順にアンインストールしてください。また，PFM - ManagerとPFM - Agentがインストールされているホストの場合も同様に，PFM - ManagerのアンインストールはPFM - Agentをアンインストールしないと実行できません。この場合，PFM - Agent，PFM - Managerの順にアンインストールしてください。

(4)　サービスに関する注意事項

PFM - Agentをアンインストールしただけでは，jpctool service list (jpcctrl list)コマンドで表示できるサービスの情報は削除されません。この場合，PFM - Managerがインストールされているホストでjpctool service deleteコマンドを使用してサービスの情報を削除してください。PFM - Web Consoleホストにサービス情報の削除を反映するためには，jpctool service syncコマンドを実行して，PFM - Manager ホストとPFM - Web Consoleホストのエージェント情報を同期させる必要があります。

サービス情報の削除方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップの章のサービスの削除について説明している個所を参照してください。

(5)　その他の注意事項

PFM - Web Consoleがインストールされているホストから，Performance Managementプログラムをアンインストールする場合は，Webブラウザの画面をすべて閉じてからアンインストールを実施してください。

2.2.2　アンセットアップ手順

ここでは，PFM - Agent for WebSphere Application Serverをアンセットアップする手順について説明します。

＜この項の構成＞

(1)　インスタンス環境のアンセットアップ

(1)　インスタンス環境のアンセットアップ

PFM - Agent for WebSphere Application Serverのアンセットアップでは，インスタンス環境の削除を実施します。複数のインスタンス環境をアンセットアップする場合は，繰り返し実施します。

(a)　インスタンス環境を削除する

インスタンス名を確認し，インスタンス環境を削除します。インスタンス環境の削除は，PFM - Agentホストで実施します。

インスタンス名を確認するには，jpcconf inst list (jpcinslist)コマンドを使用します。また，構築したインスタンス環境を削除するには，jpcconf inst unsetup (jpcinsunsetup)コマンドを使用します。

インスタンス環境を削除する手順を次に示します。

インスタンス名を確認する。
PFM - Agent for WebSphere Application Serverを示すサービスキーを指定して，jpcconf inst list (jpcinslist)コマンドを実行します。

インストール先フォルダ¥tools¥jpcconf inst list -key WAS (インストール先フォルダ¥tools¥jpcinslist agt2)

設定されているインスタンス名がAPSVの場合，APSVと表示されます。

インスタンス環境のPFM - Agentのサービスが起動されている場合は，停止する。
サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

インスタンス環境を削除する。
PFM - Agent for WebSphere Application Serverを示すサービスキーおよびインスタンス名を指定して，jpcconf inst unsetup (jpcinsunsetup)コマンドを実行します。
設定されているインスタンス名がAPSVの場合，次のように指定します。

インストール先フォルダ¥tools¥jpcconf inst unsetup -key WAS  -inst APSV (インストール先フォルダ¥tools¥jpcinsunsetup agt2 -inst APSV)

jpcconf inst unsetup (jpcinsunsetup)コマンドが正常終了すると，インスタンス環境として構築されたフォルダ，サービスID，およびWindowsのサービスが削除されます。

注意

インスタンス環境をアンセットアップしても，jpctool service list (jpcctrl list)コマンドで表示できるサービスの情報は削除されません。この場合，jpctool service delete (jpcctrl delete)コマンド使用してサービスの情報を削除してください。

PFM - Web Consoleホストにインスタンス環境の削除を反映するためには，jpctool service syncコマンドを実行して，PFM - Manager ホストとPFM - Web Consoleホストのエージェント情報を同期する必要があります。

次に指定例を示します。

インスタンス名：APSV

ホスト名：host01

Agent CollectorサービスのサービスID：2A1APSV[host01]

Agent StoreサービスのサービスID：2S1APSV[host01]

インストール先フォルダ¥tools¥jpctool service delete -id 2?1APSV[host01] -host host01 (インストール先フォルダ¥tools¥jpcctrl delete 2?1APSV[host01] host=host01)

コマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

2.2.3　アンインストール手順

PFM - Agent for WebSphere Application Serverをアンインストールする手順を説明します。

PFM - Agent for WebSphere Application Serverをアンインストールするホストに，Administrators権限を持つアカウントでログオンする。

ローカルホストでPerformance Managementのプログラムおよびサービスを停止する。
サービス情報を表示して，サービスが起動されていないか確認してください。
ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。なお，停止するサービスは物理ホスト上および論理ホスト上のすべてのサービスです。サービス情報の表示方法およびサービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」のPerformance Managementの起動と停止について説明している章を参照してください。

「Performance Management - Agent Option for IBM WebSphere Application Server」を選択する。
Windowsの［コントロールパネル］で［プログラムの追加と削除］※を選択して，「Performance Management - Agent Option for IBM WebSphere Application Server」を選択します。
注※　Windowsのバージョンによって名称が異なる場合があります。

［削除］を選択し，［OK］ボタンをクリックする。
選択したプログラムがアンインストールされます。

Windows Server 2008の環境でアンインストールする場合の注意事項

OSのユーザーアカウント制御機能（UAC）を有効にしている場合は，アンインストール中にユーザーアカウント制御のダイアログボックスが表示されることがあります。ダイアログボックスが表示された場合は，［続行］ボタンをクリックしてアンインストールを続行してください。［キャンセル］ボタンをクリックした場合は，アンインストールが中止されます。

2.3　PFM - Agent for WebSphere Application Serverのシステム構成の変更

監視対象システムのネットワーク構成の変更や，ホスト名の変更などに応じて，PFM - Agent for WebSphere Application Serverのシステム構成を変更する場合があります。

PFM - Agent for WebSphere Application Serverのシステム構成を変更する場合，PFM - ManagerやPFM - Web Consoleの設定変更もあわせて行う必要があります。Performance Managementのシステム構成を変更する手順の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。なお，物理ホスト名またはエイリアス名を変更するときに，固有の追加作業が必要なPFM - Agentもありますが，PFM - Agent for WebSphere Application Serverの場合，固有の追加作業は必要ありません。

2.4　PFM - Agent for WebSphere Application Serverの運用方式の変更

収集した稼働監視データの運用手順の変更などで，パフォーマンスデータの格納先やインスタンス環境といった，PFM - Agent for WebSphere Application Serverの運用方式を変更する場合があります。

ここでは，PFM - Agent for WebSphere Application Serverの運用方式を変更する手順について説明します。Performance Management全体の運用方式を変更する手順の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

＜この節の構成＞

2.4.1　パフォーマンスデータの格納先の変更

2.4.2　インスタンス環境の更新の設定

2.4.3　Storeバージョン2.0への移行

2.4.1　パフォーマンスデータの格納先の変更

PFM - Agent for WebSphere Application Serverで収集したパフォーマンスデータは，PFM - Agent for WebSphere Application ServerのAgent StoreサービスのStoreデータベースで管理しています。

Storeデータベースで管理されるパフォーマンスデータの，次のデータ格納先フォルダを変更したい場合は，jpcconf db define (jpcdbctrl config)コマンドで設定します。Storeデータベースの格納先フォルダを変更する前に収集したパフォーマンスデータが必要な場合は，jpcconf db define (jpcdbctrl config)コマンドの-moveオプションを使用してください。jpcconf db define (jpcdbctrl config)コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

保存先フォルダ

バックアップ先フォルダ

部分バックアップ先フォルダ※

エクスポート先フォルダ

インポート先フォルダ※

注※

Storeバージョン2.0使用時だけ設定できます。

jpcconf db define (jpcdbctrl config)コマンドで設定するオプション名，設定できる値の範囲などを次の表に示します。

表2-5　パフォーマンスデータの格納先を変更するコマンドの設定項目

説明 | オプション名 | 設定できる値（Storeバージョン1.0）※1 | 設定できる値（Storeバージョン2.0）※1 | デフォルト値※2
パフォーマンスデータの保存先フォルダ | sd | 1～127バイトのフォルダ名 | 1～214バイトのフォルダ名 | インストール先フォルダ¥agt2¥store¥インスタンス名
パフォーマンスデータのバックアップ先フォルダ | bd | 1～127バイトのフォルダ名 | 1～211バイトのフォルダ名 | インストール先フォルダ¥agt2¥store¥インスタンス名¥backup
パフォーマンスデータの部分バックアップ先フォルダ | pbd | － | 1～214バイトのフォルダ名 | インストール先フォルダ¥agt2¥store¥インスタンス名¥partial
パフォーマンスデータをバックアップする場合の最大世代番号 | bs | 1～9 | 1～9 | 5
パフォーマンスデータのエクスポート先フォルダ | dd | 1～127バイトのフォルダ名 | 1～127バイトのフォルダ名 | インストール先フォルダ¥agt2¥store¥インスタンス名¥dump
パフォーマンスデータのインポート先フォルダ | id | － | 1～222バイトのフォルダ名 | インストール先フォルダ¥agt2¥store¥インスタンス名¥import

（凡例）

－：設定できません。

注※1

フォルダ名は，Storeデータベースのデフォルト格納先フォルダ（インストール先フォルダ¥agtc¥store¥インスタンス名）からの相対パスか，または絶対パスで指定してください。

注※2

論理ホストで運用する場合のデフォルト値については，「インストール先フォルダ」を「環境フォルダ¥jp1pc」に読み替えてください。

なお，Storeバージョン1.0使用時は，jpcsto.iniファイルを直接編集して変更できます。jpcsto.iniファイルを編集する方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

2.4.2　インスタンス環境の更新の設定

インスタンス環境を更新したい場合は，インスタンス名を確認し，インスタンス情報を更新します。インスタンス情報の更新は，PFM - Agentホストで実施します。

更新する情報は，表2-3であらかじめ確認してください。

インスタンス名を確認するには，jpcconf inst list (jpcinslist)コマンドを使用します。また，インスタンス環境を更新するには，jpcconf inst setup (jpcinssetup)コマンドを使用します。コマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

インスタンス環境を更新する手順を次に示します。複数のインスタンス環境を更新する場合は，この手順を繰り返し実施します。

インスタンス名を確認する。
PFM - Agent for WebSphere Application Serverを示すサービスキーを指定して，jpcconf inst list (jpcinslist)コマンドを実行します。

インストール先フォルダ¥tools¥jpcconf inst list -key WAS (インストール先フォルダ¥tools¥jpcinslist agt2)

設定されているインスタンス名がAPSVの場合，APSVと表示されます。

更新したいインスタンス環境のPFM - Agent for WebSphere Application Serverのサービスが起動されている場合は，停止する。
サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。
jpcconf inst setup (jpcinssetup)コマンド実行時に，更新したいインスタンス環境のサービスが起動されている場合は，確認メッセージが表示され，サービスを停止できます。サービスを停止した場合は，更新処理が続行されます。サービスを停止しなかった場合は，更新処理が中断されます。

PFM - Agent for WebSphere Application Serverを示すサービスキーおよびインスタンス名を指定して，jpcconf inst setup (jpcinssetup)コマンドを実行する。
インスタンス名がAPSVのインスタンス環境を更新する場合，次のように指定してコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf inst setup -key WAS -inst APSV (インストール先フォルダ¥tools¥jpcinssetup agt2 -inst APSV)

WebSphere Application Serverのインスタンス情報を更新する。
表2-3に示した項目を，コマンドの指示に従って入力します。現在設定されている値が表示されます。表示された値を変更しない場合は，リターンキーだけを押してください。すべての入力が終了すると，インスタンス環境が更新されます。

更新したインスタンス環境のサービスを再起動する。
サービスの起動方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

2.4.3　Storeバージョン2.0への移行

Storeデータベースの保存形式には，バージョン1.0と2.0の2種類あります。Storeバージョン2.0の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」を参照してください。

Storeバージョン2.0は，PFM - BaseまたはPFM - Managerのバージョン08-10以降の環境に，08-10以降のPFM - Agent for WebSphere Application Serverを新規インストールした場合にデフォルトで利用できます。それ以外の場合は，Storeバージョン1.0形式のままとなっているため，セットアップコマンドによってStoreバージョン2.0に移行してください。

何らかの理由によってStoreバージョン1.0に戻す必要がある場合は，Storeバージョン2.0のアンセットアップを行ってください。

インストール条件に対応するStoreバージョン2.0の利用可否と利用手順を次の表に示します。

表2-6　Storeバージョン2.0の利用可否および利用手順

インストール条件 | Storeバージョン2.0の利用可否 | Storeバージョン2.0の利用手順
インストール済みのPFM - Base，またはPFM - Managerのバージョン | PFM - Agentのインストール方法
08-10より前 | 上書きインストール | 利用できない | PFM - Base，または，PFM - Managerを08-10以降にバージョンアップ後，セットアップコマンドを実行
新規インストール
08-10以降 | 上書きインストール | 既存のインスタンスについてはセットアップ後利用できる | セットアップコマンドを実行
新規インスタンスについては利用できる | インスタンス構築時にjpcconf inst setup (jpcinssetup)コマンドで設定
新規インストール | 利用できる | インスタンス構築時にjpcconf inst setup (jpcinssetup)コマンドで設定

＜この項の構成＞

(1)　Storeバージョン2.0のセットアップ

(2)　Storeバージョン2.0のアンセットアップ

(3)　注意事項

(1)　Storeバージョン2.0のセットアップ

Storeバージョン2.0へ移行する場合のセットアップ手順について説明します。

システムリソース見積もりと保存期間の設計
Storeバージョン2.0導入に必要なシステムリソースが，実行環境に適しているかどうかを確認してください。必要なシステムリソースを次に示します。

ディスク容量

ファイル数

1プロセスがオープンするファイル数

これらの値は保存期間の設定によって調節できます。実行環境の保有しているリソースを考慮して保存期間を設計してください。システムリソースの見積もりについては，「リリースノート」を参照してください。

フォルダの設定
Storeバージョン2.0に移行する場合に，Storeバージョン1.0でのフォルダ設定では，Agent Storeサービスが起動しないことがあります。このため，Agent Storeサービスが使用するフォルダの設定を見直す必要があります。Agent Storeサービスが使用するフォルダの設定はjpcconf db define (jpcdbctrl config)コマンドを使用して表示・変更できます。
Storeバージョン2.0は，Storeデータベースの保存先フォルダやバックアップ先フォルダの最大長がStoreバージョン1.0と異なります。Storeバージョン1.0でフォルダの設定を相対パスに変更している場合，絶対パスに変換した値がStoreバージョン2.0でのフォルダ最大長の条件を満たしているか確認してください。Storeバージョン2.0のフォルダ最大長は214バイトです。フォルダ最大長の条件を満たしていない場合は，Agent Storeサービスが使用するフォルダの設定を変更したあと，手順3以降に進んでください。

セットアップコマンドの実行
Storeバージョン2.0に移行するため，次のコマンドを実行します。

PFM - Managerのンストール先フォルダ¥tools¥jpcconf db vrset -ver 2.0 -key WAS (PFM - Managerのインストール先フォルダ¥tools¥jpcdbctrl setup -key agt2)

jpcconf db vrset (jpcdbctrl setup)コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

保存期間の設定
手順1の見積もり時に設計した保存期間を設定してください。Agent Storeサービスを起動して，PFM - Web Consoleで設定してください。

(2)　Storeバージョン2.0のアンセットアップ

Storeバージョン2.0はjpcconf db vrset -ver 1.0 (jpcdbctrl unsetup)コマンドを使用してアンセットアップします。Storeバージョン2.0をアンセットアップすると，Storeデータベースのデータはすべて初期化され，Storeバージョン1.0に戻ります。

jpcconf db vrset (jpcdbctrl unsetup)コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

(3)　注意事項

移行についての注意事項を次に示します。

(a)　Storeバージョン1.0からStoreバージョン2.0に移行する場合

StoreデータベースをStoreバージョン1.0からStoreバージョン2.0に移行した場合，PIレコードタイプのレコードの保存期間の設定は引き継がれますが，PDレコードタイプのレコードについては，以前の設定値（保存レコード数）に関係なくデフォルトの保存日数がレコードごとに設定され，保存日数以前に収集されたデータは削除されます。

例えば，Storeバージョン1.0で，Collection Intervalが3,600秒のPDレコードの保存レコード数を1,000に設定していた場合，PDレコードは1日に24レコード保存されることになるので，1,000/24≒約42日分のデータが保存されています。このStoreデータベースをStoreバージョン2.0へ移行した結果，デフォルト保存日数が10日に設定されたとすると，11日以上前のデータは削除されて参照できなくなります。

Storeバージョン2.0へ移行する前に，PDレコードタイプのレコードの保存レコード数の設定を確認し，Storeバージョン2.0でのデフォルト保存日数以上のデータが保存される設定となっている場合は，jpctool db dump (jpcctrl dump)コマンドでデータベース内のデータを出力してください。Storeバージョン2.0でのデフォルト保存日数については，リリースノートを参照してください。

(b)　Storeバージョン2.0からStoreバージョン1.0に戻す場合

Storeバージョン2.0をアンセットアップすると，データは初期化されます。このため，Storeバージョン1.0に変更する前に，jpctool db dump (jpcctrl dump)コマンドでStoreバージョン2.0の情報を出力してください。

2.5　コマンドプロンプトの起動方法

Windows Server 2008の環境では，OSのユーザーアカウント制御機能（UAC）を有効にしている場合，コマンドプロンプトは，次の2種類の特権モードで動作します。

管理者特権モードのコマンドプロンプト（管理者コンソール）
Windowsのすべての操作ができるコマンドプロンプトです。

標準特権モードのコマンドプロンプト（標準コンソール）
ユーザー操作の権限が制限されたコマンドプロンプトです。

ユーザーアカウント制御機能（UAC）を無効にしている場合は，常に管理者コンソールが起動されます。

Performance Managementが提供しているコマンドは，必ず管理者コンソールで実行してください。

管理者ユーザーごとのコマンドプロンプトの起動方法を次の表に示します。

表2-7　管理者ユーザーごとのコマンドプロンプトの起動方法

管理者グループ
管理者ユーザー
起動方法

Administrators
Administrator
コマンドプロンプトを起動すると，管理者コンソールが起動されます。

上記以外のユーザー
UACが有効な場合

コマンドプロンプトを起動すると，標準コンソールが起動されます。

管理者コンソールを起動する場合，ユーザーアカウント制御のダイアログボックスが表示されます。ダイアログボックスの［続行］ボタンをクリックすると管理者コンソールが起動されます。［キャンセル］ボタンをクリックした場合は，コマンドプロンプトは起動されません。

UACが無効な場合

コマンドプロンプトを起動すると，管理者コンソールが起動されます。

管理者コンソールは，OSが用意している管理者コンソールと，PFM - Baseが提供している管理者コンソールがあります。それぞれの起動方法を説明します。

＜この節の構成＞

(1)　OSが用意している管理者コンソールの起動方法

(2)　PFM - Base版が提供している管理者コンソールの起動方法

(1)　OSが用意している管理者コンソールの起動方法

［スタート］メニューから［すべてのプログラム］－［アクセサリ］－［コマンドプロンプト］を右クリックし，［管理者として実行］を選択します。

起動されたコマンドプロンプトが管理者コンソールであるかどうかは，タイトルバーに［管理者］が表示されているどうかで判断できます。

(2)　PFM - Base版が提供している管理者コンソールの起動方法

［スタート］メニューから［すべてのプログラム］－［Performance Management］－［管理者コンソール］を選択します。

2.6　バックアップとリストア

PFM - Agent for WebSphere Application Serverのバックアップおよびリストアについて説明します。

障害が発生してシステムが壊れた場合に備えて，PFM - Agent for WebSphere Application Serverの設定情報のバックアップを取得してください。また，PFM - Agent for WebSphere Application Serverをセットアップしたときなど，システムを変更した場合にもバックアップを取得してください。

なお，Performance Managementシステム全体のバックアップおよびリストアについては，マニュアル「JP1/Performance Management 運用ガイド」の，バックアップとリストアについて説明している章を参照してください。

＜この節の構成＞

2.6.1　バックアップ

2.6.2　リストア

2.6.1　バックアップ

バックアップはファイルをコピーするなど，任意の方法で取得してください。バックアップを取得する際は，PFM - Agent for WebSphere Application Serverのサービスを停止した状態で行ってください。

注意

PFM - Agent for WebSphere Application Serverのバックアップを取得する際は，取得した環境の製品バージョン番号を管理するようにしてください。製品バージョン番号の詳細については，リリースノートを参照してください。

PFM - Agent for WebSphere Application Serverの設定情報のバックアップ対象ファイルを次の表に示します。

表2-8　PFM - Agent for WebSphere Application Serverのバックアップ対象ファイル（Windowsの場合）

ファイル名 | 説明
インストール先フォルダ¥agt2¥agent¥インスタンス名※¥*.ini | Agent Collectorサービスの設定ファイル
インストール先フォルダ¥agt2¥store¥インスタンス名※¥*.ini | Agent Storeサービスの設定ファイル

注※

これらのフォルダは，インスタンスの数と同じ数だけ作成されます。

2.6.2　リストア

PFM - Agent for WebSphere Application Serverの設定情報をリストアする場合は，次に示す前提条件を確認した上で，バックアップ対象ファイルを元の位置にコピーしてください。バックアップした設定情報ファイルで，ホスト上の設定情報ファイルを上書きします。

前提条件

PFM - Agent for WebSphere Application Serverがインストール済みであること。

PFM - Agent for WebSphere Application Serverのサービスが停止していること。

システム構成がバックアップしたときと同じであること。

それぞれのホストで，バックアップしたホスト名とリストアするホスト名が一致していること。

バックアップ環境のPFM製品構成情報がリストア対象のPFM製品構成情報と一致していること。

注意

PFM - Agent for WebSphere Application Serverの設定情報をリストアする場合，バックアップを取得した環境とリストアする環境の製品バージョン番号が完全に一致している必要があります。製品バージョン番号の詳細については，リリースノートを参照してください。

2.7　Webブラウザでマニュアルを参照するための設定

Performance Managementでは，PFM - Web Consoleがインストールされているホストに，プログラムプロダクトに標準添付されているマニュアルCD-ROMからマニュアルをコピーすることで，Webブラウザでマニュアルを参照できるようになります。なお，PFM - Web Consoleをクラスタ運用している場合は，実行系，待機系それぞれの物理ホストでマニュアルをコピーしてください。

＜この節の構成＞

2.7.1　設定手順

2.7.2　参照手順

2.7.1　設定手順

＜この項の構成＞

(1)　PFM - Web Consoleのヘルプからマニュアルを参照する場合

(2)　お使いのマシンのハードディスクからマニュアルを参照する場合

(1)　PFM - Web Consoleのヘルプからマニュアルを参照する場合

PFM - Web Consoleのセットアップ手順に従い，PFM - Web ConsoleにPFM - Agentを登録する（PFM - Agentの追加セットアップを行う）。

PFM - Web Consoleがインストールされているホストに，マニュアルのコピー先フォルダを作成する。

Windowsの場合：Web Consoleのインストール先フォルダ¥doc¥ja¥××××

UNIXの場合：/opt/jp1pcwebcon/doc/ja/××××

××××には，PFM - AgentのヘルプIDを指定してください。ヘルプIDについては，「付録C　識別子一覧」を参照してください。

手順2で作成したフォルダの直下に，マニュアルCD-ROMから次のファイルおよびフォルダをコピーする。

HTMLマニュアルの場合

Windowsの場合：CD-ROMドライブ¥MAN¥3021¥資料番号（03004A0Dなど）下の，すべてのhtmファイルおよびFIGUREフォルダ

UNIXの場合：/CD-ROMのマウントポイント/MAN/3021/資料番号（03004A0Dなど）下の，すべてのhtmファイルおよびFIGUREディレクトリ

PDFマニュアルの場合

Windowsの場合：CD-ROMドライブ¥MAN¥3021¥資料番号（03004A0Dなど）下のPDFファイル

UNIXの場合：/CD-ROMのマウントポイント/MAN/3021/資料番号（03004A0Dなど）下のPDFファイル

コピーの際，HTMLマニュアルの場合はindex.htmファイルが，PDFマニュアルの場合はPDFファイル自体が，作成したフォルダ直下に配置されるようにしてください。マニュアルファイルのコピー方法については，マニュアルCD-ROMのreadme.txtを参照してください。

PFM - Web Consoleを再起動する。

(2)　お使いのマシンのハードディスクからマニュアルを参照する場合

CD-ROMのsetup.exeを使ってインストールするか，または直接htmファイル，PDFファイル，およびGIFファイルを任意のフォルダにコピーしてください。HTMLマニュアルの場合，次のフォルダ構成になるようにしてください。

html（htmファイルおよびPDFファイルを格納）
└FIGURE（GIFファイルを格納）

2.7.2　参照手順

マニュアルの参照手順を次に示します。

PFM - Web Consoleの［メイン］画面のメニューバーフレームにある［ヘルプ］メニューをクリックし，［ヘルプ選択］画面を表示する。

マニュアル名またはマニュアル名の後ろの［PDF］をクリックする。
マニュアル名をクリックするとHTML形式のマニュアルが表示されます。［PDF］をクリックするとPDF形式のマニュアルが表示されます。

Webブラウザでの文字の表示に関する注意事項

［スタート］メニューからオンラインマニュアルを表示させると，すでに表示されているWebブラウザの画面上にHTMLマニュアルが表示されることがあります。

また，Internet Explorer 5を使用している場合，文字が不正に表示されることがあります。この場合，次のように設定してください。

［表示］－［エンコード］の［自動選択］のチェックを外す。

［表示］－［エンコード］の日本語で［日本語（シフトJIS）］を選択する。

3.　インストールとセットアップ（UNIXの場合）

この章では，PFM - Agent for WebSphere Application Serverのインストールおよびセットアップ方法について説明します。Performance Managementシステム全体のインストールおよびセットアップ方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

＜この章の構成＞

3.1　インストールとセットアップ

3.2　アンインストールとアンセットアップ

3.3　PFM - Agent for WebSphere Application Serverのシステム構成の変更

3.4　PFM - Agent for WebSphere Application Serverの運用方式の変更

3.5　バックアップとリストア

3.6　Webブラウザでマニュアルを参照するための設定

3.1　インストールとセットアップ

ここでは，PFM - Agent for WebSphere Application Serverをインストールおよびセットアップする手順について説明します。

＜この節の構成＞

3.1.1　インストールとセットアップの流れ

3.1.2　インストールとセットアップの前に

3.1.3　インストール手順

3.1.4　PFM - Agent for WebSphere Application Serverのセットアップ手順

3.1.1　インストールとセットアップの流れ

PFM - Agent for WebSphere Application Serverをインストールおよびセットアップする流れを次の図に示します。

図3-1　インストールとセットアップの流れ

PFM - ManagerおよびPFM - Web Consoleのインストールおよびセットアップの手順は，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

なお，ユーザー入力を必要とするセットアップコマンドは，対話形式で実行するか非対話形式で実行するかを選択できます。

対話形式で実行する場合は，コマンドの指示に従ってユーザーが値を入力する必要があります。

非対話形式で実行する場合は，コマンド実行中に必要となる入力作業をオプション指定や定義ファイルで代替するため，ユーザー入力が不要になります。また，バッチ処理やリモート実行によってセットアップ作業を自動化できるため，管理者の負担や運用コストを低減できます。

コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

3.1.2　インストールとセットアップの前に

PFM - Agent for WebSphere Application Serverをインストールおよびセットアップをする前に確認しておく項目について説明します。

＜この項の構成＞

(1)　前提OS

(2)　ネットワークの環境設定

(3)　インストールに必要なOSユーザー権限について

(4)　前提プログラム

(5)　クラスタシステムでのインストールとセットアップについて

(6)　注意事項

(1)　前提OS

PFM - Agent for WebSphere Application Serverが動作するOSを次に示します。

Solaris

AIX

Linux (x64)

Linux (x86)

(2)　ネットワークの環境設定

Performance Managementが動作するためのネットワーク環境について説明します。

(a)　IPアドレスの設定

PFM - Agentのホストは，ホスト名でIPアドレスを解決できる環境を設定してください。IPアドレスを解決できない環境では，PFM - Agentは起動できません。

監視ホスト名（Performance Managementシステムのホスト名として使用する名前）には，実ホスト名またはエイリアス名を使用できます。

監視ホスト名に実ホスト名を使用している場合
Windowsシステムではhostnameコマンド，UNIXシステムではuname -nコマンドを実行して確認したホスト名で，IPアドレスを解決できるように環境を設定してください。なお，UNIXシステムでは，hostnameコマンドで取得するホスト名を使用することもできます。

監視ホスト名にエイリアス名を使用している場合
設定しているエイリアス名でIPアドレスを解決できるように環境を設定してください。

監視ホスト名の設定については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

ホスト名とIPアドレスは，次のどれかの方法で設定してください。

Performance Managementのホスト情報設定ファイル（jpchostsファイル）

hostsファイル

DNS（Domain Name System）

注意

Performance Managementは，DNS環境でも運用できますが，FQDN形式のホスト名には対応していません。このため，監視ホスト名は，ドメイン名を除いて指定してください。

複数のLAN環境で使用する場合は，jpchostsファイルでIPアドレスを設定してください。詳細は，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

Performance Managementは，DHCPによる動的なIPアドレスが割り振られているホスト上では運用できません。Performance Managementを導入するすべてのホストに，固定のIPアドレスを設定してください。

PFM - ManagerとPFM - Agent for WebSphere Application ServerをIPv6で通信する場合，PFM - ManagerホストとPFM - AgentホストのそれぞれでIPv6の利用設定を有効にする必要があります。この設定はjpcconf ipv6 enableコマンドで実行しますが，コマンドの実行有無は次のとおりです。

jpcconf ipv6 enableコマンドの実行が必要なケース

それぞれのホストで，IPv4環境からIPv6環境に変更する場合

IPv4環境とIPv6環境が共存していて，PFM - ManagerをIPv4環境からIPv6環境に変更する場合

jpcconf ipv6 enableコマンドの実行が不要なケース

それぞれのホストが，すでにIPv6環境である場合

IPv4環境とIPv6環境が共存していて，PFM - ManagerがIPv6環境である場合

jpcconf ipv6 enableコマンドの実行例を次に示します。

/opt/jp1pc/tools/jpcconf ipv6 enable

jpcconf ipv6 enableコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。また，jpcconf ipv6 enableコマンドを実行する条件やタイミングについては，マニュアル「JP1/Performance Management 設計・構築ガイド」のIPv6環境が含まれる場合のネットワーク構成例について説明している章を参照してください。

(b)　ポート番号の設定

Performance Managementプログラムのサービスは，デフォルトで次の表に示すポート番号が割り当てられています。これ以外のサービスまたはプログラムに対しては，サービスを起動するたびに，そのときシステムで使用されていないポート番号が自動的に割り当てられます。また，ファイアウォール環境で，Performance Managementを使用するときは，ポート番号を固定してください。ポート番号の固定の手順は，マニュアル「JP1/Performance Management 設計・構築ガイド」のインストールとセットアップについて説明している章を参照してください。

表3-1　デフォルトのポート番号とPerformance Managementプログラムのサービス（UNIXの場合）

サービス説明
サービス名
パラメーター
ポート番号
備考

サービス構成情報管理機能
Name Server
jp1pcnsvr
22285
PFM - ManagerのName Serverサービスで使用されるポート番号。Performance Managementのすべてのホストで設定される。

NNM連携機能
NNM Object Manager
jp1pcovsvr
22292
PFM - ManagerおよびPFM - BaseのNNM連携機能で，マップマネージャーとオブジェクトマネージャの間の通信で使用されるポート番号。
PFM - ManagerおよびPFM - Baseがインストールされているホストで設定される。

サービス状態管理機能
Status Server
jp1pcstatsvr
22350
PFM - ManagerおよびPFM - BaseのStatus Serverサービスで使用されるポート番号。
PFM - ManagerおよびPFM - Baseがインストールされているホストで設定される。

JP1/ITSLM連携機能
JP1/ITSLM
－
20905
JP1/ITSLMで設定されるポート番号です。

これらのPFM - Agentが使用するポート番号で通信できるように，ネットワークを設定してください。

(3)　インストールに必要なOSユーザー権限について

PFM - Agent for WebSphere Application Serverをインストールするときは，必ず，スーパーユーザー権限を持つアカウントで実行してください。

(4)　前提プログラム

ここでは，PFM - Agent for WebSphere Application Serverをインストールする場合に必要な前提プログラムについて説明します。プログラムの構成図を次に示します。

図3-2　プログラムの構成図

(a)　監視対象プログラム

PFM - Agent for WebSphere Application Serverの監視対象プログラムを次に示します。

IBM WebSphere Application Server V6.0

IBM WebSphere Application Server V6.1

IBM WebSphere Application Server V7.0

IBM WebSphere Application Server Network Deployment V6.0

IBM WebSphere Application Server Network Deployment V6.1

IBM WebSphere Application Server Network Deployment V7.0

これらの監視対象プログラムは，PFM - Agent for WebSphere Application Serverと同一ホストにインストールする必要があります。

(b)　Performance Managementプログラム

監視エージェントには，PFM - AgentとPFM - Baseをインストールします。PFM - BaseはPFM - Agentの前提プログラムです。同一ホストに複数のPFM - Agentをインストールする場合でも，PFM - Baseは1つだけでかまいません。

ただし，PFM - ManagerとPFM - Agentを同一ホストにインストールする場合，PFM - Baseは不要です。

また，PFM - Agent for WebSphere Application Serverを使ってWebSphere Application Serverの稼働監視をするためには，PFM - ManagerおよびPFM - Web Consoleが必要です。

(5)　クラスタシステムでのインストールとセットアップについて

クラスタシステムでのインストールとセットアップは，前提となるネットワーク環境やプログラム構成が，通常の構成のセットアップとは異なります。また，実行系ノードと待機系ノードでの作業が必要になります。詳細については，「4.　クラスタシステムでの運用」を参照してください。

(6)　注意事項

ここでは，Performance Managementをインストールおよびセットアップするときの注意事項について説明します。

(a)　環境変数に関する注意事項

Performance ManagementではJPC_HOSTNAMEを環境変数として使用しているため，ユーザー独自に環境変数として設定しないでください。設定した場合は，Performance Managementが正しく動作しません。

(b)　同一ホストにPerformance Managementプログラムを複数インストール，セットアップするときの注意事項

Performance Managementは，同一ホストにPFM - Manager，PFM - Web Console，およびPFM - Agentをインストールすることもできます。その場合の注意事項を次に示します。

PFM - ManagerとPFM - Agentを同一ホストにインストールする場合，PFM - Baseは不要です。この場合，PFM - Agentの前提プログラムはPFM - Managerになるため，PFM - Managerをインストールしてから PFM - Agentをインストールしてください。

PFM - BaseとPFM - Managerは同一ホストにインストールできません。PFM - BaseとPFM - AgentがインストールされているホストにPFM - Managerをインストールする場合は，すべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Manager，PFM - Agentの順でインストールしてください。また，PFM - Manager とPFM - AgentがインストールされているホストにPFM - Baseをインストールする場合も同様に，すべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Base，PFM - Agentの順でインストールしてください。

PFM - ManagerがインストールされているホストにPFM - Agentをインストールすると，接続先PFM - ManagerはローカルホストのPFM - Managerになります。この場合，接続先PFM - ManagerをリモートホストのPFM - Managerに変更できません。リモートホストのPFM - Managerに接続したい場合は，インストールするホストにPFM - Managerがインストールされていないことを確認してください。

PFM - AgentがインストールされているホストにPFM - Managerをインストールすると，PFM - Agentの接続先PFM - Managerは自ホスト名に設定し直されます。共通メッセージログに設定結果が出力されています。結果を確認してください。

PFM - Web Consoleがインストールされているホストに，PFM - Agentをインストールする場合は，Webブラウザの画面をすべて閉じてからインストールを実施してください。

Performance Managementプログラムを新規にインストールした場合は，ステータス管理機能がデフォルトで有効になります。ただし，07-50から08-00以降にバージョンアップインストールした場合は，ステータス管理機能の設定状態はバージョンアップ前のままとなります。ステータス管理機能の設定を変更する場合は，マニュアル「JP1/Performance Management 運用ガイド」のPerformance Managementの障害検知について説明している章を参照してください。

ポイント

システムの性能や信頼性を向上させるため，PFM - Manager，PFM - Web Console，およびPFM - Agentはそれぞれ別のホストで運用することをお勧めします。

(c)　バージョンアップの注意事項

古いバージョンのPFM - Agentからバージョンアップする場合の注意事項を次に示します。

なお，バージョンアップの詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録を参照してください。

Performance Managementのプログラムをインストールするときは，ローカルホストのPerformance Managementのプログラムおよびサービスをすべて停止しておいてください。サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

すでにPerformance ManagementプログラムがインストールされているホストにPFM - Agentをインストールする場合，PFM - Agentのインストールパスは，すでにインストールされているPFM - Web Console以外のPerformance Managementプログラムのインストールパスと同じになります。インストールパスを変更したい場合は，インストール済みのPFM - Web Console以外のPerformance Managementプログラムをすべて削除し，インストールし直す必要があります。

PFM - BaseとPFM - Managerは同一ホストにインストールできません。PFM - BaseとPFM - AgentがインストールされているホストにPFM - Managerをインストールする場合は，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Manager，PFM - Agentの順でインストールしてください。また，PFM - ManagerとPFM - AgentがインストールされているホストにPFM - Baseをインストールする場合も同様に，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Base，PFM - Agentの順でインストールしてください。

バージョン08-00以降のPerformance Managementプログラムでは，Store実行プログラム（jpcstoおよびstpqlpr）の配置先が変更されています。PFM - Agentを08-00以降にバージョンアップする際に，旧配置先のStore実行モジュールは削除されます。

バージョンアップでStoreデータベースのデータモデルバージョンが変更される場合，既存のStoreデータベースが自動的にバージョンアップされるため，一時的にStoreデータベースのディスク占有量が2倍になります。バージョンアップインストールする前に，Storeデータベースの格納先のディスクに十分な空き容量があるかどうか確認してください。必要な空き容量は，現在のStoreデータベースの合計サイズを基準に考慮してください。例えば，現在のStoreデータベースの合計サイズが100ギガバイトの場合，バージョンアップインストールに必要なディスクの空き容量は200ギガバイト以上です。Storeデータベースの格納先ディスクを変更している場合は，変更後のディスク容量に対して考慮してください。

(d)　その他の注意事項

Performance Managementのプログラムをインストールする場合，次に示すセキュリティ関連プログラムがインストールされていないかどうか確認してください。インストールされている場合，次の説明に従って対処してください。

セキュリティ監視プログラム
セキュリティ監視プログラムを停止するかまたは設定を変更して，Performance Managementのプログラムのインストールを妨げないようにしてください。

ウィルス検出プログラム
ウィルス検出プログラムを停止してからPerformance Managementのプログラムをインストールしてください。
Performance Managementのプログラムのインストール中にウィルス検出プログラムが稼働している場合，インストールの速度が低下したり，インストールが実行できなかったり，または正しくインストールできなかったりすることがあります。

プロセス監視プログラム
プロセス監視プログラムを停止するかまたは設定を変更して，Performance Managementのサービスまたはプロセス，および共通コンポーネントのサービスまたはプロセスを監視しないようにしてください。
Performance Managementのプログラムのインストール中に，プロセス監視プログラムによって，これらのサービスまたはプロセスが起動されたり停止されたりすると，インストールに失敗することがあります。

Performance Managementのプログラムが1つもインストールされていない環境に新規インストールする場合は，インストール先ディレクトリにファイルやディレクトリがないことを確認してください。

インストール時のステータスバーに「Installation failed.」と表示されてインストールが失敗した場合，インストールログを採取してください。なお，このログファイルは，次にインストールすると上書きされるため，必要に応じてバックアップを採取してください。インストールログのデフォルトのファイル名については，「8.4.2(2)　Performance Managementの情報」を参照してください。

インストール先ディレクトリにリンクを張りPerformance Managementのプログラムをインストールした場合，すべてのPerformance Managementのプログラムをアンインストールしても，リンク先のディレクトリに一部のファイルやディレクトリが残る場合があります。削除する場合は，手動で行ってください。また，リンク先にインストールする場合，リンク先に同名のファイルやディレクトリがあるときは，Performance Managementのプログラムのインストール時に上書きされるので，注意してください。

/opt/jp1pc/setupディレクトリにPFM - Agent for WebSphere Application Serverのセットアップファイルがある場合，新規PFM - Agent for WebSphere Application Serverの追加セットアップが実行されます。PFM - Agent for WebSphere Application Serverの追加セットアップが成功した場合の実行結果は共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されます。確認してください。

3.1.3　インストール手順

ここでは，PFM - Agentのプログラムをインストールする順序とCD-ROMの提供媒体からプログラムをインストールする手順について説明します。

＜この項の構成＞

(1)　プログラムのインストール順序

(2)　プログラムのインストール方法

(1)　プログラムのインストール順序

まず，PFM - Baseをインストールし，次にPFM - Agentをインストールします。PFM - BaseがインストールされていないホストにPFM - Agentをインストールすることはできません。

なお，PFM - Managerと同一ホストにPFM - Agentをインストールする場合は，PFM - Manager，PFM - Agentの順でインストールしてください。また，Storeデータベースのバージョン1.0からバージョン2.0にバージョンアップする場合，PFM - AgentとPFM - ManagerまたはPFM - Baseのインストール順序によって，セットアップ方法が異なります。Storeバージョン2.0のセットアップ方法については，「3.4.3　Storeバージョン2.0への移行」を参照してください。

同一ホストに複数のPFM - Agentをインストールする場合，PFM - Agent相互のインストール順序は問いません。

図3-3　プログラムのインストール順序

(2)　プログラムのインストール方法

UNIXホストにPerformance Managementプログラムをインストールするには，CD-ROMの提供媒体を使用する方法と，JP1/NETM/DMを使用してリモートインストールする方法があります。JP1/NETM/DMを使用する方法については，次のマニュアルを参照してください。

「JP1/NETM/DM Manager」

「JP1/NETM/DM SubManager（UNIX(R)用）」

「JP1/NETM/DM Client（UNIX(R)用）」

注意

インストールするホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。なお，停止するサービスは，物理ホスト上および論理ホスト上のすべてのサービスです。サービスの停止方法は，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

CD-ROMの提供媒体を使用する場合のインストール手順をOSごとに示します。

(a)　Solaris 10 (SPARC)の場合

PFM - Agent for WebSphere Application Serverをインストールするホストに，スーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

ローカルホストでPerformance Managementのプログラムおよびサービスをすべて停止する。
Performance Managementのプログラムおよびサービスが起動している場合は，すべて停止してください。

Performance Managementのプログラムの媒体をセットする。

次のコマンドを実行して，Hitachi PP Installerを起動する。※

/cdrom/cdrom/SOLARIS/SETUP /cdrom/cdrom

Hitachi PP Installerが起動され，初期画面が表示されます。
なお，指定するコマンドは，使用する環境によって異なります。

注※

自動マウント機能を解除している環境では，Hitachi PP Installerを起動する前に，/usr/sbin/mountコマンドを次のように指定してCD-ROM装置をマウントしてください。

/usr/sbin/mount -F cdfs -r デバイススペシャルファイル名 /cdrom/cdrom

なお，指定するコマンドは，使用する環境によって異なります。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールしたいPerformance Managementのプログラムを選択して，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースキーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

(b)　AIXの場合

PFM - Agent for WebSphere Application Serverをインストールするホストに，スーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

ローカルホストでPerformance Managementのプログラムおよびサービスを停止する。
Performance Managementのプログラムおよびサービスが起動している場合は，すべて停止してください。

Performance Managementのプログラムの媒体をセットする。

mountコマンドを実行して，CD-ROM装置をマウントする。
例えば，CD-ROM装置を/cdromにマウントする場合，次のように指定してコマンドを実行します。

/usr/sbin/mount -r -v cdrfs /dev/cd0 /cdrom

次のコマンドを実行して，Hitachi PP Installerを起動する。

/cdrom/AIX/SETUP /cdrom

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールしたいPerformance Managementのプログラムを選択して，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースキーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

(c)　Linux (x64)，Linux (x86)の場合

PFM - Agent for WebSphere Application Serverのインストール先ディレクトリ「/opt/jp1pc/*」が実ディレクトリであることを確認する。
インストール先ディレクトリが実ディレクトリでなく，シンボリックリンク設定である場合，シンボリック設定が解除されます。

PFM - Agent for WebSphere Application Serverをインストールするホストに，スーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

ローカルホストでPerformance Managementのプログラムおよびサービスを停止する。
Performance Managementのプログラムおよびサービスが起動している場合は，すべて停止してください。

Performance Managementのプログラムの媒体をセットする。

次のコマンドを実行して，Hitachi PP Installerを起動する。※

/media/cdrecorder/LINUX/SETUP /media/cdrecorder

下線部のCD-ROMファイルシステムのマウントディレクトリ名は，使用する環境によって異なります。
Hitachi PP Installerが起動され，初期画面が表示されます。

注※

自動マウント機能を解除している環境では，Hitachi PP Installerを起動する前に，/bin/mountコマンドを次のように指定してCD-ROM装置をマウントしてください。

/bin/mount -r -o mode=0544 デバイススペシャルファイル名 /media/cdrecorder

なお，指定するコマンド，および下線部分は，使用する環境によって異なります。

初期画面で「I」を入力する。
インストールできるプログラムの一覧が表示されます。

インストールしたいPerformance Managementのプログラムを選択して，「I」を入力する。
選択したプログラムがインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースキーで選択します。

インストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

3.1.4　PFM - Agent for WebSphere Application Serverのセットアップ手順

ここでは，PFM - Agent for WebSphere Application Serverを運用するためのセットアップについて説明します。

[図データ]は使用する環境によって必要になるセットアップ項目，またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。

＜この項の構成＞

(1)　LANG環境変数を設定する

(2)　PFM - Agent for WebSphere Application Serverの登録

(3)　インスタンス環境の設定

(4)　ネットワークの設定

(5)　ログのファイルサイズ変更

(6)　パフォーマンスデータの格納先の変更

(7)　PFM - Agent for WebSphere Application Serverの接続先PFM - Managerの設定

(8)　動作ログ出力の設定

(1)　LANG環境変数を設定する

PFM - Agent for WebSphere Application Serverで使用できるLANG環境変数を次の表に示します。

なお，これらのLANG環境変数を設定する前に，設定する言語環境が正しくインストール・構築されていることを確認しておいてください。正しくインストール・構築されていない場合，文字化けが発生したり，定義データが不当に書き換わってしまったりすることがあります。

注意

共通メッセージログの言語は，サービス起動時やコマンド実行時に設定されているLANG環境変数によって決まります。そのため，日本語や英語など，複数の言語コードの文字列が混在することがあります。

表3-2　PFM - Agent for WebSphere Application Serverで使用できるLANG環境変数

OS
言語種別
LANG環境変数の値

Solaris
日本語
Shift-JISコード

ja_JP.PCK

EUCコード

ja

japanese

英語（日本語なし）
C

AIX
日本語
Shift-JISコード

Ja_JP

Ja_JP.IBM-932

EUCコード

ja_JP

ja_JP.IBM-eucJP

英語（日本語なし）
C

Linux
日本語
Shift-JISコード
（該当なし）

EUCコード
（該当なし）

UTF-8コード

ja_JP.UTF-8

ja_JP.utf8

英語（日本語なし）
C

(2)　PFM - Agent for WebSphere Application Serverの登録

PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために，PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for WebSphere Application Serverを登録する必要があります。

PFM - Managerのバージョンが08-50以降の場合，PFM - Agentの登録は自動で行われるため，ここで説明する手順は不要です。ただし，PFM - Managerのリリースノートに記載されていないデータモデルバージョンのPFM - Agentは手動で登録する必要があります。なお，PFM - Agent for WebSphere Application Serverのデータモデルのバージョンについては，「付録H　バージョン互換」を参照してください。

PFM - Agentの登録の流れを次の図に示します。

図3-4　PFM - Agentの登録の流れ

注意

PFM - Agent の登録は，インスタンス環境を設定する前に実施してください。

すでにPFM - Agent for WebSphere Application Serverの情報が登録されているPerformance Managementシステムに，新たに同じバージョンのPFM - Agent for WebSphere Application Serverを追加した場合，PFM - Agentの登録は必要ありません。

PFM - Managerと同じホストにPFM - Agentをインストールした場合，jpcconf agent setup (jpcagtsetup)コマンドが自動的に実行されます。共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されるので，結果を確認してください。コマンドが正しく実行されていない場合は，コマンドを実行し直してください。コマンドの実行方法については，マニュアル「JP1/Performance Management リファレンス」のコマンドの章を参照してください。

PFM - Agent for WebSphere Application Serverの情報を登録する作業では，PFM - Web Consoleの［レポート階層］画面および［アラーム階層］画面に「WebSphere Application Server」という名前のディレクトリが作成されます。［レポート階層］画面で，すでに独自に「WebSphere Application Server」という名前のディレクトリまたはファイルを作成していた場合には，名前を変更してから作業を始めてください。

(a)　PFM - Agent for WebSphere Application Serverのセットアップファイルをコピーする

PFM - Agent for WebSphere Application Serverをインストールしたホストにあるセットアップファイルを，PFM - ManagerおよびPFM - Web Consoleをインストールしたホストにコピーします。手順を次に示します。

PFM - Web Consoleが起動されている場合は，停止する。

PFM - Agentのセットアップファイルをバイナリーモードでコピーする。
ファイルが格納されている場所およびファイルをコピーする場所を次の表に示します。

表3-3　コピーするセットアップファイル

コピー先
PFM - Agentの
セットアップファイル

PFMプログラム名
OS
コピー先ディレクトリ

PFM - Manager
Windows
PFM - Managerのインストール先ディレクトリ¥setup¥
/opt/jp1pc/setup/jpcagt2w.EXE

UNIX
/opt/jp1pc/setup/
/opt/jp1pc/setup/jpcagt2u.Z

PFM - Web Console
Windows
PFM - Web Consoleのインストール先ディレクトリ¥setup¥
/opt/jp1pc/setup/jpcagt2w.EXE

UNIX
/opt/jp1pcwebcon/setup/
/opt/jp1pc/setup/jpcagt2u.Z

(b)　PFM - Managerホストでセットアップコマンドを実行する

PFM - ManagerでPFM - Agent for WebSphere Application Serverをセットアップするために，次のコマンドを実行します。

/opt/jp1pc/tools/jpcconf agent setup -key WAS (/opt/jp1pc/tools/jpcagtsetup agt2)

ここでは，対話形式の実行例を示していますが，jpcconf agent setupコマンドは非対話形式でも実行できます。jpcconf agent setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

注意

コマンドを実行するローカルホストのPerformance Managementのプログラムおよびサービスが完全に停止していない状態でjpcconf agent setup (jpcagtsetup)コマンドを実行した場合，エラーが発生することがあります。その場合は，Performance Managementのプログラムおよびサービスが完全に停止したことを確認したあと，再度jpcconf agent setup (jpcagtsetup)コマンドを実行してください。

PFM - ManagerホストにあるPFM - Agentのセットアップファイルは，この作業が終了したあと，削除してもかまいません。

(c)　PFM - Web Consoleホストでセットアップコマンドを実行する

PFM - Web ConsoleでPFM - Agent for WebSphere Application Serverをセットアップするための次のコマンドを実行します。

/opt/jp1pcwebcon/tools/jpcwagtsetup (/opt/jp1pc/tools/jpcwagtsetup)

PFM - Web ConsoleホストにあるPFM - Agentのセットアップファイルは，この作業が終了したあと削除してもかまいません。

(3)　インスタンス環境の設定

インスタンス環境の設定では，インスタンス情報の設定を実施します。複数のインスタンス環境を設定する場合は，繰り返し実施します。

(a)　インスタンス情報を設定する

PFM - Agent for WebSphere Application Serverで監視するWebSphere Application Serverのインスタンス情報を設定します。インスタンス情報の設定は，PFM - Agentホストで実施します。

設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に，次の表の情報をあらかじめ確認してください。WebSphere Application Serverのインスタンス情報の詳細については，WebSphere Application Serverのドキュメントを参照してください。

注意

インスタンス環境を設定していない場合，PFM - Agent for WebSphere Application Serverのサービスを起動できません。

表3-4　PFM - Agent for WebSphere Application Serverのインスタンス情報

項目
説明
設定できる値
デフォルト値

WebSphere Application Server Installation Directory
WebSphere Application Serverのインストール先ディレクトリ。
1～512バイトの半角文字列。
なし

WebSphere Application Server Version
WebSphere Application Serverのバージョン。
6：V6.0，V6.1
7：V7.0
「6」または「7」。
6

SOAP Connector Port Number
WebSphere Application ServerのSOAPコネクターポート番号。
1024～65535の数値。
8880

User Name※1，※2
WebSphere Application Serverに接続するためのHTTP基本認証のユーザーID。
1～512バイトの半角文字列。
なし

Password※2
WebSphere Application Serverに接続するためのHTTP基本認証のパスワード。
1～256バイトの半角文字列。
なし

TrustStore File Path※3
WebSphere Application ServerのSOAPコネクターポートでSSLを使用している場合※4に，サーバ（WebSphere Application Server）を認証するための，JKS（Java keystore）形式のトラストストアファイル（絶対パス）。※5
1～512バイトの半角文字列。
なし

TrustStore Password※3
WebSphere Application ServerのSOAPコネクターポートでSSLを使用している場合に，WebSphere Application Serverに接続するためのトラストストアファイルのパスワード。
1～256バイトの半角文字列。
なし

Store Version※6
使用するStoreバージョン。※7
「1.0」または「2.0」。
2.0

注※1

このユーザーには，Monitorセキュリティロールが与えられている必要があります。

注※2

HTTP基本認証を使用していない場合は空白（スペース）にしてください。

注※3

SSLを使用していない場合は空白（スペース）にしてください。

注※4

IBM WebSphere Application Server V6.0またはIBM WebSphere Application Server Network Deployment V6.0において，「グローバル・セキュリティーの使用可能化」オプションを設定している場合。IBM WebSphere Application Server V6.1/V7.0またはIBM WebSphere Application Server Network Deployment V6.1/V7.0において，「管理セキュリティーを使用可能にする」に設定している場合。

注※5

JKS形式のトラストストアファイルは，WebSphere Application Serverに付属の鍵管理ユーティリティ（iKeyman）などで作成できます。

例えば，WebSphere Application Server V6.1の場合，デフォルトではSOAP_CONNECTOR_ADDRESSのSSL構成にNodeDefaultSSLSettingsが設定されていて，default証明書が利用されます。このdefault証明書に対応するサーバ認証用のトラストストアファイルは次の場所にあります。

WebSphere Application Serverのプロファイル・ディレクトリ/etc/DummyClientTrustFile.jks

WebSphere Application Server V6.1がデフォルトのSSL構成の場合は，上記のトラストストアファイルを設定できますが，有効期限があるため注意が必要です。

また，WebSphere Application ServerのSSL構成を変更した場合や任意のサーバ証明書を適用した場合は，その証明書に対応したトラストストアファイルを作成して設定する必要があります。SSL構成の詳細については，WebSphere Application Serverのマニュアルを参照してください。

注※6

JP1/PFM - Agent for WebSphere Application Serverと同一ホスト上のJP1/PFM - ManagerまたはJP1/PFM - Baseが08-10以降で，インスタンス環境を新規に設定する場合に必要です。インスタンス環境を更新するときは指定できません。

注※7

Storeバージョンについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

インスタンス環境を構築するには，jpcconf inst setup (jpcinssetup)コマンドを使用します。

インスタンス環境の構築手順を次に示します。複数のインスタンス環境を設定する場合は，この手順を繰り返し実施します。

サービスキーおよびインスタンス名を指定して，jpcconf inst setup (jpcinssetup)コマンドを実行する。
例えば，PFM - Agent for WebSphere Application Serverのインスタンス名APSVのインスタンス環境を構築する場合，次のように指定してコマンドを実行します。

/opt/jp1pc/tools/jpcconf inst setup -key WAS -inst APSV (/opt/jp1pc/tools/jpcinssetup agt2 -inst APSV)

インスタンス名には，WebSphere Application Serverのサーバ名など，監視対象のWebSphere Application Serverのインスタンスを一意に識別できる任意の名称を指定してください。
jpcconf inst setup (jpcinssetup)コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

WebSphere Application Serverのインスタンス情報を設定する。
表3-4に示した項目を，コマンドの指示に従って入力してください。省略はできません。デフォルトで表示されている値を入力する場合は，リターンキーだけを押してください。

すべての入力が終了すると，インスタンス環境が構築されます。構築時に入力した内容を変更したい場合は，再度jpcconf inst setup (jpcinssetup)コマンドを実行し，インスタンス環境を更新してください。インスタンス環境の更新については，「3.4.2　インスタンス環境の更新の設定」を参照してください。

構築されるインスタンス環境を次に示します。

インスタンス環境のディレクトリ構成
次のディレクトリ下にインスタンス環境が構築されます。
物理ホストの場合：/opt/jp1pc/agt2
論理ホストの場合：環境ディレクトリ※/jp1pc/agt2

注※

環境ディレクトリとは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

構築されるインスタンス環境のディレクトリ構成を次に示します。

表3-5　インスタンス環境のディレクトリ構成

ディレクトリ名・ファイル名 | 説明
agent | インスタンス名 | jpcagt.ini | Agent Collectorサービス起動情報ファイル
jpcagt.ini.model※ | Agent Collectorサービス起動情報ファイルのモデルファイル
log | ログファイル格納ディレクトリ
store | インスタンス名 | *.DAT | データモデル定義ファイル
backup | バックアップ先ディレクトリ
dump | エクスポート先ディレクトリ
import | 標準のデータベースインポート先ディレクトリ（Storeバージョン2.0の場合）
jpcsto.ini | Agent Storeサービス起動情報ファイル
jpcsto.ini.model※ | Agent Storeサービス起動情報ファイルのモデルファイル
log | ログファイル格納ディレクトリ
partial | 標準のデータベース部分バックアップ先ディレクトリ（Storeバージョン2.0の場合）
STPD | PDレコードタイプのパフォーマンスデータ格納先ディレクトリ（Storeバージョン2.0の場合）
STPI | PIレコードタイプのパフォーマンスデータ格納先ディレクトリ（Storeバージョン2.0の場合）

注※

インスタンス環境を構築した時点の設定値に戻したいときに使用します。

インスタンス環境のサービスID
インスタンス環境のサービスIDは次のようになります。

プロダクトID 機能ID インスタンス番号 インスタンス名 [ホスト名]

PFM - Agent for WebSphere Application Serverの場合，インスタンス名にはjpcconf inst setup (jpcinssetup)コマンドで指定したインスタンス名が表示されます。
サービスIDについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の，付録に記載されている命名規則を参照してください。

(4)　ネットワークの設定[図データ]

Performance Managementを使用するネットワーク構成に応じて，変更する場合に必要な設定です。

ネットワークの設定には次の2つの項目があります。

IPアドレスを設定する
Performance Managementを複数のLANに接続されたネットワークで使用するときに設定します。複数のIPアドレスを設定するには，jpchostsファイルにホスト名とIPアドレスを定義します。設定したjpchostsファイルはPerformance Managementシステム全体で統一させてください。
詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

ポート番号を設定する
Performance Managementが使用するポート番号を設定できます。運用での混乱を避けるため，ポート番号とサービス名は，Performance Managementシステム全体で統一させてください。
ポート番号の設定の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

(5)　ログのファイルサイズ変更[図データ]

Performance Managementの稼働状況を，Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは，デフォルトで2,048キロバイトのファイルが2ファイル使用されます。このファイルサイズを変更したい場合に，必要な設定です。

詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

(6)　パフォーマンスデータの格納先の変更[図データ]

PFM - Agent for WebSphere Application Serverで管理されるパフォーマンスデータを格納するデータベースの保存先，バックアップ先，エクスポート先，またはインポート先のディレクトリを変更したい場合に，必要な設定です。

パフォーマンスデータは，デフォルトで，次の場所に保存されます。

保存先：/opt/jp1pc/agt2/store/インスタンス名/

バックアップ先：/opt/jp1pc/agt2/store/インスタンス名/backup/

部分バックアップ先※：/opt/jp1pc/agt2/store/インスタンス名/partial/

エクスポート先：/opt/jp1pc/agt2/store/インスタンス名/dump/

インポート先※：/opt/jp1pc/agt2/store/インスタンス名/import/

注

論理ホストで運用する場合のデフォルトの保存先については，「/opt/jp1pc」を「環境ディレクトリ/jp1pc」に読み替えてください。

注※

Storeバージョン2.0使用時だけ設定できます。

詳細については，「3.4.1　パフォーマンスデータの格納先の変更」を参照してください。

(7)　PFM - Agent for WebSphere Application Serverの接続先PFM - Managerの設定

PFM - Agentがインストールされているホストで，そのPFM - Agentを管理するPFM - Managerを設定します。接続先のPFM - Managerを設定するには，jpcconf mgrhost define (jpcnshostname)コマンドを使用します。

注意

同一ホスト上に，複数のPFM - Agentがインストールされている場合でも，接続先に指定できるPFM - Managerは，1つだけです。PFM - Agentごとに異なるPFM - Managerを接続先に設定することはできません。

PFM - AgentとPFM - Managerが同じホストにインストールされている場合，接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合，接続先のPFM - ManagerをほかのPFM - Managerに変更できません。

手順を次に示します。

Performance Managementのプログラムおよびサービスを停止する。
セットアップを実施する前に，ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。
jpcconf mgrhost define (jpcnshostname)コマンド実行時に，Performance Managementのプログラムおよびサービスが起動されている場合は，停止を問い合わせるメッセージが表示されます。

接続先のPFM - Managerホストのホスト名を指定して，jpcconf mgrhost define (jpcnshostname)コマンドを実行する。
例えば，接続先のPFM - Managerがホストhost01上にある場合，次のように指定します。

/opt/jp1pc/tools/jpcconf mgrhost define -host host01 (/opt/jp1pc/tools/jpcnshostname -s host01)

ここでは，対話形式の実行例を示していますが，jpcconf mgrhost defineコマンドは非対話形式でも実行できます。jpcconf mgrhost defineコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

(8)　動作ログ出力の設定[図データ]

アラーム発生時に動作ログを出力したい場合に必要な設定です。動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。

設定方法については，「付録I　動作ログの出力」を参照してください。

3.2　アンインストールとアンセットアップ

ここでは，PFM - Agent for WebSphere Application Serverをアンインストールおよびアンセットアップする手順について説明します。

＜この節の構成＞

3.2.1　アンインストールとアンセットアップの前に

3.2.2　アンセットアップ手順

3.2.3　アンインストール手順

3.2.1　アンインストールとアンセットアップの前に

PFM - Agent for WebSphere Application Serverをアンインストールおよびアンセットアップするときの注意事項を次に示します。

＜この項の構成＞

(1)　アンインストールに必要なOSユーザー権限に関する注意事項

(2)　ネットワークに関する注意事項

(3)　プログラムに関する注意事項

(4)　サービスに関する注意事項

(5)　その他の注意事項

(1)　アンインストールに必要なOSユーザー権限に関する注意事項

PFM - Agentをアンインストールするときは，必ず，スーパーユーザー権限を持つアカウントで実行してください。

(2)　ネットワークに関する注意事項

Performance Managementプログラムをアンインストールしても，servicesファイルに定義されたポート番号は削除されません。

(3)　プログラムに関する注意事項

Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラムを起動したままアンインストールした場合，ファイルやディレクトリが残ることがあります。この場合は，手動でインストール先ディレクトリ以下をすべて削除してください。

PFM - BaseとPFM - Agentがインストールされているホストの場合，PFM - BaseのアンインストールはPFM - Agentをアンインストールしないと実行できません。この場合，PFM - Agent，PFM - Baseの順にアンインストールしてください。また，PFM - ManagerとPFM - Agentがインストールされているホストの場合も同様に，PFM - ManagerのアンインストールはPFM - Agentをアンインストールしないと実行できません。この場合，PFM - Agent，PFM - Managerの順にアンインストールしてください。

(4)　サービスに関する注意事項

PFM - Agentをアンインストールしただけでは，jpctool service list (jpcctrl list)コマンドで表示できるサービスの情報は削除されません。この場合，PFM - Managerがインストールされているホストでjpctool service deleteコマンドを使用してサービスの情報を削除してください。PFM - Web Consoleホストにサービス情報の削除を反映するためには，jpctool service syncコマンドを実行して，PFM - Manager ホストとPFM - Web Consoleホストのエージェント情報を同期する必要があります。

サービス情報の削除方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップの章のサービスの削除について説明している個所を参照してください。

(5)　その他の注意事項

PFM - Web Consoleがインストールされているホストから，Performance Managementプログラムをアンインストールする場合は，Webブラウザの画面をすべて閉じてからアンインストールを実施してください。

3.2.2　アンセットアップ手順

ここでは，PFM - Agent for WebSphere Application Serverをアンセットアップする手順について説明します。

＜この項の構成＞

(1)　インスタンス環境のアンセットアップ

(1)　インスタンス環境のアンセットアップ

PFM - Agent for WebSphere Application Serverのアンセットアップでは，インスタンス環境の削除を実施します。複数のインスタンス環境をアンセットアップする場合は，繰り返し実施します。

(a)　インスタンス環境を削除する

インスタンス名を確認し，インスタンス環境を削除します。インスタンス環境の削除は，PFM - Agentホストで実施します。

インスタンス名を確認するには，jpcconf inst list (jpcinslist)コマンドを使用します。また，構築したインスタンス環境を削除するには，jpcconf inst unsetup (jpcinsunsetup)コマンドを使用します。

インスタンス環境を削除する手順を次に示します。

インスタンス名を確認する。
PFM - Agent for WebSphere Application Serverを示すサービスキーを指定して，jpcconf inst list (jpcinslist)コマンドを実行します。

/opt/jp1pc/tools/jpcconf inst list -key WAS (/opt/jp1pc/tools/jpcinslist agt2)

設定されているインスタンス名がAPSVの場合，APSVと表示されます。

インスタンス環境のPFM - Agentのサービスが起動されている場合は，停止する。
サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

インスタンス環境を削除する。
PFM - Agent for WebSphere Application Serverを示すサービスキーおよびインスタンス名を指定して，jpcconf inst unsetup (jpcinsunsetup)コマンドを実行します。
設定されているインスタンス名がAPSVの場合，次のように指定します。

/opt/jp1pc/tools/jpcconf inst unsetup -key WAS -inst APSV (/opt/jp1pc/tools/jpcinsunsetup agt2 -inst APSV)

jpcconf inst unsetup (jpcinsunsetup)コマンドが正常終了すると，インスタンス環境として構築されたディレクトリ，およびサービスIDが削除されます。

注意

インスタンス環境をアンセットアップしても，jpctool service list (jpcctrl list)コマンドで表示できるサービスの情報は削除されません。この場合，jpctool service delete (jpcctrl delete)コマンドを使用してサービスの情報を削除してください。

PFM - Web Consoleホストにインスタンス環境の削除を反映するためには，jpctool service syncコマンドを実行して，PFM - Manager ホストとPFM - Web Consoleホストのエージェント情報を同期する必要があります。

次に指定例を示します。

インスタンス名：APSV

ホスト名：host01

Agent CollectorサービスのサービスID：2A1APSV[host01]

Agent StoreサービスのサービスID：2S1APSV[host01]

/opt/jp1pc/tools/jpctool service delete -id 2?1APSV[host01] -host host01 (/opt/jp1pc/tools/jpcctrl delete 2?1APSV[host01] host=host01)

コマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

3.2.3　アンインストール手順

PFM - Agent for WebSphere Application Serverをアンインストールする手順を説明します。

Performance Managementのプログラムをアンインストールするホストに，スーパーユーザーでログインするかまたはsuコマンドでユーザーをスーパーユーザーに変更する。

ローカルホストでPerformance Managementのプログラムおよびサービスを停止する。
サービス情報を表示して，サービスが起動されていないか確認してください。ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。なお，停止するサービスは物理ホスト上および論理ホスト上のすべてのサービスです。サービス情報の表示方法およびサービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup

Hitachi PP Installerが起動され，初期画面が表示されます。

初期画面で「D」を入力する。
アンインストールできるプログラムの一覧が表示されます。

「JP1/PFM - Agent Option for WAS」を選択して，「D」を入力する。
選択したプログラムがアンインストールされます。なお，プログラムを選択するには，カーソルを移動させ，スペースキーで選択します。

アンインストールが正常終了したら，「Q」を入力する。
Hitachi PP Installerの初期画面に戻ります。

3.3　PFM - Agent for WebSphere Application Serverのシステム構成の変更

監視対象システムのネットワーク構成の変更や，ホスト名の変更などに応じて，PFM - Agent for WebSphere Application Serverのシステム構成を変更する場合があります。

PFM - Agent for WebSphere Application Serverのシステム構成を変更する場合，PFM - ManagerやPFM - Web Consoleの設定変更もあわせて行う必要があります。Performance Managementのシステム構成を変更する手順の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。なお，物理ホスト名またはエイリアス名を変更するときに，固有の追加作業が必要なPFM - Agentもありますが，PFM - Agent for WebSphere Application Serverの場合，固有の追加作業は必要ありません。

3.4　PFM - Agent for WebSphere Application Serverの運用方式の変更

収集した稼働監視データの運用手順の変更などで，パフォーマンスデータの格納先やインスタンス環境といった，PFM - Agent for WebSphere Application Serverの運用方式を変更する場合があります。

ここでは，PFM - Agent for WebSphere Application Serverの運用方式を変更する手順について説明します。Performance Management全体の運用方式を変更する手順の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

＜この節の構成＞

3.4.1　パフォーマンスデータの格納先の変更

3.4.2　インスタンス環境の更新の設定

3.4.3　Storeバージョン2.0への移行

3.4.1　パフォーマンスデータの格納先の変更

PFM - Agent for WebSphere Application Serverで収集したパフォーマンスデータは，PFM - Agent for WebSphere Application ServerのAgent StoreサービスのStoreデータベースで管理しています。

Storeデータベースで管理されるパフォーマンスデータの，次のデータ格納先ディレクトリを変更したい場合は，jpcconf db define (jpcdbctrl config)コマンドで設定します。Storeデータベースの格納先ディレクトリを変更する前に収集したパフォーマンスデータが必要な場合は，jpcconf db define (jpcdbctrl config)コマンドの-moveオプションを使用してください。jpcconf db define (jpcdbctrl config)コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

保存先ディレクトリ

バックアップ先ディレクトリ

部分バックアップ先ディレクトリ※

エクスポート先ディレクトリ

インポート先ディレクトリ※

注※

Storeバージョン2.0使用時だけ設定できます。

jpcconf db define (jpcdbctrl config)コマンドで設定するオプション名，設定できる値の範囲などを次の表に示します。

表3-6　パフォーマンスデータの格納先を変更するコマンドの設定項目

説明 | オプション名 | 設定できる値（Storeバージョン1.0）※1 | 設定できる値（Storeバージョン2.0）※1 | デフォルト値※2
パフォーマンスデータの保存先ディレクトリ | sd | 1～127バイトのディレクトリ名 | 1～214バイトのディレクトリ名 | /opt/jp1pc/agt2/store/インスタンス名
パフォーマンスデータのバックアップ先ディレクトリ | bd | 1～127バイトのディレクトリ名 | 1～211バイトのディレクトリ名 | /opt/jp1pc/agt2/store/インスタンス名/backup
パフォーマンスデータの部分バックアップ先ディレクトリ | pbd | － | 1～214バイトのディレクトリ名 | /opt/jp1pc/agt2/store/インスタンス名/partial
パフォーマンスデータをバックアップする場合の最大世代番号 | bs | 1～9 | 1～9 | 5
パフォーマンスデータのエクスポート先ディレクトリ | dd | 1～127バイトのディレクトリ名 | 1～127バイトのディレクトリ名 | /opt/jp1pc/agt2/store/インスタンス名/dump
パフォーマンスデータのインポート先ディレクトリ | id | － | 1～222バイトのディレクトリ名 | /opt/jp1pc/agt2/store/インスタンス名/import

（凡例）

－：設定できません。

注※1

ディレクトリ名は，Storeデータベースのデフォルト格納先ディレクトリ（/opt/jp1pc/agtc/store/インスタンス名）からの相対パスか，または絶対パスで指定してください。

注※2

論理ホストで運用する場合のデフォルト値については，「/opt/jp1pc」を「環境ディレクトリ/jp1pc」に読み替えてください。

なお，Storeバージョン1.0使用時は，jpcsto.iniファイルを直接編集して変更できます。jpcsto.iniファイルを編集する方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

3.4.2　インスタンス環境の更新の設定

インスタンス環境を更新したい場合は，インスタンス名を確認し，インスタンス情報を更新します。インスタンス情報の更新は，PFM - Agentホストで実施します。

更新する情報は，表3-4であらかじめ確認してください。

インスタンス名を確認するには，jpcconf inst list (jpcinslist)コマンドを使用します。また，インスタンス環境を更新するには，jpcconf inst setup (jpcinssetup)コマンドを使用します。コマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

インスタンス環境を更新する手順を次に示します。複数のインスタンス環境を更新する場合は，この手順を繰り返し実施します。

インスタンス名を確認する。
PFM - Agent for WebSphere Application Serverを示すサービスキーを指定して，jpcconf inst list (jpcinslist)コマンドを実行します。

/opt/jp1pc/tools/jpcconf inst list -key WAS (/opt/jp1pc/tools/jpcinslist agt2)

設定されているインスタンス名がAPSVの場合，APSVと表示されます。

更新したいインスタンス環境のPFM - Agent for WebSphere Application Serverのサービスが起動されている場合は，停止する。
サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。
jpcconf inst setup (jpcinssetup)コマンド実行時に，更新したいインスタンス環境のサービスが起動されている場合は，確認メッセージが表示され，サービスを停止できます。サービスを停止した場合は，更新処理が続行されます。サービスを停止しなかった場合は，更新処理が中断されます。

PFM - Agent for WebSphere Application Serverを示すサービスキーおよびインスタンス名を指定して，jpcconf inst setup (jpcinssetup)コマンドを実行する。
インスタンス名がAPSVのインスタンス環境を更新する場合，次のように指定してコマンドを実行します。

/opt/jp1pc/tools/jpcconf inst setup -key WAS -inst APSV (/opt/jp1pc/tools/jpcinssetup agt2 -inst APSV)

WebSphere Application Serverのインスタンス情報を更新する。
表3-4に示した項目を，コマンドの指示に従って入力します。現在設定されている値が表示されます。表示された値を変更しない場合は，リターンキーだけを押してください。すべての入力が終了すると，インスタンス環境が更新されます。

更新したインスタンス環境のサービスを再起動する。
サービスの起動方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

3.4.3　Storeバージョン2.0への移行

Storeデータベースの保存形式には，バージョン1.0と2.0の2種類あります。Storeバージョン2.0の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」を参照してください。

Storeバージョン2.0は，PFM - BaseまたはPFM - Managerのバージョン08-10以降の環境に，08-10以降のPFM - Agent for WebSphere Application Serverを新規インストールした場合にデフォルトで利用できます。それ以外の場合は，Storeバージョン1.0形式のままとなっているため，セットアップコマンドによってStoreバージョン2.0に移行してください。

何らかの理由によってStoreバージョン1.0に戻す必要がある場合は，Storeバージョン2.0のアンセットアップを行ってください。

インストール条件に対応するStoreバージョン2.0の利用可否と利用手順を次の表に示します。

表3-7　Storeバージョン2.0の利用可否および利用手順

インストール条件 | Storeバージョン2.0の利用可否 | Storeバージョン2.0の利用手順
インストール済みのPFM - Base，またはPFM - Managerのバージョン | PFM - Agentのインストール方法
08-10より前 | 上書きインストール | 利用できない | PFM - Base，または，PFM - Managerを08-10以降にバージョンアップ後，セットアップコマンドを実行
新規インストール
08-10以降 | 上書きインストール | 既存のインスタンスについてはセットアップ後利用できる | セットアップコマンドを実行
新規インスタンスについては利用できる | インスタンス構築時にjpcconf inst setup (jpcinssetup)コマンドで設定
新規インストール | 利用できる | インスタンス構築時にjpcconf inst setup (jpcinssetup)コマンドで設定

＜この項の構成＞

(1)　Storeバージョン2.0のセットアップ

(2)　Storeバージョン2.0のアンセットアップ

(3)　注意事項

(1)　Storeバージョン2.0のセットアップ

Storeバージョン2.0へ移行する場合のセットアップ手順について説明します。

システムリソース見積もりと保存期間の設計
Storeバージョン2.0導入に必要なシステムリソースが，実行環境に適しているかどうかを確認してください。必要なシステムリソースを次に示します。

ディスク容量

ファイル数

1プロセスがオープンするファイル数

これらの値は保存期間の設定によって調節できます。実行環境の保有しているリソースを考慮して保存期間を設計してください。システムリソースの見積もりについては，「付録A　システム見積もり」を参照してください。

ディレクトリの設定
Storeバージョン2.0に移行する場合に，Storeバージョン1.0でのディレクトリ設定では，Agent Storeサービスが起動しないことがあります。このため，Agent Storeサービスが使用するディレクトリの設定を見直す必要があります。Agent Storeサービスが使用するディレクトリの設定はjpcconf db define (jpcdbctrl config)コマンドを使用して表示・変更できます。
Storeバージョン2.0は，Storeデータベースの保存先ディレクトリやバックアップ先ディレクトリの最大長がStoreバージョン1.0と異なります。Storeバージョン1.0でディレクトリの設定を相対パスに変更している場合，絶対パスに変換した値がStoreバージョン2.0でのディレクトリ最大長の条件を満たしているか確認してください。Storeバージョン2.0のディレクトリ最大長は214バイトです。ディレクトリ最大長の条件を満たしていない場合は，Agent Storeサービスが使用するディレクトリの設定を変更したあと，手順3以降に進んでください。

セットアップコマンドの実行
Storeバージョン2.0に移行するため，次のコマンドを実行します。

/opt/jp1pc/tools/jpcconf db vrset -ver 2.0 -key WAS (/opt/jp1pc/tools/jpcdbctrl setup -key agt2)

jpcconf db vrset (jpcdbctrl setup)コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

保存期間の設定
手順1の見積もり時に設計した保存期間を設定してください。Agent Storeサービスを起動して，PFM - Web Consoleで設定してください。

(2)　Storeバージョン2.0のアンセットアップ

Storeバージョン2.0はjpcconf db vrset -ver 1.0 (jpcdbctrl unsetup)コマンドを使用してアンセットアップします。Storeバージョン2.0をアンセットアップすると，Storeデータベースのデータはすべて初期化され，Storeバージョン1.0に戻ります。

jpcconf db vrset (jpcdbctrl unsetup)コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」を参照してください。

(3)　注意事項

移行についての注意事項を次に示します。

(a)　Storeバージョン1.0からStoreバージョン2.0に移行する場合

StoreデータベースをStoreバージョン1.0からStoreバージョン2.0に移行した場合，PIレコードタイプのレコードの保存期間の設定は引き継がれますが，PDレコードタイプのレコードについては，以前の設定値（保存レコード数）に関係なくデフォルトの保存日数がレコードごとに設定され，保存日数以前に収集されたデータは削除されます。

例えば，Storeバージョン1.0で，Collection Intervalが3,600秒のPDレコードの保存レコード数を1,000に設定していた場合，PDレコードは1日に24レコード保存されることになるので，1,000÷24≒約42日分のデータが保存されています。このStoreデータベースをStoreバージョン2.0へ移行した結果，デフォルト保存日数が10日に設定されたとすると，11日以上前のデータは削除されて参照できなくなります。

Storeバージョン2.0へ移行する前に，PDレコードタイプのレコードの保存レコード数の設定を確認し，Storeバージョン2.0でのデフォルト保存日数以上のデータが保存される設定となっている場合は，jpctool db dump (jpcctrl dump)コマンドでデータベース内のデータを出力してください。Storeバージョン2.0でのデフォルト保存日数については，リリースノートを参照してください。

(b)　Storeバージョン2.0からStoreバージョン1.0に戻す場合

Storeバージョン2.0をアンセットアップすると，データは初期化されます。このため，Storeバージョン1.0に変更する前に，jpctool db dump (jpcctrl dump)コマンドでStoreバージョン2.0の情報を出力してください。

3.5　バックアップとリストア

PFM - Agent for WebSphere Application Serverのバックアップおよびリストアについて説明します。

障害が発生してシステムが壊れた場合に備えて，PFM - Agent for WebSphere Application Serverの設定情報のバックアップを取得してください。また，PFM - Agent for WebSphere Application Serverをセットアップしたときなど，システムを変更した場合にもバックアップを取得してください。

なお，PFM - Agent for WebSphere Application Serverシステム全体のバックアップおよびリストアについては，マニュアル「JP1/Performance Management 運用ガイド」の，バックアップとリストアについて説明している章を参照してください。

＜この節の構成＞

3.5.1　バックアップ

3.5.2　リストア

3.5.1　バックアップ

バックアップはファイルをコピーするなど，任意の方法で取得してください。バックアップを取得する際は，PFM - Agent for WebSphere Application Serverのサービスを停止した状態で行ってください。

注意

PFM - Agent for WebSphere Application Serverのバックアップを取得する際は，取得した環境の製品バージョン番号を管理するようにしてください。製品バージョン番号の詳細については，リリースノートを参照してください。

PFM - Agent for WebSphere Application Serverの設定情報のバックアップ対象ファイルを次の表に示します。

表3-8　 PFM - Agent for WebSphere Application Serverのバックアップ対象ファイル（UNIXの場合）

ファイル名 | 説明
/opt/jp1pc/agt2/agent/インスタンス名※/*.ini | Agent Collectorサービスの設定ファイル
/opt/jp1pc/agt2/store/インスタンス名※/*.ini | Agent Storeサービスの設定ファイル

注※

これらのディレクトリは，インスタンスの数と同じ数だけ作成されます。

3.5.2　リストア

PFM - Agent for WebSphere Application Serverの設定情報をリストアする場合は，次に示す前提条件を確認した上で，バックアップ対象ファイルを元の位置にコピーしてください。バックアップした設定情報ファイルで，ホスト上の設定情報ファイルを上書きします。

前提条件

PFM - Agent for WebSphere Application Serverがインストール済みであること。

PFM - Agent for WebSphere Application Serverのサービスが停止していること。

システム構成がバックアップしたときと同じであること。

それぞれのホストで，バックアップしたホスト名とリストアするホスト名が一致していること。

バックアップ環境のPFM製品構成情報がリストア対象のPFM製品構成情報と一致していること。

注意

PFM - Agent for WebSphere Application Serverの設定情報をリストアする場合，バックアップを取得した環境とリストアする環境の製品バージョン番号が完全に一致している必要があります。製品バージョン番号の詳細については，リリースノートを参照してください。

3.6　Webブラウザでマニュアルを参照するための設定

Performance Managementでは，PFM - Web Consoleがインストールされているホストに，プログラムプロダクトに標準添付されているマニュアルCD-ROMからマニュアルをコピーすることで，Webブラウザでマニュアルを参照できるようになります。なお，PFM - Web Consoleをクラスタ運用している場合は，実行系，待機系それぞれの物理ホストでマニュアルをコピーしてください。

＜この節の構成＞

3.6.1　設定手順

3.6.2　参照手順

3.6.1　設定手順

＜この項の構成＞

(1)　PFM - Web Consoleのヘルプからマニュアルを参照する場合

(2)　お使いのマシンのハードディスクからマニュアルを参照する場合

(1)　PFM - Web Consoleのヘルプからマニュアルを参照する場合

PFM - Web Consoleのセットアップ手順に従い，PFM - Web ConsoleにPFM - Agentを登録する（PFM - Agentの追加セットアップを行う）。

PFM - Web Consoleがインストールされているホストに，マニュアルのコピー先ディレクトリを作成する。

Windowsの場合：Web Consoleのインストール先フォルダ¥doc¥ja¥××××

UNIXの場合：/opt/jp1pcwebcon/doc/ja/××××

××××には，PFM - AgentのヘルプIDを指定してください。ヘルプIDについては，「付録C　識別子一覧」を参照してください。

手順2で作成したディレクトリの直下に，マニュアルCD-ROMから次のファイルおよびディレクトリをコピーする。

HTMLマニュアルの場合

Windowsの場合：CD-ROMドライブ¥MAN¥3021¥資料番号（03004A0Dなど）下の，すべてのhtmファイルおよびFIGUREフォルダ

UNIXの場合：/CD-ROMのマウントポイント/MAN/3021/資料番号（03004A0Dなど）下の，すべてのhtmファイルおよびFIGUREディレクトリ

PDFマニュアルの場合

Windowsの場合：CD-ROMドライブ¥MAN¥3021¥資料番号（03004A0Dなど）下のPDFファイル

UNIXの場合：/CD-ROMのマウントポイント/MAN/3021/資料番号（03004A0Dなど）下のPDFファイル

コピーの際，HTMLマニュアルの場合はindex.htmファイルが，PDFマニュアルの場合はPDFファイル自体が，作成したディレクトリ直下に配置されるようにしてください。マニュアルファイルのコピー方法については，マニュアルCD-ROMのreadme.txtを参照してください。

PFM - Web Consoleを再起動する。

(2)　お使いのマシンのハードディスクからマニュアルを参照する場合

CD-ROMのsetup.exeを使ってインストールするかまたは直接htmファイル，PDFファイル，およびGIFファイルを任意のディレクトリにコピーしてください。HTMLマニュアルの場合，次のディレクトリ構成になるようにしてください。

html（htmファイルおよびPDFファイルを格納）
└FIGURE（GIFファイルを格納）

3.6.2　参照手順

マニュアルの参照手順を次に示します。

PFM - Web Consoleの［メイン］画面のメニューバーフレームにある［ヘルプ］メニューをクリックし，［ヘルプ選択］画面を表示する。

マニュアル名またはマニュアル名の後ろの［PDF］をクリックする。
マニュアル名をクリックするとHTML形式のマニュアルが表示されます。［PDF］をクリックするとPDF形式のマニュアルが表示されます。

Webブラウザでの文字の表示に関する注意事項

Windowsの場合，［スタート］メニューからオンラインマニュアルを表示させると，すでに表示されているWebブラウザの画面上にHTMLマニュアルが表示されることがあります。

また，Internet Explorer 5を使用している場合，文字が不正に表示されることがあります。この場合，次のように設定してください。

［表示］－［エンコード］の［自動選択］のチェックを外す。

［表示］－［エンコード］の日本語で［日本語（シフトJIS）］を選択する。

4.　クラスタシステムでの運用

この章では，クラスタシステムでPFM - Agent for WebSphere Application Serverを運用する場合のインストール，セットアップ，クラスタシステムでPFM - Agent for WebSphere Application Serverを運用しているときの処理の流れなどについて説明します。

＜この章の構成＞

4.1　クラスタシステムの概要

4.2　フェールオーバー時の処理

4.3　インストールとセットアップ（Windowsの場合）

4.4　インストールとセットアップ（UNIXの場合）

4.5　アンインストールとアンセットアップ（Windowsの場合）

4.6　アンインストールとアンセットアップ（UNIXの場合）

4.7　PFM - Agent for WebSphere Application Serverのシステム構成の変更

4.8　PFM - Agent for WebSphere Application Serverの運用方式の変更

4.1　クラスタシステムの概要

クラスタシステムとは，複数のサーバシステムを連携して1つのシステムとして運用するシステムです。PFM - Agent for WebSphere Application Serverの監視対象プログラムであるWebSphere Application Serverは，次のクラスタシステムで運用できます。

HA（High Availability）クラスタシステム構成のWebSphere Application Server

ここでは，クラスタシステムでPFM - Agent for WebSphere Application Serverを運用する場合の構成について説明します。クラスタシステムの概要およびPerformance Managementシステムをクラスタシステムで運用する場合のシステム構成については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

なお，この章で，単に「クラスタシステム」と記述している場合は，HAクラスタシステムのことを指します。

＜この節の構成＞

4.1.1　HAクラスタシステム

4.1.1　HAクラスタシステム

＜この項の構成＞

(1)　HAクラスタシステムでのPFM - Agent for WebSphere Application Serverの構成

(1)　HAクラスタシステムでのPFM - Agent for WebSphere Application Serverの構成

PFM - Agent for WebSphere Application Serverは，HAクラスタシステムで運用でき，クラスタ構成のWebSphere Application Serverを監視できます。HAクラスタシステムでPFM - Agent for WebSphere Application Serverを運用する場合は，次の図のような構成で運用します。

図4-1　HAクラスタシステムでのPFM - Agent for WebSphere Application Serverの構成例

図4-1に示すように，PFM - Agent for WebSphere Application Serverはクラスタ構成のWebSphere Application Serverと同じ論理ホスト環境で動作し，WebSphere Application Serverを監視します。障害発生時はWebSphere Application Serverのフェールオーバーに連動してPFM - Agent for WebSphere Application Serverもフェールオーバーし，監視を継続できます。

また，共有ディスクに定義情報やパフォーマンス情報を格納し，フェールオーバー時に引き継ぎます。1つの論理ホストに複数のPerformance Managementのプログラムがある場合は，それぞれが同じ共有ディレクトリを使います。

1つのノードでPFM - Agent for WebSphere Application Serverを複数実行できます。

クラスタ構成のWebSphere Application Serverが複数ある構成（アクティブ・アクティブ構成）の場合，それぞれの論理ホスト環境でPFM - Agent for WebSphere Application Serverを実行してください。それぞれのPFM - Agent for WebSphere Application Serverは独立して動作し，別々にフェールオーバーできます。

4.2　フェールオーバー時の処理

実行系ホストに障害が発生すると，処理が待機系ホストに移ります。

ここでは，PFM - Agentホストに障害が発生した場合のフェールオーバー時の処理について説明します。また，PFM - Managerに障害が発生した場合の，PFM - Agent for WebSphere Application Serverへの影響について説明します。

＜この節の構成＞

4.2.1　PFM - Agentホストに障害が発生した場合のフェールオーバー

4.2.2　PFM - Managerが停止した場合の影響

4.2.1　PFM - Agentホストに障害が発生した場合のフェールオーバー

PFM - Agent for WebSphere Application Serverを実行しているPFM - Agentホストでフェールオーバーが発生した場合の処理を次の図に示します。

図4-2　PFM - Agentホストでフェールオーバーが発生した場合の処理

PFM - Agent for WebSphere Application Serverのフェールオーバー中に，PFM - Web Consoleで操作すると，「There was no answer(-6)」というメッセージが表示されます。この場合は，フェールオーバーが完了するまで待ってから操作してください。

PFM - Agent for WebSphere Application Serverのフェールオーバー後に，PFM - Web Consoleで操作すると，フェールオーバー先のノードで起動したPFM - Agent for WebSphere Application Serverに接続されます。

4.2.2　PFM - Managerが停止した場合の影響

PFM - Managerが停止すると，Performance Managementシステム全体に影響があります。

PFM - Managerは，各ノードで動作しているPFM - Agent for WebSphere Application Serverのエージェント情報を一括管理しています。また，PFM - Agent for WebSphere Application Serverがパフォーマンス監視中にしきい値を超えた場合のアラームイベントの通知や，アラームイベントを契機としたアクションの実行を制御しています。このため，PFM - Managerが停止すると，Performance Managementシステムに次の表に示す影響があります。

表4-1　PFM - Managerが停止した場合のPFM - Agent for WebSphere Application Serverへの影響

プログラム名
影響
対処

PFM - Agent for WebSphere Application Server
PFM - Agent for WebSphere Application Serverの動作中にPFM - Managerが停止した場合，次のように動作する。

パフォーマンスデータは継続して収集される。

発生したアラームイベントをPFM - Managerに通知できないため，アラーム定義ごとにアラームイベントが保持され，PFM - Managerが起動するまで通知をリトライする。保持しているアラームイベントが3つを超えると，古いアラームイベントは上書きされる。また，PFM - Agent for WebSphere Application Serverを停止すると，保持しているアラームイベントは削除される。

PFM - Managerに通知済みのアラームステータスは，PFM - Managerが再起動したときに一度リセットされる。その後，PFM - ManagerがPFM - Agent for WebSphere Application Serverの状態を確認したあと，アラームステータスは最新の状態になる。

PFM - Agent for WebSphere Application Serverを停止しようとした場合，PFM - Managerに停止することを通知できないため，停止に時間が掛かる。

PFM - Managerを起動する。
動作中のPFM - Agent for WebSphere Application Serverはそのまま運用できる。ただし，アラームが期待したとおりに通知されない場合があるため，PFM - Manager復旧後に，共通メッセージログに出力されているメッセージKAVE00024-Iを確認すること。

PFM - Managerが停止した場合の影響を考慮の上，運用方法を検討してください。なお，トラブル以外にも，構成変更やメンテナンスの作業などでPFM - Managerの停止が必要になる場合もあります。運用への影響が少ないときに，メンテナンスをすることをお勧めします。

4.3　インストールとセットアップ（Windowsの場合）

ここでは，クラスタシステムでのPFM - Agent for WebSphere Application Serverのインストールとセットアップの手順について説明します。

なお，PFM - Managerのインストールとセットアップの手順については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

＜この節の構成＞

4.3.1　インストールとセットアップの流れ

4.3.2　インストールとセットアップの前に

4.3.3　インストール手順

4.3.4　セットアップ手順

4.3.1　インストールとセットアップの流れ

クラスタシステムで，論理ホスト運用するPFM - Agent for WebSphere Application Serverのインストールおよびセットアップの流れを次の図に示します。

図4-3　クラスタシステムで論理ホスト運用するPFM - Agent for WebSphere Application Serverのインストールおよびセットアップの流れ（Windowsの場合）

注意

論理ホスト環境のPFM - Agentをセットアップしても，物理ホスト環境のPFM - Agentの定義内容は引き継がれません。論理ホスト環境および物理ホスト環境では，インスタンス環境を設定した時点で，新規に環境が作成されます。

4.3.2　インストールとセットアップの前に

インストールおよびセットアップを開始する前の前提条件，必要な情報，および注意事項について説明します。

＜この項の構成＞

(1)　前提条件

(2)　論理ホスト運用するPFM - Agent for WebSphere Application Serverのセットアップに必要な情報

(3)　PFM - Agent for WebSphere Application Serverで論理ホストをフェールオーバーさせる場合の注意事項

(4)　論理ホスト運用時のバージョンアップに関する注意事項

(1)　前提条件

PFM - Agent for WebSphere Application Serverをクラスタシステムで使用する場合，次に示す前提条件があります。

(a)　クラスタシステム

次の条件が整っていることを確認してください。

クラスタシステムがクラスタソフトによって制御されていること。

クラスタソフトが論理ホスト運用するPFM - Agent for WebSphere Application Serverの起動や停止などを制御するように設定されていること。このとき，PFM - Agent for WebSphere Application Serverが，監視対象のWebSphere Application Serverと連動してフェールオーバーするように設定されていること。

注意

ワトソン博士でアプリケーションエラーのメッセージボックスが表示されると，フェールオーバーできないおそれがあるため，メッセージボックスによるエラーの通知を抑止する必要があります。抑止手順については，OSのマニュアルを参照してください。なお，エラーの通知を抑止すると，アプリケーションエラーが発生した際の情報取得に影響が出る場合があるため注意してください。

Windows Server 2003およびWindows Server 2008では，アプリケーションエラーが発生すると，Microsoftへエラーを報告するダイアログボックスが表示されます。このダイアログボックスが表示されるとフェールオーバーできないおそれがあるため，エラー報告を抑止する必要があります。抑止手順については，OSのマニュアルを参照してください。

(b)　共有ディスク

次の条件が整っていることを確認してください。

論理ホストごとに共有ディスクがあり，実行系ノードから待機系ノードへ引き継げること。

共有ディスクが，各ノードに物理的にFibre ChannelやSCSIで接続されていること。
Performance Managementでは，ネットワークドライブや，ネットワーク経由でレプリケーションしたディスクを共有ディスクとして使う構成はサポートされていません。

フェールオーバーの際に，何らかの問題によって共有ディスクを使用中のプロセスが残った場合でも，クラスタソフトなどの制御によって強制的に共有ディスクをオフラインにしてフェールオーバーできること。

1つの論理ホストで複数のPFM製品を運用する場合，共有ディスクのディレクトリ名が同じであること。
なお，Storeデータベースについては格納先を変更して，共有ディスク上のほかのディレクトリに格納できます。

(c)　論理ホスト名，論理IPアドレス

次の条件が整っていることを確認してください。

論理ホストごとに論理ホスト名，および論理ホスト名と対応する論理IPアドレスがあり，実行系ノードから待機系ノードに引き継げること。

論理ホスト名と論理IPアドレスが，hostsファイルやネームサーバに設定されていること。

DNS運用している場合は，FQDN名ではなく，ドメイン名を除いたホスト名を論理ホスト名として使用していること。

物理ホスト名と論理ホスト名は，システムの中でユニークであること。

注意

論理ホスト名に，物理ホスト名（hostnameコマンドで表示されるホスト名）を指定しないでください。正常に通信処理がされなくなるおそれがあります。

論理ホスト名に使用できる文字は，1～32バイトの半角英数字です。次の記号および空白文字は指定できません。
/ ¥ : ; * ? ' " < > | & = , .

論理ホスト名には，「localhost」，IPアドレス，「-」から始まるホスト名を指定できません。

(d)　IPv6を使用する場合の設定

PFM - ManagerとPFM - Agent for WebSphere Application ServerをIPv6で通信する場合，PFM - ManagerホストとPFM - AgentホストのそれぞれでIPv6の利用設定を有効にする必要があります。この設定はjpcconf ipv6 enableコマンドで実行しますが，コマンドの実行有無は次のとおりです。

jpcconf ipv6 enableコマンドの実行が必要なケース

それぞれのホストで，IPv4環境からIPv6環境に変更する場合

IPv4環境とIPv6環境が共存していて，PFM - ManagerをIPv4環境からIPv6環境に変更する場合

jpcconf ipv6 enableコマンドの実行が不要なケース

それぞれのホストが，すでにIPv6環境である場合

IPv4環境とIPv6環境が共存していて，PFM - ManagerがIPv6環境である場合

jpcconf ipv6 enableコマンドの実行例を次に示します。

インストール先フォルダ¥tools¥jpcconf ipv6 enable

jpcconf ipv6 enableコマンドは，実行系および待機系のそれぞれで実行してください。

jpcconf ipv6 enableコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。また，jpcconf ipv6 enableコマンドを実行する条件やタイミングについては，マニュアル「JP1/Performance Management 設計・構築ガイド」のIPv6環境が含まれる場合のネットワーク構成例について説明している章を参照してください。

(2)　論理ホスト運用するPFM - Agent for WebSphere Application Serverのセットアップに必要な情報

論理ホスト運用するPFM - Agent for WebSphere Application Serverをセットアップするには，通常のPFM - Agent for WebSphere Application Serverのセットアップで必要になる環境情報に加えて，次の表の情報が必要です。

表4-2　論理ホスト運用のPFM - Agent for WebSphere Application Serverのセットアップに必要な情報

項目 | 例
論理ホスト名 | jp1-hal2
論理IPアドレス | 172.16.92.100
共有ディスク | S:¥jp1

なお，1つの論理ホストで論理ホスト運用するPerformance Managementのプログラムが複数ある場合も，同じ共有ディスクのディレクトリを使用します。

共有ディスクに必要な容量については，「付録A システム見積もり」を参照してください。

(3)　PFM - Agent for WebSphere Application Serverで論理ホストをフェールオーバーさせる場合の注意事項

PFM - Agent for WebSphere Application Serverを論理ホスト運用するシステム構成の場合，PFM - Agent for WebSphere Application Serverの障害によって論理ホスト全体をフェールオーバーさせるかどうかを検討してください。

PFM - Agent for WebSphere Application Serverの障害で論理ホスト全体をフェールオーバーさせると，PFM - Agent for WebSphere Application Serverが監視対象としている同じ論理ホストで運用する業務アプリケーションもフェールオーバーすることになり，業務に影響を与えるおそれがあります。

通常は，PFM - Agent for WebSphere Application Serverに異常が発生しても，WebSphere Application Serverの動作に影響がないように，次のどちらかのようにクラスタソフトで設定することをお勧めします。

PFM - Agent for WebSphere Application Serverの動作監視をしない

PFM - Agent for WebSphere Application Serverの異常を検知してもフェールオーバーしない

(4)　論理ホスト運用時のバージョンアップに関する注意事項

論理ホスト運用のPFM - Agent for WebSphere Application Serverをバージョンアップする場合は，実行系ノードまたは待機系ノードのどちらか一方で，共有ディスクをオンラインにする必要があります。

4.3.3　インストール手順

実行系ノードおよび待機系ノードにPFM - Agent for WebSphere Application Serverをインストールします。

注意

インストール先はローカルディスクです。共有ディスクにはインストールしないでください。

インストール手順は非クラスタシステムの場合と同じです。インストール手順については，「2.1.3 インストール手順」を参照してください。

4.3.4　セットアップ手順

ここでは，クラスタシステムで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)　クラスタシステムでの環境設定　

(1)　PFM - Agentの登録[図データ]　[図データ]　[図データ]

PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために，PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for WebSphere Application Serverを登録する必要があります。

PFM - Agent for WebSphere Application Serverを登録する必要があるのは次の場合です。

Performance Managementシステムに新しくPFM - Agent for WebSphere Application Serverを追加する場合

すでに登録しているPFM - Agent for WebSphere Application Serverのデータモデルのバージョンを更新する場合

登録はPFM - Manager上およびPFM - Web Console上で実施します。手順は非クラスタシステムの場合と同じです。

手順については，「2.1.4(1) PFM - Agent for WebSphere Application Serverの登録」を参照してください。

(2)　共有ディスクをオンラインにする[図データ]

共有ディスクがオンラインになっていることを確認します。共有ディスクがオンラインになっていない場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオンラインにしてください。

(3)　PFM - Agentの論理ホストのセットアップ[図データ]

jpcconf ha setup (jpchasetup create)コマンドを実行して論理ホスト環境を作成します。コマンドを実行すると，共有ディスクに必要なデータがコピーされ，論理ホスト用の定義が設定されて，論理ホスト環境が作成されます。

注意

コマンドを実行する前に，Performance Managementシステム全体で，Performance Managementのプログラムおよびサービスをすべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」のPerformance Managementの起動と停止について説明している章を参照してください。

手順を次に示します。

jpcconf ha setup (jpchasetup create)コマンドを実行して，PFM - Agent for WebSphere Application Serverの論理ホスト環境を作成する。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha setup -key WAS -lhost jp1-hal2 -d S:¥jp1 (インストール先フォルダ¥tools¥jpchasetup create agt2 -lhost jp1-hal2 -d S:¥jp1)

論理ホスト名は，-lhostオプションで指定します。ここでは，論理ホスト名をjp1-hal2としています。DNS運用をしている場合はドメイン名を省略した論理ホスト名を指定してください。
共有ディスクのディレクトリ名は，-dオプションの環境ディレクトリ名に指定します。例えば-d S:¥jp1と指定するとS:¥jp1¥jp1pcが作成されて，論理ホスト環境のファイルが作成されます。

jpcconf ha list (jpchasetup list)コマンドを実行して，論理ホストの設定を確認する。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha list -key all (インストール先フォルダ¥tools¥jpchasetup list all)

作成した論理ホスト環境が正しいことを確認してください。

(4)　接続先PFM - Managerの設定[図データ]

jpcconf mgrhost define (jpcnshostname)コマンドを実行して，PFM - Agent for WebSphere Application Serverを管理するPFM - Managerを設定します。

jpcconf mgrhost define (jpcnshostname)コマンドを実行して，接続先PFM - Managerを設定する。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf mgrhost define -host jp1-hal -lhost jp1-hal2 (インストール先フォルダ¥tools¥jpcnshostname -s jp1-hal -lhost jp1-hal2)

接続先PFM - Managerのホスト名は，-hostオプションで指定します。接続先PFM - Managerが論理ホスト運用されている場合は，-hostオプションに接続先PFM - Managerの論理ホスト名を指定します。ここでは，PFM - Managerの論理ホスト名をjp1-halとしています。
また，PFM - Agent for WebSphere Application Serverの論理ホスト名は，-lhostオプションで指定します。ここでは，PFM - Agent for WebSphere Application Serverの論理ホスト名をjp1-hal2としています。

(5)　インスタンス環境の設定[図データ]

jpcconf inst setup (jpcinssetup)コマンドを実行して，PFM - Agent for WebSphere Application Serverのインスタンス環境を設定します。

設定手順は，非クラスタシステムの場合と同じです。ただし，クラスタシステムの場合，jpcconf inst setup (jpcinssetup)コマンドの実行時に，「-lhost」で論理ホスト名を指定する必要があります。

クラスタシステムの場合のjpcconf inst setup (jpcinssetup)コマンドの指定方法を次に示します。

インストール先フォルダ¥tools¥jpcconf inst setup -key WAS -lhost 論理ホスト名 -inst インスタンス名 (インストール先フォルダ¥tools¥jpcinssetup agt2 -lhost 論理ホスト名 -inst インスタンス名)

このほかの設定内容および手順については，「2.1.4(2) インスタンス環境の設定」を参照してください。

(6)　他Performance Managementプログラムの論理ホストのセットアップ[図データ]　[図データ]

PFM - Agent for WebSphere Application Serverのほかに，同じ論理ホストにセットアップするPFM - ManagerやPFM - Agentがある場合は，この段階でセットアップしてください。

セットアップ手順については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

(7)　ネットワークの設定[図データ]　[図データ]

Performance Managementを使用するネットワーク構成に応じて，変更する場合にだけ必要な設定です。

ネットワークの設定では次の2つの項目を設定できます。

IPアドレスを設定する
複数のLANに接続されたネットワーク環境でPerformance Managementを運用するときに使用するIPアドレスを指定したい場合には，jpchostsファイルの内容を直接編集します。
このとき，編集したjpchostsファイルは，実行系ノードから待機系ノードにコピーしてください。
IPアドレスの設定方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」のインストールとセットアップについて説明している章を参照してください。

ポート番号を設定する
ファイアウォール経由でPerformance Managementのプログラム間の通信をする場合には，jpcconf port (jpcnsconfig port)コマンドを使用してポート番号を設定します。
ポート番号の設定方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章，およびマニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

(8)　ログのファイルサイズ変更[図データ]　[図データ]

Performance Managementの稼働状況を，Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは，デフォルトで2,048キロバイトのファイルが2個使用されます。このファイルサイズを変更したい場合に必要な設定です。

詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

(9)　パフォーマンスデータの格納先の変更[図データ]　[図データ]

PFM - Agentで管理されるパフォーマンスデータを格納するデータベースの保存先，バックアップ先，エクスポート先，またはインポート先のフォルダを変更したい場合に必要な設定です。

設定方法については，「2.4.1　パフォーマンスデータの格納先の変更」を参照してください。

(10)　動作ログ出力の設定[図データ]　[図データ]

アラーム発生時に動作ログを出力したい場合に必要な設定です。動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。

設定方法については，「付録I　動作ログの出力」を参照してください。

(11)　論理ホスト環境定義ファイルのエクスポート[図データ]

PFM - Agent for WebSphere Application Serverの論理ホスト環境が作成できたら，環境定義をファイルにエクスポートします。エクスポートでは，その論理ホストにセットアップされているPerformance Managementのプログラムの定義情報を一括してファイル出力します。同じ論理ホストにほかのPerformance Managementのプログラムをセットアップする場合は，セットアップが一とおり済んだあとにエクスポートしてください。

手順を次に示します。

jpcconf ha export (jpchasetup export)コマンドを実行して，論理ホスト環境定義をエクスポートする。
これまでの手順で作成した論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha export -f lhostexp.txt (インストール先フォルダ¥tools¥jpchasetup export -f lhostexp.txt)

(12)　論理ホスト環境定義ファイルの待機系ノードへのコピー[図データ]　[図データ]

「(11) 論理ホスト環境定義ファイルのエクスポート」でエクスポートした論理ホスト環境定義ファイルを，実行系ノードから待機系ノードにコピーします。

(13)　共有ディスクをオフラインにする[図データ]　[図データ]

クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオフラインにして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，オフラインにする必要はありません。

(14)　論理ホスト環境定義ファイルのインポート[図データ]

実行系ノードからコピーしたエクスポートファイルを，待機系ノードにインポートします。

実行系ノードで作成した論理ホストのPerformance Managementのプログラムを，待機系ノードで実行するための設定には，jpcconf ha import (jpchasetup import)コマンドを使用します。1つの論理ホストに複数のPerformance Managementのプログラムがセットアップされている場合は，一括してインポートされます。

なお，このコマンドを実行するときには，共有ディスクをオンラインにしておく必要はありません。

手順を次に示します。

jpcconf ha import (jpchasetup import)コマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha import -f lhostexp.txt (インストール先フォルダ¥tools¥jpchasetup import -f lhostexp.txt)

コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for WebSphere Application Serverを起動するための設定が実施されます。
また，セットアップ時にjpcconf port (jpcnsconfig port)コマンドで固定のポート番号を設定している場合も，同様に設定されます。

jpcconf ha list (jpchasetup list)コマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha list -key all (インストール先フォルダ¥tools¥jpchasetup list all)

実行系ノードでjpcconf ha list (jpchasetup list)を実行したときと同じ内容が表示されることを確認してください。

(15)　クラスタソフトへのPFM - Agentの登録[図データ]　[図データ]

Performance Managementのプログラムを論理ホスト環境で運用する場合は，クラスタソフトに登録して，クラスタソフトからの制御でPerformance Managementのプログラムを起動したり停止したりするように環境設定します。

クラスタソフトへPFM - Agent for WebSphere Application Serverを登録する方法は，クラスタソフトのマニュアルを参照してください。

PFM - Agent for WebSphere Application Serverをクラスタソフトに登録するときの設定内容を，Windows MSCSに登録する項目を例として説明します。

PFM - Agent for WebSphere Application Serverの場合，次の表のサービスをクラスタソフトに登録します。

表4-3　クラスタソフトに登録するPFM - Agent for WebSphere Application Serverのサービス

項番
名前
サービス名
依存関係

1
PFM - Agent Store for WAS インスタンス名 [LHOST]
JP1PCAGT_2S_インスタンス名 [LHOST]
IPアドレスリソース
物理ディスクリソース

2
PFM - Agent for WAS インスタンス名 [LHOST]
JP1PCAGT_2A_インスタンス名 [LHOST]
項番1のクラスタリソース

3
PFM - Action Handler [LHOST]
JP1PCMGR_PH [LHOST]
IPアドレスリソース
物理ディスクリソース

[LHOST]の部分は，論理ホスト名に置き換えてください。

インスタンス名がAPSV，論理ホスト名がjp1-hal2の場合，サービスの名前は「PFM - Agent Store for WAS APSV [jp1-hal2]」，サービス名は「JP1PCAGT_2S_APSV [jp1-hal2]」のようになります。

MSCSの場合は，これらのサービスをMSCSのリソースとして登録します。各リソースの設定は次のようにします。下記の［　］は，MSCSで設定する項目です。

［リソースの種類］は「汎用サービス」として登録する。

［名前］，［サービス名］，および［依存関係］を表4-3のとおりに設定する。
なお，名前はサービスを表示するときの名称で，サービス名はMSCSから制御するサービスを指定するときの名称です。

［起動パラメータ］および［レジストリ複製］は設定しない。

プロパティの［詳細設定］タブは，Performance Managementのプログラムの障害時にフェールオーバーするかしないかの運用に合わせて設定する。
例えば，PFM - Agent for WebSphere Application Serverの障害時に，フェールオーバーするように設定するには，次のように設定します。
［再開する］：チェックする
［グループに適用する］：チェックしない
再起動試行回数の［しきい値］：3※

注※

再起動試行回数の［しきい値］は3回を目安に設定してください。

注意

クラスタソフトに登録するサービスは，クラスタソフトから起動および停止を制御しますので，OS起動時に自動起動しないよう［スタートアップの種類］を［手動］に設定してください。なお，jpcconf ha setup (jpchasetup create)コマンドでセットアップした直後のサービスは［手動］に設定されています。また，次のコマンドで強制停止しないでください。

インストール先フォルダ¥tools¥jpcspm stop -key all -lhost 論理ホスト名 -kill immediate (インストール先フォルダ¥tools¥jpcstop all lhost=論理ホスト名 kill=immediate)

(16)　クラスタソフトからの起動・停止の確認[図データ]　[図データ]

クラスタソフトからの操作で，Performance Managementのプログラムの起動および停止を各ノードで実行し，正常に動作することを確認してください。

(17)　クラスタシステムでの環境設定[図データ]　[図データ]

Performance Managementのプログラムのセットアップ終了後，PFM - Web Consoleから，運用に合わせて監視対象の稼働状況についてのレポートを表示できるようにしたり，監視対象で問題が発生したときにユーザーに通知できるようにしたりするために，Performance Managementのプログラムの環境を設定します。

Performance Managementのプログラムの環境設定方法については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

4.4　インストールとセットアップ（UNIXの場合）

ここでは，クラスタシステムでのPFM - Agent for WebSphere Application Serverのインストールとセットアップの手順について説明します。

なお，PFM - Managerのインストールとセットアップの手順については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

＜この節の構成＞

4.4.1　インストールとセットアップの流れ

4.4.2　インストールとセットアップの前に

4.4.3　インストール手順

4.4.4　セットアップ手順

4.4.1　インストールとセットアップの流れ

クラスタシステムで，論理ホスト運用するPFM - Agent for WebSphere Application Serverのインストールおよびセットアップの流れを次の図に示します。

図4-4　クラスタシステムで論理ホスト運用するPFM - Agent for WebSphere Application Serverのインストールおよびセットアップの流れ（UNIXの場合）

注意

論理ホスト環境のPFM - Agentをセットアップしても，物理ホスト環境のPFM - Agentの定義内容は引き継がれません。論理ホスト環境および物理ホスト環境では，インスタンス環境を設定した時点で，新規に環境が作成されます。

4.4.2　インストールとセットアップの前に

インストールおよびセットアップを開始する前の前提条件，必要な情報，および注意事項について説明します。

＜この項の構成＞

(1)　前提条件

(2)　論理ホスト運用するPFM - Agent for WebSphere Application Serverのセットアップに必要な情報

(3)　PFM - Agent for WebSphere Application Serverで論理ホストをフェールオーバーさせる場合の注意事項

(4)　論理ホスト運用時のバージョンアップに関する注意事項

(1)　前提条件

PFM - Agent for WebSphere Application Serverをクラスタシステムで使用する場合，次に示す前提条件があります。

(a)　クラスタシステム

次の条件が整っていることを確認してください。

クラスタシステムがクラスタソフトによって制御されていること。

クラスタソフトが論理ホスト運用するPFM - Agent for WebSphere Application Serverの起動や停止などを制御するように設定されていること。このとき，PFM - Agent for WebSphere Application Serverが，監視対象のWebSphere Application Serverと連動してフェールオーバーするように設定されていること。

(b)　共有ディスク

次の条件が整っていることを確認してください。

論理ホストごとに共有ディスクがあり，実行系ノードから待機系ノードへ引き継げること。

共有ディスクが，各ノードに物理的にFibre ChannelやSCSIで接続されていること。
Performance Managementでは，ネットワークドライブや，ネットワーク経由でレプリケーションしたディスクを共有ディスクとして使う構成はサポートされていません。

フェールオーバーの際に，何らかの問題によって共有ディスクを使用中のプロセスが残った場合でも，クラスタソフトなどの制御によって強制的に共有ディスクをアンマウントしてフェールオーバーできること。

1つの論理ホストで複数のPFM製品を運用する場合，共有ディスクのディレクトリ名が同じであること。
なお，Storeデータベースについては格納先を変更して，共有ディスク上のほかのディレクトリに格納できます。

(c)　論理ホスト名，論理IPアドレス

次の条件が整っていることを確認してください。

論理ホストごとに論理ホスト名，および論理ホスト名と対応する論理IPアドレスがあり，実行系ノードから待機系ノードに引き継げること。

論理ホスト名と論理IPアドレスが，hostsファイルやネームサーバに設定されていること。

DNS運用している場合は，FQDN名ではなく，ドメイン名を除いたホスト名を論理ホスト名として使用していること。

物理ホスト名と論理ホスト名は，システムの中でユニークであること。

注意

論理ホスト名に，物理ホスト名（uname -nコマンドで表示されるホスト名）を指定しないでください。正常に通信処理がされなくなるおそれがあります。

論理ホスト名に使用できる文字は，1～32バイトの半角英数字です。次の記号および空白文字は指定できません。
/ ¥ : ; * ? ' " < > | & = , .

論理ホスト名には，「localhost」，IPアドレス，「-」から始まるホスト名を指定できません。

(d)　IPv6を使用する場合の設定

PFM - ManagerとPFM - Agent for WebSphere Application ServerをIPv6で通信する場合，PFM - ManagerホストとPFM - AgentホストのそれぞれでIPv6の利用設定を有効にする必要があります。この設定はjpcconf ipv6 enableコマンドで実行しますが，コマンドの実行有無は次のとおりです。

jpcconf ipv6 enableコマンドの実行が必要なケース

それぞれのホストで，IPv4環境からIPv6環境に変更する場合

IPv4環境とIPv6環境が共存していて，PFM - ManagerをIPv4環境からIPv6環境に変更する場合

jpcconf ipv6 enableコマンドの実行が不要なケース

それぞれのホストが，すでにIPv6環境である場合

IPv4環境とIPv6環境が共存していて，PFM - ManagerがIPv6環境である場合

jpcconf ipv6 enableコマンドの実行例を次に示します。

/opt/jp1pc/tools/jpcconf ipv6 enable

jpcconf ipv6 enableコマンドは，実行系および待機系のそれぞれで実行してください。

jpcconf ipv6 enableコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。また，jpcconf ipv6 enableコマンドを実行する条件やタイミングについては，マニュアル「JP1/Performance Management 設計・構築ガイド」のIPv6環境が含まれる場合のネットワーク構成例について説明している章を参照してください。

(2)　論理ホスト運用するPFM - Agent for WebSphere Application Serverのセットアップに必要な情報

論理ホスト運用するPFM - Agent for WebSphere Application Serverをセットアップするには，通常のPFM - Agent for WebSphere Application Serverのセットアップで必要になる環境情報に加えて，次の表の情報が必要です。

表4-4　論理ホスト運用のPFM - Agent for WebSphere Application Serverのセットアップに必要な情報

項目 | 例
論理ホスト名 | jp1-hal2
論理IPアドレス | 172.16.92.100
共有ディスク | /jp1

なお，1つの論理ホストで論理ホスト運用するPerformance Managementのプログラムが複数ある場合も，同じ共有ディスクのディレクトリを使用します。

共有ディスクに必要な容量については，「付録A システム見積もり」を参照してください。

(3)　PFM - Agent for WebSphere Application Serverで論理ホストをフェールオーバーさせる場合の注意事項

PFM - Agent for WebSphere Application Serverを論理ホスト運用するシステム構成の場合，PFM - Agent for WebSphere Application Serverの障害によって論理ホスト全体をフェールオーバーさせるかどうかを検討してください。

PFM - Agent for WebSphere Application Serverの障害で論理ホスト全体をフェールオーバーさせると，PFM - Agent for WebSphere Application Serverが監視対象としている同じ論理ホストで運用する業務アプリケーションもフェールオーバーすることになり，業務に影響を与えるおそれがあります。

通常は，PFM - Agent for WebSphere Application Serverに異常が発生しても，WebSphere Application Serverの動作に影響がないように，次のどちらかのようにクラスタソフトで設定することをお勧めします。

PFM - Agent for WebSphere Application Serverの動作監視をしない

PFM - Agent for WebSphere Application Serverの異常を検知してもフェールオーバーしない

(4)　論理ホスト運用時のバージョンアップに関する注意事項

論理ホスト運用のPFM - Agent for WebSphere Application Serverをバージョンアップする場合は，実行系ノードまたは待機系ノードのどちらか一方で，共有ディスクをオンラインにする必要があります。

4.4.3　インストール手順

実行系ノードおよび待機系ノードにPFM - Agent for WebSphere Application Serverをインストールします。

注意

インストール先はローカルディスクです。共有ディスクにはインストールしないでください。

インストール手順は非クラスタシステムの場合と同じです。インストール手順については，「3.1.3 インストール手順」を参照してください。

4.4.4　セットアップ手順

ここでは，クラスタシステムで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)　クラスタシステムでの環境設定　

(1)　PFM - Agentの登録[図データ]　[図データ]　[図データ]

PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために，PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for WebSphere Application Serverを登録する必要があります。

PFM - Agent for WebSphere Application Serverを登録する必要があるのは次の場合です。

Performance Managementシステムに新しくPFM - Agent for WebSphere Application Serverを追加する場合

すでに登録しているPFM - Agent for WebSphere Application Serverのデータモデルのバージョンを更新する場合

登録はPFM - Manager上およびPFM - Web Console上で実施します。手順は非クラスタシステムの場合と同じです。

手順については，「3.1.4(2) PFM - Agent for WebSphere Application Serverの登録」を参照してください。

(2)　共有ディスクのマウント[図データ]

共有ディスクがマウントされていることを確認します。共有ディスクがマウントされていない場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをマウントしてください。

(3)　PFM - Agentの論理ホストのセットアップ[図データ]

jpcconf ha setup (jpchasetup create)コマンドを実行して論理ホスト環境を作成します。コマンドを実行すると，共有ディスクに必要なデータがコピーされ，論理ホスト用の定義が設定されて，論理ホスト環境が作成されます。

注意

コマンドを実行する前に，Performance Managementシステム全体で，Performance Managementのプログラムおよびサービスをすべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」のPerformance Managementを運用するための操作について説明している章を参照してください。

手順を次に示します。

jpcconf ha setup (jpchasetup create)コマンドを実行して，PFM - Agent for WebSphere Application Serverの論理ホスト環境を作成する。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha setup -key WAS -lhost jp1-hal2 -d /jp1 (/opt/jp1pc/tools/jpchasetup create agt2 -lhost jp1-hal2 -d /jp1)

論理ホスト名は，-lhostオプションで指定します。ここでは，論理ホスト名をjp1-hal2としています。DNS運用をしている場合はドメイン名を省略した論理ホスト名を指定してください。
共有ディスクのディレクトリ名は，-dオプションの環境ディレクトリ名に指定します。例えば-d /jp1と指定すると/jp1/jp1pcが作成されて，論理ホスト環境のファイルが作成されます。

jpcconf ha list (jpchasetup list)コマンドを実行して，論理ホストの設定を確認する。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha list -key all (/opt/jp1pc/tools/jpchasetup list all)

作成した論理ホスト環境が正しいことを確認してください。

(4)　接続先PFM - Managerの設定[図データ]

jpcconf mgrhost define (jpcnshostname)コマンドを実行して，PFM - Agent for WebSphere Application Serverを管理するPFM - Managerを設定します。

jpcconf mgrhost define (jpcnshostname)コマンドを実行して，接続先PFM - Managerを設定する。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf mgrhost define -host jp1-hal -lhost jp1-hal2 (/opt/jp1pc/tools/jpcnshostname -s jp1-hal -lhost jp1-hal2)

接続先PFM - Managerのホスト名は，-hostオプションで指定します。接続先PFM - Managerが論理ホスト運用されている場合は，-hostオプションに接続先PFM - Managerの論理ホスト名を指定します。ここでは，PFM - Managerの論理ホスト名をjp1-halとしています。
また，PFM - Agent for WebSphere Application Serverの論理ホスト名は，-lhostオプションで指定します。ここでは，PFM - Agent for WebSphere Application Serverの論理ホスト名をjp1-hal2としています。

(5)　インスタンス環境の設定[図データ]

jpcconf inst setup (jpcinssetup)コマンドを実行して，PFM - Agent for WebSphere Application Serverのインスタンス環境を設定します。

設定手順は，非クラスタシステムの場合と同じです。ただし，クラスタシステムの場合，jpcconf inst setup (jpcinssetup)コマンドの実行時に，「-lhost」で論理ホスト名を指定する必要があります。

クラスタシステムの場合のjpcconf inst setup (jpcinssetup)コマンドの指定方法を次に示します。

/opt/jp1pc/tools/jpcconf inst setup -key WAS -lhost 論理ホスト名 -inst インスタンス名 (/opt/jp1pc/tools/jpcinssetup agt2 -lhost 論理ホスト名 -inst インスタンス名)

このほかの設定内容および手順については，「3.1.4(3) インスタンス環境の設定」を参照してください。

(6)　他Performance Managementプログラムの論理ホストのセットアップ[図データ]　[図データ]

PFM - Agent for WebSphere Application Serverのほかに，同じ論理ホストにセットアップするPFM - ManagerやPFM - Agentがある場合は，この段階でセットアップしてください。

セットアップ手順については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

(7)　ネットワークの設定[図データ]　[図データ]

Performance Managementを使用するネットワーク構成に応じて，変更する場合にだけ必要な設定です。

ネットワークの設定では次の2つの項目を設定できます。

IPアドレスを設定する
複数のLANに接続されたネットワーク環境でPerformance Managementを運用するときに使用するIPアドレスを指定したい場合には，jpchostsファイルの内容を直接編集します。
このとき，編集したjpchostsファイルは，実行系ノードから待機系ノードにコピーしてください。
IPアドレスの設定方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

ポート番号を設定する
ファイアウォール経由でPerformance Managementのプログラム間の通信をする場合には，jpcconf port (jpcnsconfig port)コマンドを使用してポート番号を設定します。
ポート番号の設定方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章，およびマニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

(8)　ログのファイルサイズ変更[図データ]　[図データ]

Performance Managementの稼働状況を，Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは，デフォルトで2,048キロバイトのファイルが2個使用されます。このファイルサイズを変更したい場合に必要な設定です。

詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

(9)　パフォーマンスデータの格納先の変更[図データ]　[図データ]

PFM - Agentで管理されるパフォーマンスデータを格納するデータベースの保存先，バックアップ先，エクスポート先，またはインポート先のディレクトリを変更したい場合に必要な設定です。

設定方法については，「3.4.1　パフォーマンスデータの格納先の変更」を参照してください。

(10)　動作ログ出力の設定[図データ]　[図データ]

アラーム発生時に動作ログを出力したい場合に必要な設定です。動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。

設定方法については，「付録I　動作ログの出力」を参照してください。

(11)　論理ホスト環境定義ファイルのエクスポート[図データ]

PFM - Agent for WebSphere Application Serverの論理ホスト環境が作成できたら，環境定義をファイルにエクスポートします。エクスポートでは，その論理ホストにセットアップされているPerformance Managementのプログラムの定義情報を一括してファイル出力します。同じ論理ホストにほかのPerformance Managementのプログラムをセットアップする場合は，セットアップが一とおり済んだあとにエクスポートしてください。

手順を次に示します。

jpcconf ha export (jpchasetup export)コマンドを実行して，論理ホスト環境定義をエクスポートする。
これまでの手順で作成した論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha export -f lhostexp.txt (/opt/jp1pc/tools/jpchasetup export -f lhostexp.txt)

(12)　論理ホスト環境定義ファイルの待機系ノードへのコピー[図データ]　[図データ]

「(11) 論理ホスト環境定義ファイルのエクスポート」でエクスポートした論理ホスト環境定義ファイルを，実行系ノードから待機系ノードにコピーします。

(13)　共有ディスクのアンマウント[図データ]　[図データ]

ファイルシステムをアンマウントして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，ファイルシステムをアンマウントする必要はありません。

注意

共有ディスクがアンマウントされていても，指定した環境ディレクトリにjp1pcディレクトリがあり，jp1pcディレクトリ以下にファイルがある場合は，共有ディスクをマウントしないでセットアップしています。この場合は次の手順で対処してください。

ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリをtarコマンドでアーカイブする。

共有ディスクをマウントする。

共有ディスク上に指定した環境ディレクトリがない場合は，環境ディレクトリを作成する。

共有ディスク上の環境ディレクトリにtarファイルを展開する。

共有ディスクをアンマウントする。

ローカルディスク上の指定した環境ディレクトリにあるjp1pcディレクトリ以下を削除する。

(14)　論理ホスト環境定義ファイルのインポート[図データ]

実行系ノードからコピーしたエクスポートファイルを，待機系ノードにインポートします。

実行系ノードで作成した論理ホストのPerformance Managementのプログラムを，待機系ノードで実行するための設定には，jpcconf ha import (jpchasetup import)コマンドを使用します。1つの論理ホストに複数のPerformance Managementのプログラムがセットアップされている場合は，一括してインポートされます。

なお，このコマンドを実行するときには，共有ディスクをマウントしておく必要はありません。

手順を次に示します。

jpcconf ha import (jpchasetup import)コマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha import -f lhostexp.txt (/opt/jp1pc/tools/jpchasetup import -f lhostexp.txt)

コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for WebSphere Application Serverを起動するための設定が実施されます。
また，セットアップ時にjpcconf port (jpcnsconfig port)コマンドで固定のポート番号を設定している場合も，同様に設定されます。

jpcconf ha list (jpchasetup list)コマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha list -key all (/opt/jp1pc/tools/jpchasetup list all)

実行系ノードでjpcconf ha list (jpchasetup list)を実行したときと同じ内容が表示されることを確認してください。

(15)　クラスタソフトへのPFM - Agentの登録[図データ]　[図データ]

Performance Managementのプログラムを論理ホスト環境で運用する場合は，クラスタソフトに登録して，クラスタソフトからの制御でPerformance Managementのプログラムを起動したり停止したりするように環境設定します。

ここでは，PFM - Agent for WebSphere Application Serverをクラスタソフトに登録するときに設定する内容を説明します。

一般にUNIXのクラスタソフトに，アプリケーションを登録する場合に必要な項目は「起動」「停止」「動作監視」「強制停止」の4つがあります。

PFM - Agent for WebSphere Application Serverでの設定方法を次の表に示します。

表4-5　クラスタソフトに登録するPFM - Agent for WebSphere Application Serverの制御方法

項目
説明

起動
次のコマンドを順に実行して，PFM - Agent for WebSphere Application Serverを起動する。

/opt/jp1pc/tools/jpcspm start -key AH -lhost 論理ホスト名 (/opt/jp1pc/tools/jpcstart act lhost=論理ホスト名)
/opt/jp1pc/tools/jpcspm start -key WAS -lhost 論理ホスト名 -inst インスタンス名 (/opt/jp1pc/tools/jpcstart agt2 lhost=論理ホスト名 inst=インスタンス名)

起動するタイミングは，共有ディスクおよび論理IPアドレスが使用できる状態になったあととする。

停止
次のコマンドを順に実行して，PFM - Agent for WebSphere Application Serverを停止する。

/opt/jp1pc/tools/jpcspm stop -key WAS -lhost 論理ホスト名 -inst インスタンス名 (/opt/jp1pc/tools/jpcstop agt2 lhost=論理ホスト名 inst=インスタンス名)
/opt/jp1pc/tools/jpcspm stop -key AH -lhost 論理ホスト名 (/opt/jp1pc/tools/jpcstop act lhost=論理ホスト名)

停止するタイミングは，共有ディスクおよび論理IPアドレスを使用できない状態にする前とする。
なお，障害などでサービスが停止しているときは，jpcspm stop (jpcstop)コマンドの戻り値が3になる。この場合はサービスが停止されているので，正常終了として扱われる。戻り値で実行結果を判定するクラスタソフトの場合は，戻り値を0にするなどで対応すること。

動作監視
次のプロセスが動作していることを，psコマンドで確認する。

ps -ef | grep "プロセス名 論理ホスト名" | grep -v "grep 監視対象のプロセス"

監視対象のプロセスは，次のとおり。
jpcagt2,jpcsto,jpcah
プロセス名については，「付録D　プロセス一覧」およびマニュアル「JP1/Performance Management リファレンス」の付録を参照のこと。
なお，運用中にメンテナンスなどでPerformance Managementを一時的に停止する場合を想定して，動作監視を抑止する方法（例えば，メンテナンス中のファイルがあると監視をしないなど）を用意しておくことを推奨する。

強制停止
強制停止が必要な場合は，次のコマンドを実行する。

/opt/jp1pc/tools/jpcspm stop -key all -lhost 論理ホスト名 -kill immediate (/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コマンドで動作を監視する場合，事前にpsコマンドを実行して，論理ホスト名とインスタンス名をつなげた文字列がすべて表示されることを確認してください。文字列が途中までしか表示されない場合は，インスタンス名を短くしてください。

(16)　クラスタソフトからの起動・停止の確認[図データ]　[図データ]

クラスタソフトからの操作で，Performance Managementのプログラムの起動および停止を各ノードで実行し，正常に動作することを確認してください。

(17)　クラスタシステムでの環境設定[図データ]　[図データ]

Performance Managementのプログラムのセットアップ終了後，PFM - Web Consoleから，運用に合わせて監視対象の稼働状況についてのレポートを表示できるようにしたり，監視対象で問題が発生したときにユーザーに通知できるようにしたりするために，Performance Managementのプログラムの環境を設定します。

Performance Managementのプログラムの環境設定方法については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

4.5　アンインストールとアンセットアップ（Windowsの場合）

ここでは，クラスタシステムで運用していたPFM - Agent for WebSphere Application Serverを，アンインストールする方法とアンセットアップする方法について説明します。

なお，PFM - Managerのアンインストールとアンセットアップについては，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

＜この節の構成＞

4.5.1　PFM - Agent for WebSphere Application Serverのアンインストールとアンセットアップの流れ

4.5.2　アンセットアップ手順

4.5.3　アンインストール手順

4.5.1　PFM - Agent for WebSphere Application Serverのアンインストールとアンセットアップの流れ

クラスタシステムで運用していたPFM - Agent for WebSphere Application Serverのアンインストールおよびアンセットアップの流れを次の図に示します。

図4-5　クラスタシステムで論理ホスト運用するPFM - Agent for WebSphere Application Serverのアンインストールおよびアンセットアップの流れ（Windowsの場合）

4.5.2　アンセットアップ手順

論理ホスト環境をアンセットアップします。アンセットアップ手順には，実行系ノードの手順と，待機系ノードの手順があります。実行系ノード，待機系ノードの順にアンセットアップしてください。

[図データ]は実行系ノードで行う項目を，[図データ]は待機系ノードで行う項目を示します。また，[図データ]は使用する環境によって必要になるアンセットアップ項目，またはセットアップ時に設定した場合に必要になるアンセットアップ項目を示します。

PFM - Agent for WebSphere Application Serverのアンセットアップ手順について説明します。

＜この項の構成＞

(1)　クラスタソフトからの停止　

(2)　共有ディスクをオンラインにする

(3)　ポート番号の設定の解除　

(4)　PFM - Agentの論理ホストのアンセットアップ

(5)　他Performance Managementプログラムの論理ホストのアンセットアップ　

(6)　論理ホスト環境定義ファイルのエクスポート

(7)　論理ホスト環境定義ファイルの待機系ノードへのコピー　

(8)　共有ディスクをオフラインにする　

(9)　論理ホスト環境定義ファイルのインポート

(10)　クラスタソフトからのPFM - Agentの登録解除　

(11)　PFM - Managerでの設定の削除　

(1)　クラスタソフトからの停止[図データ]　[図データ]

クラスタソフトからの操作で，実行系ノードと待機系ノードで起動しているPerformance Managementのプログラムおよびサービスを停止してください。停止する方法については，クラスタソフトのマニュアルを参照してください。

(2)　共有ディスクをオンラインにする[図データ]

共有ディスクがオンラインになっていることを確認します。共有ディスクがオンラインになっていない場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオンラインにしてください。

(3)　ポート番号の設定の解除[図データ]　[図データ]

この手順は，ファイアウォールを使用する環境で，セットアップ時にjpcconf port(jpcnsconfig port)コマンドでポート番号を設定した場合だけに必要な手順です。

ポート番号の解除方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章，およびマニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの運用について説明している章を参照してください。

(4)　PFM - Agentの論理ホストのアンセットアップ[図データ]

手順を次に示します。

注意

共有ディスクがオフラインになっている状態で論理ホスト環境を削除した場合は，物理ホスト上に存在する論理ホストの設定だけが削除され，共有ディスク上のディレクトリやファイルは削除されません。この場合，共有ディスクをオンラインにし，環境ディレクトリ以下のjp1pcディレクトリを手動で削除する必要があります。

jpcconf ha list (jpchasetup list)コマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha list -key all -lhost jp1-hal2 (インストール先フォルダ¥tools¥jpchasetup list all -lhost jp1-hal2)

論理ホスト環境をアンセットアップする前に，現在の設定を確認します。論理ホスト名や共有ディスクのパスなどを確認してください。

PFM - Agent for WebSphere Application Serverのインスタンス環境を削除する。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf inst unsetup -key WAS -lhost jp1-hal2 -inst APSV (インストール先フォルダ¥tools¥jpcinsunsetup agt2 -lhost jp1-hal2 -inst APSV)

jpcconf inst unsetup (jpcinsunsetup)コマンドを実行すると，論理ホストのインスタンスを起動するための設定が削除されます。また，共有ディスク上のインスタンス用のファイルが削除されます。

jpcconf ha unsetup (jpchasetup delete)コマンドを実行して，PFM - Agent for WebSphere Application Serverの論理ホスト環境を削除する。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha unsetup -key WAS -lhost jp1-hal2 (インストール先フォルダ¥tools¥jpchasetup delete agt2 -lhost jp1-hal2)

jpcconf ha unsetup (jpchasetup delete)コマンドを実行すると，論理ホストのPFM - Agent for WebSphere Application Serverを起動するための設定が削除されます。また，共有ディスク上の論理ホスト用のファイルが削除されます。

jpcconf ha list (jpchasetup list)コマンドで，論理ホスト設定を確認する。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha list -key all (インストール先フォルダ¥tools¥jpchasetup list all)

論理ホスト環境からPFM - Agent for WebSphere Application Serverが削除されていることを確認してください。

(5)　他Performance Managementプログラムの論理ホストのアンセットアップ[図データ]　[図データ]

PFM - Agent for WebSphere Application Serverのほかに，同じ論理ホストからアンセットアップするPerformance Managementプログラムがある場合は，この段階でアンセットアップしてください。

アンセットアップ手順については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

(6)　論理ホスト環境定義ファイルのエクスポート[図データ]

論理ホストのPFM - Agent for WebSphere Application Serverを削除したら，環境定義をファイルにエクスポートします。

Performance Managementでは，環境定義のエクスポートおよびインポートによって実行系と待機系の環境を合わせる方式を採っています。

実行系ノードでエクスポートした環境定義（Performance Managementの定義が削除されている）を，待機系ノードにインポートすると，待機系ノードの既存の環境定義（Performance Managementの定義が削除前のままの状態で定義が残っている）と比較して差分（実行系ノードで削除された部分）を確認してPerformance Managementの環境定義を削除します。

手順を次に示します。

jpcconf ha export (jpchasetup export)コマンドを実行して，論理ホスト環境定義をエクスポートする。
Performance Managementの論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha export -f lhostexp.txt (インストール先フォルダ¥tools¥jpchasetup export -f lhostexp.txt)

(7)　論理ホスト環境定義ファイルの待機系ノードへのコピー[図データ]　[図データ]

「(6) 論理ホスト環境定義ファイルのエクスポート」でエクスポートしたファイルを，実行系ノードから待機系ノードにコピーします。

(8)　共有ディスクをオフラインにする[図データ]　[図データ]

クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをオフラインにして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，オフラインにする必要はありません。

(9)　論理ホスト環境定義ファイルのインポート[図データ]

実行系ノードからコピーしたエクスポートファイルを，待機系ノードに反映させるためにインポートします。なお，待機系ノードでは，インポート時に共有ディスクをオフラインにする必要はありません。

手順を次に示します。

jpcconf ha import (jpchasetup import)コマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha import -f lhostexp.txt (インストール先フォルダ¥tools¥jpchasetup import -f lhostexp.txt)

コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for WebSphere Application Serverを起動するための設定が削除されます。ほかの論理ホストのPerformance Managementのプログラムをアンセットアップしている場合は，それらの設定も削除されます。
また，セットアップ時にjpcconf port (jpcnsconfig port)コマンドで固定のポート番号を設定している場合も，解除されます。

jpcconf ha list (jpchasetup list)コマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

インストール先フォルダ¥tools¥jpcconf ha list -key all (インストール先フォルダ¥tools¥jpchasetup list all)

実行系ノードでjpcconf ha list (jpchasetup list)コマンドを実行したときと同じ内容が表示されることを確認してください。

(10)　クラスタソフトからのPFM - Agentの登録解除[図データ]　[図データ]

クラスタソフトから，論理ホストのPFM - Agent for WebSphere Application Serverに関する設定を削除してください。

設定を削除する方法は，クラスタソフトのマニュアルを参照してください。

(11)　PFM - Managerでの設定の削除[図データ]　[図データ]

PFM - Web ConsoleでPFM - Managerにログインし，アンセットアップするPFM - Agent for WebSphere Application Serverに関連する定義を削除してください。

手順を次に示します。

PFM - Web Consoleから，エージェントを削除する。

PFM - Managerのエージェント情報を削除する。
例えば，PFM - Managerが論理ホストjp1-hal上で動作し，PFM - Agent for WebSphere Application Serverが論理ホストjp1-hal2上で動作している場合，次のように指定してコマンドを実行します。

PFM - Managerのインストール先フォルダ¥tools¥jpctool service delete -id サービスID -host jp1-hal2 -lhost jp1-hal (PFM - Managerのインストール先フォルダ¥tools¥jpcctrl delete サービスID host=jp1-hal2 lhost=jp1-hal)

サービスIDには削除するエージェントのサービスIDを指定してください。

PFM - Managerサービスを再起動する。
サービスの起動方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

PFM - Managerホストのサービス情報を反映する。
PFM - Web Consoleホストにサービス情報の削除を反映するため，PFM - Manager ホストとPFM - Web Consoleホストのエージェント情報を同期します。エージェント情報を同期するにはjpctool service syncコマンドを使用してください。

4.5.3　アンインストール手順

PFM - Agent for WebSphere Application Serverを実行系ノード，待機系ノードそれぞれからアンインストールします。

アンインストール手順は，非クラスタシステムの場合と同じです。詳細は，「2.2.3 アンインストール手順」を参照してください。

注意

PFM - Agent for WebSphere Application Serverをアンインストールする場合は，PFM - Agent for WebSphere Application ServerをアンインストールするノードのPerformance Managementのプログラムおよびサービスをすべて停止してください。

論理ホスト環境を削除しないでPFM - Agent for WebSphere Application Serverをアンインストールした場合，環境ディレクトリが残ることがあります。その場合は，環境ディレクトリを削除してください。

4.6　アンインストールとアンセットアップ（UNIXの場合）

ここでは，クラスタシステムで運用していたPFM - Agent for WebSphere Application Serverを，アンインストールする方法とアンセットアップする方法について説明します。

なお，PFM - Managerのアンインストールとアンセットアップについては，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

＜この節の構成＞

4.6.1　PFM - Agent for WebSphere Application Serverのアンインストールとアンセットアップの流れ

4.6.2　アンセットアップ手順

4.6.3　アンインストール手順

4.6.1　PFM - Agent for WebSphere Application Serverのアンインストールとアンセットアップの流れ

クラスタシステムで運用していたPFM - Agent for WebSphere Application Serverのアンインストールおよびアンセットアップの流れを次の図に示します。

図4-6　クラスタシステムで論理ホスト運用するPFM - Agent for WebSphere Application Serverのアンインストールおよびアンセットアップの流れ（UNIXの場合）

4.6.2　アンセットアップ手順

論理ホスト環境をアンセットアップします。アンセットアップ手順には，実行系ノードの手順と，待機系ノードの手順があります。実行系ノード，待機系ノードの順にアンセットアップしてください。

[図データ]は実行系ノードで行う項目を，[図データ]は待機系ノードで行う項目を示します。また，[図データ]は使用する環境によって必要になるアンセットアップ項目，またはセットアップ時に設定した場合に必要になるアンセットアップ項目を示します。

PFM - Agent for WebSphere Application Serverのアンセットアップ手順について説明します。

＜この項の構成＞

(1)　クラスタソフトからの停止　

(2)　共有ディスクのマウント

(3)　ポート番号の設定の解除　

(4)　PFM - Agent の論理ホストのアンセットアップ

(5)　他Performance Managementプログラムの論理ホストのアンセットアップ　

(6)　論理ホスト環境定義ファイルのエクスポート

(7)　論理ホスト環境定義ファイルの待機系ノードへのコピー　

(8)　共有ディスクのアンマウント　

(9)　論理ホスト環境定義ファイルのインポート

(10)　クラスタソフトからのPFM - Agentの登録解除　

(11)　PFM - Managerでの設定の削除　

(1)　クラスタソフトからの停止[図データ]　[図データ]

クラスタソフトからの操作で，実行系ノードと待機系ノードで起動しているPerformance Managementのプログラムおよびサービスを停止してください。停止する方法については，クラスタソフトのマニュアルを参照してください。

(2)　共有ディスクのマウント[図データ]

共有ディスクがマウントされていることを確認します。共有ディスクがマウントされていない場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをマウントしてください。

注意

共有ディスクがアンマウントされていても，アンセットアップする論理ホストの環境ディレクトリにjp1pcディレクトリがあり，jp1pcディレクトリ以下にファイルがある場合は，共有ディスクをマウントしないでセットアップしています。この場合は次の手順で対処してください。

ローカルディスク上のアンセットアップする論理ホストの環境ディレクトリにあるjp1pcディレクトリをtarコマンドでアーカイブする。

共有ディスクをマウントする。

共有ディスク上にアンセットアップする論理ホストの環境ディレクトリがない場合は，環境ディレクトリを作成する。

共有ディスク上のアンセットアップする論理ホストの環境ディレクトリにtarファイルを展開する。

共有ディスクをアンマウントする。

ローカルディスク上のアンセットアップする論理ホストの環境ディレクトリにあるjp1pcディレクトリ以下を削除する。

(3)　ポート番号の設定の解除[図データ]　[図データ]

この手順は，ファイアウォールを使用する環境で，セットアップ時にjpcconf port (jpcnsconfig port)コマンドでポート番号を設定した場合だけに必要な手順です。

ポート番号の解除方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章，およびマニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章を参照してください。

(4)　PFM - Agent の論理ホストのアンセットアップ[図データ]

手順を次に示します。

注意

共有ディスクがマウントされていない状態で論理ホスト環境を削除した場合は，物理ホスト上に存在する論理ホストの設定が削除され，共有ディスク上のディレクトリやファイルは削除されません。この場合，共有ディスクをマウントして，環境ディレクトリ以下のjp1pcディレクトリを手動で削除する必要があります。

jpcconf ha list (jpchasetup list)コマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha list -key all -lhost jp1-hal2 (/opt/jp1pc/tools/jpchasetup list all -lhost jp1-hal2)

論理ホスト環境をアンセットアップする前に，現在の設定を確認します。論理ホスト名や共有ディスクのパスなどを確認してください。

PFM - Agent for WebSphere Application Serverのインスタンス環境を削除する。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf inst unsetup -key WAS -lhost jp1-hal2 -inst APSV (/opt/jp1pc/tools/jpcinsunsetup agt2 -lhost jp1-hal2 -inst APSV)

jpcconf inst unsetup (jpcinsunsetup)コマンドを実行すると，論理ホストのインスタンスを起動するための設定が削除されます。また，共有ディスク上のインスタンス用のファイルが削除されます。

jpcconf ha unsetup (jpchasetup delete)コマンドを実行して，PFM - Agent for WebSphere Application Serverの論理ホスト環境を削除する。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha unsetup -key WAS -lhost jp1-hal2 (/opt/jp1pc/tools/jpchasetup delete agt2 -lhost jp1-hal2)

jpcconf ha unsetup (jpchasetup delete)コマンドを実行すると，論理ホストのPFM - Agent for WebSphere Application Serverを起動するための設定が削除されます。また，共有ディスク上の論理ホスト用のファイルが削除されます。

jpcconf ha list (jpchasetup list)コマンドで，論理ホスト設定を確認する。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha list -key all (/opt/jp1pc/tools/jpchasetup list all)

論理ホスト環境からPFM - Agent for WebSphere Application Serverが削除されていることを確認してください。

(5)　他Performance Managementプログラムの論理ホストのアンセットアップ[図データ]　[図データ]

PFM - Agent for WebSphere Application Serverのほかに，同じ論理ホストからアンセットアップするPFM - Agentがある場合は，この段階でアンセットアップしてください。

アンセットアップ手順については，マニュアル「JP1/Performance Management 運用ガイド」の，クラスタシステムでの構築と運用について説明している章，または各PFM - Agentマニュアルの，クラスタシステムでの運用について説明している章を参照してください。

(6)　論理ホスト環境定義ファイルのエクスポート[図データ]

論理ホストのPFM - Agent for WebSphere Application Serverを削除したら，環境定義をファイルにエクスポートします。

Performance Managementでは，環境定義のエクスポートおよびインポートによって実行系と待機系の環境を合わせる方式を採っています。

実行系ノードでエクスポートした環境定義（Performance Managementの定義が削除されている）を，待機系ノードにインポートすると，待機系ノードの既存の環境定義（Performance Managementの定義が削除前のままの状態で定義が残っている）と比較して差分（実行系ノードで削除された部分）を確認してPerformance Managementの環境定義を削除します。

手順を次に示します。

jpcconf ha export (jpchasetup export)コマンドを実行して，論理ホスト環境定義をエクスポートする。
Performance Managementの論理ホスト環境の定義情報を，エクスポートファイルに出力します。エクスポートファイル名は任意です。
例えば，lhostexp.txtファイルに論理ホスト環境定義をエクスポートする場合，次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha export -f lhostexp.txt (/opt/jp1pc/tools/jpchasetup export -f lhostexp.txt)

(7)　論理ホスト環境定義ファイルの待機系ノードへのコピー[図データ]　[図データ]

「(6) 論理ホスト環境定義ファイルのエクスポート」でエクスポートしたファイルを，実行系ノードから待機系ノードにコピーします。

(8)　共有ディスクのアンマウント[図データ]　[図データ]

ファイルシステムをアンマウントして，作業を終了します。なお，その共有ディスクを続けて使用する場合は，ファイルシステムをアンマウントする必要はありません。

(9)　論理ホスト環境定義ファイルのインポート[図データ]

実行系ノードからコピーしたエクスポートファイルを，待機系ノードに反映させるためにインポートします。なお，待機系ノードでは，インポート時に共有ディスクをアンマウントする必要はありません。

手順を次に示します。

jpcconf ha import (jpchasetup import)コマンドを実行して，論理ホスト環境定義をインポートする。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha import -f lhostexp.txt (/opt/jp1pc/tools/jpchasetup import -f lhostexp.txt)

コマンドを実行すると，待機系ノードの環境を，エクスポートファイルの内容と同じ環境になるように設定変更します。これによって，論理ホストのPFM - Agent for WebSphere Application Serverを起動するための設定が削除されます。ほかの論理ホストのPerformance Managementのプログラムをアンセットアップしている場合は，それらの設定も削除されます。
また，セットアップ時にjpcconf port (jpcnsconfig port)コマンドで固定のポート番号を設定している場合も，解除されます。

jpcconf ha list (jpchasetup list)コマンドを実行して，論理ホスト設定を確認する。
次のようにコマンドを実行します。

/opt/jp1pc/tools/jpcconf ha list -key all (/opt/jp1pc/tools/jpchasetup list all)

実行系ノードでjpcconf ha list (jpchasetup list)コマンドを実行したときと同じ内容が表示されることを確認してください。

(10)　クラスタソフトからのPFM - Agentの登録解除[図データ]　[図データ]

クラスタソフトから，論理ホストのPFM - Agent for WebSphere Application Serverに関する設定を削除してください。

設定を削除する方法は，クラスタソフトのマニュアルを参照してください。

(11)　PFM - Managerでの設定の削除[図データ]　[図データ]

PFM - Web ConsoleでPFM - Managerにログインし，アンセットアップするPFM - Agent for WebSphere Application Serverに関連する定義を削除してください。

手順を次に示します。

PFM - Web Consoleから，エージェントを削除する。

PFM - Managerのエージェント情報を削除する。
例えば，PFM - Managerが論理ホストjp1-hal上で動作し，PFM - Agent for WebSphere Application Serverが論理ホストjp1-hal2上で動作している場合，次のように指定してコマンドを実行します。

/opt/jp1pc/tools/jpctool service delete -id サービスID -host jp1-hal2 -lhost jp1-hal (/opt/jp1pc/tools/jpcctrl delete サービスID host=jp1-hal2 lhost=jp1-hal)

サービスIDには削除するエージェントのサービスIDを指定してください。

PFM - Managerサービスを再起動する。
サービスの起動方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

PFM - Managerホストのサービス情報を反映する。
PFM - Web Consoleホストにサービス情報の削除を反映するため，PFM - Manager ホストとPFM - Web Consoleホストのエージェント情報を同期します。エージェント情報を同期するにはjpctool service syncコマンドを使用してください。

4.6.3　アンインストール手順

PFM - Agent for WebSphere Application Serverを実行系ノード，待機系ノードそれぞれからアンインストールします。

アンインストール手順は，非クラスタシステムの場合と同じです。詳細は，「3.2.3 アンインストール手順」を参照してください。

注意

PFM - Agent for WebSphere Application Serverをアンインストールする場合は，PFM - Agent for WebSphere Application ServerをアンインストールするノードのPerformance Managementのプログラムおよびサービスをすべて停止してください。

論理ホスト環境を削除しないでPFM - Agent for WebSphere Application Serverをアンインストールした場合，環境ディレクトリが残ることがあります。その場合は，環境ディレクトリを削除してください。

4.7　PFM - Agent for WebSphere Application Serverのシステム構成の変更

監視対象システムのネットワーク構成の変更や，ホスト名の変更などに応じて，PFM - Agent for WebSphere Application Serverのシステム構成を変更する場合があります。

PFM - Agent for WebSphere Application Serverのシステム構成を変更する場合，PFM - ManagerやPFM - Web Consoleの設定変更もあわせて行う必要があります。Performance Managementのシステム構成を変更する手順の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。なお，論理ホスト名を変更するときに，固有の追加作業が必要なPFM - Agentもありますが，PFM - Agent for WebSphere Application Serverの場合，固有の追加作業は必要ありません。

4.8　PFM - Agent for WebSphere Application Serverの運用方式の変更

ここでは，クラスタシステムでPFM - Agent for WebSphere Application Serverの運用方式を変更する手順を説明します。Performance Management全体の運用方式を変更する手順の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

＜この節の構成＞

4.8.1　インスタンス環境の更新の設定

4.8.2　論理ホスト環境定義ファイルのエクスポート・インポート

4.8.1　インスタンス環境の更新の設定

クラスタシステムでインスタンス環境を更新したい場合は，論理ホスト名とインスタンス名を確認し，インスタンス情報を更新します。インスタンス情報の設定は，実行系ノードのPFM - Agentホストで実施します。

更新する情報については，Windowsの場合は「2.4.2　インスタンス環境の更新の設定」，UNIXの場合は「3.4.2　インスタンス環境の更新の設定」を参照して，あらかじめ確認してください。WebSphere Application Serverのインスタンス情報の詳細については，WebSphere Application Serverのマニュアルを参照してください。

論理ホスト名とインスタンス名を確認するには，jpcconf ha list (jpchasetup list)コマンドを使用します。また，インスタンス環境を更新するには，jpcconf inst setup (jpcinssetup)コマンドを使用します。

インスタンス環境を更新する手順を次に示します。複数のインスタンス環境を更新する場合は，この手順を繰り返し実施します。

論理ホスト名とインスタンス名を確認する。
更新したいインスタンス環境で動作しているPFM - Agent for WebSphere Application Serverを示すサービスキーを指定して，jpcconf ha list (jpchasetup list)コマンドを実行します。
例えば，PFM - Agent for WebSphere Application Serverの論理ホスト名とインスタンス名を確認したい場合，次のように指定してコマンドを実行します。

Windowsの場合

インストール先フォルダ¥tools¥jpcconf ha list -key WAS (インストール先フォルダ¥tools¥jpchasetup list agt2)

UNIXの場合

/opt/jp1pc/tools/jpcconf ha list -key WAS (/opt/jp1pc/tools/jpchasetup list agt2)

設定されている論理ホスト名がjp1-hal2，インスタンス名がAPSVの場合，次のように表示されます。

更新したいインスタンス環境のPFM - Agent for WebSphere Application Serverのサービスが起動されている場合は，クラスタソフトからサービスを停止する。

手順2で共有ディスクがアンマウントされる場合は，クラスタソフトからの操作やボリュームマネージャの操作などで，共有ディスクをマウントする。

更新したいインスタンス環境のPFM - Agent for WebSphere Application Serverを示すサービスキーおよびインスタンス名を指定して，jpcconf inst setup (jpcinssetup)コマンドを実行する。
例えば，PFM - Agent for WebSphere Application Serverの論理ホスト名がjp1-hal2，インスタンス名がAPSVのインスタンス環境を更新する場合，次のように指定してコマンドを実行します。

Windowsの場合

インストール先フォルダ¥tools¥jpcconf inst setup -key WAS -lhost jp1-hal2 -inst APSV (インストール先フォルダ¥tools¥jpcinssetup agt2 -lhost jp1-hal2 -inst APSV)

UNIXの場合

/opt/jp1pc/tools/jpcconf inst setup -key WAS -lhost jp1-hal2 -inst APSV (/opt/jp1pc/tools/jpcinssetup agt2 -lhost jp1-hal2 -inst APSV)

WebSphere Application Serverのインスタンス情報を更新する。
PFM - Agent for WebSphere Application Serverのインスタンス情報を，コマンドの指示に従って入力します。PFM - Agent for WebSphere Application Serverのインスタンス情報については，Windowsの場合は「2.4.2　インスタンス環境の更新の設定」，UNIXの場合は「3.4.2　インスタンス環境の更新の設定」を参照してください。現在設定されている値が表示されます（ただしPFM - Agent for WebSphere Application Server_passwdの値は表示されません）。表示された値を変更しない場合は，リターンキーだけを押してください。すべての入力が終了すると，インスタンス環境が更新されます。

更新したインスタンス環境のサービスを，クラスタソフトから再起動する。
サービスの起動方法および停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

注意

更新できない項目の値を変更したい場合は，インスタンス環境を削除したあと，再作成してください。

コマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

4.8.2　論理ホスト環境定義ファイルのエクスポート・インポート

論理ホスト環境定義ファイルのエクスポート・インポートは，次の操作を実行した場合だけ実施します。

論理ホストのセットアップ，またはインスタンス環境の設定時に，論理ホスト上のノード構成を変更した。
PFM - Agentの論理ホストのセットアップ方法については，次の個所を参照してください。

Windowsの場合：「4.3.4(3)　PFM - Agentの論理ホストのセットアップ」

UNIXの場合：「4.4.4(3)　PFM - Agentの論理ホストのセットアップ」

また，インスタンス環境の設定方法については，次の個所を参照してください。

Windowsの場合：「4.3.4(5)　インスタンス環境の設定」

UNIXの場合：「4.4.4(5)　インスタンス環境の設定」

他Performance Managementプログラムの論理ホストのセットアップ時に，論理ホスト環境定義ファイルのエクスポートが必要な操作を実行した。
他Performance Managementプログラムの論理ホストのセットアップ方法については，次の個所を参照してください。

Windowsの場合：「4.3.4(6)　他Performance Managementプログラムの論理ホストのセットアップ」

UNIXの場合：「4.4.4(6)　他Performance Managementプログラムの論理ホストのセットアップ」

ネットワークの設定時に，ポート番号を設定した。
ネットワークの設定方法については，次の個所を参照してください。

Windowsの場合：「4.3.4(7)　ネットワークの設定」

UNIXの場合：「4.4.4(7)　ネットワークの設定」

論理ホスト環境定義ファイルのエクスポート・インポートの手順については次の個所を参照してください。

Windowsの場合：「4.3.4(11)　論理ホスト環境定義ファイルのエクスポート」～「4.3.4(14)　論理ホスト環境定義ファイルのインポート」

UNIXの場合：「4.4.4(11)　論理ホスト環境定義ファイルのエクスポート」～「4.4.4(14)　論理ホスト環境定義ファイルのインポート」

なお，インスタンス環境の更新だけを実施した場合は，論理ホスト環境定義ファイルのエクスポート・インポートは不要です。

インスタンス環境の更新方法については，「4.8.1　インスタンス環境の更新の設定」を参照してください。

5.　監視テンプレート

この章では，PFM - Agent for WebSphere Application Serverの監視テンプレートについて説明します。

＜この章の構成＞

監視テンプレートの概要

アラームの記載形式

アラーム一覧

JDBC Connection Pool

JVM Use CPU

JVM Use Memory

Server State

Thread Pool

レポートの記載形式

レポートのフォルダ構成

レポート一覧

J2C Connection Pool Use Rate（最近1時間の履歴レポート）

JDBC Connection Pool Use Rate（最近1か月間の履歴レポート）

JDBC Connection Pool Use Rate（最近24時間の履歴レポート）

JDBC Connection Pool Use Rate（リアルタイムレポート）

JDBC Connection Pool Use Rate（最近1時間の履歴レポート）

JVM Resource Use Rate（最近1か月の履歴レポート）

JVM Resource Use Rate（最近24時間の履歴レポート）

JVM Resource Use Rate（リアルタイムレポート）

JVM Resource Use Rate（最近1時間の履歴レポート）

Lookup Time（最近1時間の履歴レポート）

Method Response Time（最近1時間の履歴レポート）

Response Time（最近1時間の履歴レポート）

Server State（最近1時間の履歴レポート）

Service Time（最近1時間の履歴レポート）

Thread Pool Use Rate（最近1か月間の履歴レポート）

Thread Pool Use Rate（最近24時間の履歴レポート）

Thread Pool Use Rate（リアルタイムレポート）

Thread Pool Use Rate（最近1時間の履歴レポート）

監視テンプレートの概要

Performance Managementでは，次の方法でアラームとレポートを定義できます。

PFM - Agentで定義されているアラームやレポートをそのまま使用する

PFM - Agentで定義されているアラームやレポートをコピーしてカスタマイズする

ウィザードを使用して新規に定義する

PFM - Agentで用意されているアラームやレポートを「監視テンプレート」と呼びます。監視テンプレートのレポートとアラームは，必要な情報があらかじめ定義されているので，コピーしてそのまま使用したり，ユーザーの環境に合わせてカスタマイズしたりできます。そのため，ウィザードを使用して新規に定義をしなくても，監視対象の運用状況を監視する準備が容易にできるようになります。

この章では，PFM - Agent for WebSphere Application Serverで定義されている監視テンプレートのアラームとレポートの設定内容について説明します。

監視テンプレートの使用方法の詳細については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働分析のためのレポートの作成，およびアラームによる稼働監視について説明している章を参照してください。

注意

監視テンプレートのアラームに設定されているしきい値は参考例です。監視テンプレートのアラームを使用する場合は，コピーして，環境やOSに合わせて適切なしきい値を設定してください。

アラームの記載形式

ここでは，アラームの記載形式を示します。アラームは，アルファベット順に記載しています。

アラーム名

監視テンプレートのアラーム名を示します。

概要

このアラームで監視できる監視対象の概要について説明します。

主な設定

このアラームの主な設定値を表で説明します。この表では，アラームの設定値と，PFM - Web Consoleの［アラーム階層］画面でアラームアイコンをクリックし，［プロパティの表示］メソッドをクリックしたときに表示される，［プロパティ］画面の設定項目との対応を示しています。各アラームの設定の詳細については，PFM - Web Consoleのアラームの［プロパティ］画面で確認してください。

設定値の「－」は，設定が常に無効であることを示します。

なお，条件式で異常条件と警告条件が同じ場合は，アラームイベントは異常のものだけが発行されます。

関連レポート

このアラームに関連する，監視テンプレートのレポートを示します。PFM - Web Consoleの［エージェント階層］画面でエージェントアイコンをクリックし，［アラームの状態の表示］メソッドで表示される[図データ]アイコンをクリックすると，このレポートを表示できます。

アラーム一覧

1つ以上のアラームを1つのテーブルにまとめたものを「アラームテーブル」と呼びます。PFM - Agent for WebSphere Application Serverの監視テンプレートで定義されているアラームは，アラームテーブルの形式で，PFM - Web Consoleの［アラーム階層］タブに表示される「WebSphere Application Server」フォルダに格納されています。

アラームテーブル名を次に示します。

PFM WebSphere Application Server Template Alarms 09.00

アラームテーブル名末尾の「09.00」

アラームテーブルのバージョンを示します。

監視テンプレートで定義されているアラームを使用する際は，Performance Managementシステムで使用しているアラームテーブルのバージョンおよびバージョンの互換性を確認してください。アラームテーブルのバージョンおよびバージョン互換については，「付録H　バージョン互換」を参照してください。

PFM - Agent for WebSphere Application Serverの監視テンプレートで定義されているアラームを，次の表に示します。

表5-1　アラーム一覧

アラーム名 | 監視対象
JDBC Connection Pool | JDBC接続プールの使用率。
JVM Use CPU | JVMランタイムのCPU使用率。
JVM Use Memory | JVMランタイムのメモリー使用率。
Server State | WebSphere Application Serverの稼働状態。
Thread Pool | スレッドプールの使用率。

JDBC Connection Pool

概要

JDBC接続プールの使用率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
プロダクト
WebSphere Application Server

メッセージテキスト
JDBC Connection Pool use rate is %CVS%.

アラームを有効にする
する

すべてのデータを評価する
しない

監視時刻範囲
常に監視する

発生頻度を満たしたときにアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
Eメール
－

コマンド
－

SNMP
異常，警告，正常

条件式
レコード
JDBC Connection Pool（JDBC）

フィールド
Connection Pool Use %

異常条件
Connection Pool Use % >= 90

警告条件
Connection Pool Use % >= 80

関連レポート

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/JDBC Connection Pool/JDBC Connection Pool Use Rate

JVM Use CPU

概要

JVMランタイムのCPU使用率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
プロダクト
WebSphere Application Server

メッセージテキスト
JVM CPU use rate is %CVS%.

アラームを有効にする
する

すべてのデータを評価する
しない

監視時刻範囲
常に監視する

発生頻度を満たしたときにアラーム通知する
する

インターバル中
3

回しきい値超過
2

アクション
Eメール
－

コマンド
－

SNMP
異常，警告，正常

条件式
レコード
Java VM（JVM）

フィールド
CPU Use %

異常条件
CPU Use % >= 95

警告条件
CPU Use % >= 75

関連レポート

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/Java VM/JVM Resource Use Rate

JVM Use Memory

概要

JVMランタイムのメモリー使用率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
プロダクト
WebSphere Application Server

メッセージテキスト
JVM Memory use rate is %CVS%.

アラームを有効にする
する

すべてのデータを評価する
しない

監視時刻範囲
常に監視する

発生頻度を満たしたときにアラーム通知する
する

インターバル中
3

回しきい値超過
2

アクション
Eメール
－

コマンド
－

SNMP
異常，警告，正常

条件式
レコード
Java VM（JVM）

フィールド
Memory Use %

異常条件
Memory Use % >= 95

警告条件
Memory Use % >= 75

関連レポート

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/Java VM/JVM Resource Use Rate

Server State

概要

WebSphere Application Serverの稼働状態を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
プロダクト
WebSphere Application Server

メッセージテキスト
WebSphere Application Server running state is %CVS.

アラームを有効にする
する

すべてのデータを評価する
しない

監視時刻範囲
常に監視する

発生頻度を満たしたときにアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
Eメール
－

コマンド
－

SNMP
異常，警告，正常

条件式
レコード
Server State（PD）

フィールド
State

異常条件
State = 0

警告条件
State = 0

関連レポート

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/Server State/State

Thread Pool

概要

スレッドプールの使用率を監視します。

主な設定

PFM - Web Consoleのアラームのプロパティ

設定値

項目
詳細項目

基本情報
プロダクト
WebSphere Application Server

メッセージテキスト
Thread Pool use rate is %CVS%.

アラームを有効にする
する

すべてのデータを評価する
しない

監視時刻範囲
常に監視する

発生頻度を満たしたときにアラーム通知する
しない

インターバル中
－

回しきい値超過
－

アクション
Eメール
－

コマンド
－

SNMP
異常，警告，正常

条件式
レコード
Thread Pool（THRP）

フィールド
Thread Pool Use %

異常条件
Thread Pool Use % >= 90

警告条件
Thread Pool Use % >= 80

関連レポート

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/Thread Pool/Thread Pool Use Rate

レポートの記載形式

ここでは，レポートの記載形式を示します。レポートは，アルファベット順に記載しています。各レポートの説明は，次の項目から構成されています。

レポート名

監視テンプレートのレポート名を示します。同名のレポートが複数存在する場合は，レポートが表示する情報をレポート名に続けて括弧付きで記載します。

概要

このレポートで表示できる情報の概要について説明します。

格納先

このレポートの格納先を示します。

レコード

このレポートで使用するパフォーマンスデータが格納されているレコードを示します。履歴レポートを表示するためには，この欄に示すレコードを収集するように，あらかじめ設定しておく必要があります。レポートを表示する前に，PFM - Web Consoleの［エージェント階層］画面でエージェントのプロパティを表示して，このレコードが「Log = Yes」に設定されているか確認してください。リアルタイムレポートの場合，設定する必要はありません。

フィールド

このレポートで使用するレコードのフィールドについて，表で説明します。

レポートのフォルダ構成

PFM - Agent for WebSphere Application Serverのレポートのフォルダ構成を次に示します。<　>内は，フォルダ名を示します。

<WebSphere Application Server>
+-- <Monthly Trend>
|   +-- <Advanced>
|       +-- <Java VM>
|       |   +-- JVM Resource Use Rate
|       +-- <Thread Pool>
|       |   +-- Thread Pool Use Rate
|       +-- <JDBC Connection Pool>
|           +-- JDBC Connection Pool Use Rate
+-- <Status Reporting>
|   +-- <Daily Trend>
|   |   +-- <Advanced>
|   |       +-- <Java VM>
|   |       |   +-- JVM Resource Use Rate
|   |       +-- <Thread Pool>
|   |       |   +-- Thread Pool Use Rate
|   |       +-- <JDBC Connection Pool>
|   |           +-- JDBC Connection Pool Use Rate
|   +-- <Real-Time>
|       +-- <Advanced>
|           +-- <Java VM>
|           |   +-- JVM Resource Use Rate
|           +-- <Thread Pool>
|           |   +-- Thread Pool Use Rate
|           +-- <JDBC Connection Pool>
|               +-- JDBC Connection Pool Use Rate
+-- <Troubleshooting>
    +-- <Recent Past>
        +-- <Advanced>
            +-- <Server State>
            |   +-- Server State
            +-- <Java VM>
            |   +-- JVM Resource Use Rate
            +-- <Thread Pool>
            |   +-- Thread Pool Use Rate
            +-- <JDBC Connection Pool>
            |   +-- JDBC Connection Pool Use Rate
            +-- <Servlet>
            |   +-- Service Time
            +-- <EJB>
            |   +-- Method Response Time
            +-- <J2C Connection Pool>
            |   +-- J2C Connection Pool Use Rate
            +-- <Web Service>
            |   +-- Response Time
            +-- <ORB>
                +-- Lookup Time

各フォルダの説明を次に示します。

「Monthly Trend」フォルダ
最近1か月間の1日ごとに集計された情報を表示する履歴レポートが格納されています。1か月のシステムの傾向を分析するために使用します。

「Status Reporting」フォルダ
日ごとに集計された情報を表示するレポートが格納されています。システムの総合的な状態を見るために使用します。また，履歴レポートのほかにリアルタイムレポートの表示もできます。

「Daily Trend」フォルダ
最近24時間の1時間ごとに集計された情報を表示する履歴レポートが格納されています。1日ごとにシステムの状態を確認するために使用します。

「Real-Time」フォルダ
システムの状態を確認するためのリアルタイムレポートが格納されています。

「Troubleshooting」フォルダ
トラブルを解決するのに役立つ情報を表示するレポートが格納されています。システムに問題が発生した場合，問題の原因を調査するために使用します。

「Recent Past」フォルダ
最近1時間の1分ごとに集計された情報を表示する履歴レポートが格納されています。

さらに，これらのフォルダの下位には，次のフォルダがあります。

「Advanced」フォルダ
デフォルトで「Log = No」に設定されているレコードを使用しているレポートが格納されています。このフォルダのレポートを表示するには，使用しているレコードの設定をPFM - Web Consoleで「Log = Yes」にする必要があります。

レポート一覧

PFM - Agent for WebSphere Application Serverの監視テンプレートで定義されているレポートは次のとおりです。

表5-2　レポート一覧

レポートの種類 | レポート名 | 表示する情報
最近１か月間の履歴レポート | Java VM | JVM Resource Use Rate | 最近1か月間のJVMランタイムの使用率。
スレッドプール | Thread Pool Use Rate | 最近1か月間のスレッドプールの使用率。
JDBC接続プール | JDBC Connection Pool Use Rate | 最近1か月間の接続プールの使用率。
状態監視用の最近24時間の履歴レポート | Java VM | JVM Resource Use Rate | 最近24時間のJVMランタイムのメモリー使用率。
スレッドプール | Thread Pool Use Rate | 最近24時間のスレッドプールの使用率。
JDBC接続プール | JDBC Connection Pool Use Rate | 最近24時間の接続プールの使用率。
状態監視用のリアルタイムレポート | Java VM | JVM Resource Use Rate | JVMランタイムのメモリー使用率。
スレッドプール | Thread Pool Use Rate | スレッドプールの使用率。
JDBC接続プール | JDBC Connection Pool Use Rate | 接続プールの使用率。
トラブル解決用の最近1時間の履歴レポート | サーバ | Server State | 最近1時間のWebSphere Application Serverの稼働状態。
Java VM | JVM Resource Use Rate | 最近1時間のJVMランタイムのメモリー使用率。
スレッドプール | Thread Pool Use Rate | 最近1時間のスレッドプールの使用率。
JDBC接続プール | JDBC Connection Pool Use Rate | 最近1時間の接続プールの使用率。
サーブレット | Service Time | 最近1時間のサーブレット要求の平均応答時間。
EJB | Method Response Time | 最近1時間のBeanメソッドの平均応答時間。
J2C接続プール | J2C Connection Pool Use Rate | 最近1時間の接続プールの使用率。
Webサービス | Response Time | 最近1時間のWebサービスの平均応答時間。
オブジェクトリクエストブローカー | Lookup Time | 最近1時間のオブジェクト参照の検索に要した平均時間。

J2C Connection Pool Use Rate（最近1時間の履歴レポート）

概要

J2C Connection Pool Use Rateレポートは，最近1時間の接続プールの使用率について，1分ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/J2C Connection Pool/

レコード

J2C Connection Pool（PI_J2C）

フィールド

フィールド名 | 説明
J2C Connection Pool Name | J2C接続プールの接続ファクトリー名。
Resource Adapter Name | リソースアダプター名。
Connection Pool Use % | 接続プールの使用率（%）。
Connection Count | 使用されている接続数。
Free Connection Count | 使用できる空き接続数。
Waiting Thread Count | 待機中のスレッド数。
Error Count | 接続失敗数。
Wait Time | WebSphere Application Server起動後からのスレッドの平均待機時間（ミリ秒）。
Use Time | WebSphere Application Server起動後からの接続の平均使用時間（ミリ秒）。

JDBC Connection Pool Use Rate（最近1か月間の履歴レポート）

概要

JDBC Connection Pool Use Rateレポートは，最近1か月間の接続プールの使用率について，1日ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Monthly Trend/Advanced/JDBC Connection Pool/

レコード

JDBC Connection Pool（PI_JDBC）

フィールド

フィールド名 | 説明
JDBC Connection Pool Name | JDBC接続プールのデータソース名。
JDBC Provider Name | JDBCプロバイダー名。
Connection Pool Use % | 接続プールの使用率（%）。

JDBC Connection Pool Use Rate（最近24時間の履歴レポート）

概要

JDBC Connection Pool Use Rateレポートは，最近24時間の接続プールの使用率について，1時間ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Status Reporting/Daily Trend/Advanced/JDBC Connection Pool/

レコード

JDBC Connection Pool（PI_JDBC）

フィールド

フィールド名 | 説明
JDBC Connection Pool Name | JDBC接続プールのデータソース名。
JDBC Provider Name | JDBCプロバイダー名。
Connection Pool Use % | 接続プールの使用率（%）。

JDBC Connection Pool Use Rate（リアルタイムレポート）

概要

JDBC Connection Pool Use Rateレポートは，接続プールの使用率をリアルタイムで表示します。

格納先

Reports/WebSphere Application Server/Status Reporting/Real-Time/Advanced/JDBC Connection Pool/

レコード

JDBC Connection Pool（PI_JDBC）

フィールド

フィールド名 | 説明
JDBC Connection Pool Name | JDBC接続プールのデータソース名。
JDBC Provider Name | JDBCプロバイダー名。
Connection Pool Use % | 接続プールの使用率（%）。

JDBC Connection Pool Use Rate（最近1時間の履歴レポート）

概要

JDBC Connection Pool Use Rateレポートは，最近1時間の接続プールの使用率について，1分ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/JDBC Connection Pool/

レコード

JDBC Connection Pool（PI_JDBC）

フィールド

フィールド名 | 説明
JDBC Connection Pool Name | JDBC接続プールのデータソース名。
JDBC Provider Name | JDBCプロバイダー名。
Connection Pool Use % | 接続プールの使用率（%）。
Connection Count | 使用されている接続数。
Free Connection Count | 使用できる空き接続数。
Waiting Thread Count | 待機中のスレッド数。
Error Count | 接続失敗数。
Wait Time | WebSphere Application Server起動後からのスレッドの平均待機時間（ミリ秒）。
Use Time | WebSphere Application Server起動後からの接続の平均使用時間（ミリ秒）。

JVM Resource Use Rate（最近1か月の履歴レポート）

概要

JVM Resource Use Rateレポートは，最近1か月間のJVMランタイムのメモリー使用率について，1日ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Monthly Trend/Advanced/Java VM/

レコード

Java VM（PI_JVM）

フィールド

フィールド名 | 説明
CPU Use % | JVMランタイムのCPU使用率（%）。
Memory Use % | JVMランタイムのメモリー使用率（%）。

JVM Resource Use Rate（最近24時間の履歴レポート）

概要

JVM Resource Use Rateレポートは，最近24時間のJVMランタイムのメモリー使用率について，1時間ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Status Reporting/Daily Trend/Advanced/Java VM/

レコード

Java VM（PI_JVM）

フィールド

フィールド名 | 説明
CPU Use % | JVMランタイムのCPU使用率（%）。
Memory Use % | JVMランタイムのメモリー使用率（%）。

JVM Resource Use Rate（リアルタイムレポート）

概要

JVM Resource Use Rateレポートは，JVMランタイムのメモリー使用率をリアルタイムで表示します。

格納先

Reports/WebSphere Application Server/Status Reporting/Real-Time/Advanced/Java VM/

レコード

Java VM（PI_JVM）

フィールド

フィールド名 | 説明
CPU Use % | JVMランタイムのCPU使用率（%）。
Memory Use % | JVMランタイムのメモリー使用率（%）。

JVM Resource Use Rate（最近1時間の履歴レポート）

概要

JVM Resource Use Rateレポートは，最近1時間のJVMランタイムのメモリー使用率について，1分ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/Java VM/

レコード

Java VM（PI_JVM）

フィールド

フィールド名 | 説明
CPU Use % | JVMランタイムのCPU使用率（%）。
Memory Use % | JVMランタイムのメモリー使用率（%）。
Used Memory | JVMランタイムのメモリー使用量（メガバイト）。
Free Memory | JVMランタイムの空きメモリー量（メガバイト）。
GC Count | ガーベッジコレクションの発生回数。
GC Time | ガーベッジコレクションの所要時間（ミリ秒）。

Lookup Time（最近1時間の履歴レポート）

概要

Lookup Timeレポートは，最近1時間のオブジェクト参照の検索に要した平均時間について，1分ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/ORB/

レコード

ORB（PI_ORB）

フィールド

フィールド名 | 説明
Lookup Time | WebSphere Application Server起動後からのオブジェクト参照の検索に要した平均時間（ミリ秒）。
Request Count | ORBに送信された要求数。
Concurrent Request Count | ORBで同時に処理中の要求数。

Method Response Time（最近1時間の履歴レポート）

概要

Method Response Timeレポートは，最近1時間のBeanメソッドの平均応答時間について，1分ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/EJB/

レコード

EJB（PI_EJB）

フィールド

フィールド名 | 説明
Enterprise Application Name | エンタープライズアプリケーション名。
EJB Name | EJB名。
Method Response Time | WebSphere Application Server起動後からのBeanメソッドの平均応答時間（ミリ秒）。
Method Call Count | Beanメソッドの呼び出し回数。

Response Time（最近1時間の履歴レポート）

概要

Response Timeレポートは，最近1時間のWebサービスの平均応答時間について，1分ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/Web Service/

レコード

Web Service（PI_WEBS）

フィールド

フィールド名 | 説明
WebApplication Name | Webアプリケーション名。
WebService Name | Webサービス名。
Response Time | WebSphere Application Server起動後からのWebサービスへの平均応答時間（ミリ秒）。
Received Request Count | 受信した要求数。
Processed Request Count | 正常に処理した要求数。

Server State（最近1時間の履歴レポート）

概要

Server Stateレポートは，最近1時間のWebSphere Application Serverの稼働状態についての情報を表示します。

格納先

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/Server State/

レコード

Server State（PD）

フィールド

フィールド名
説明

State
WebSphere Application Serverの稼働状態。
稼働している場合は1，それ以外の場合は0。

Service Time（最近1時間の履歴レポート）

概要

Service Timeレポートは，最近1時間のサーブレット要求の平均応答時間について，1分ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/Servlet/

レコード

Servlet（PI_SVLT）

フィールド

フィールド名 | 説明
WebApplication Name | Webアプリケーション名。
Servlet Name | サーブレット名。
Service Time | WebSphere Application Server起動後からのサーブレット要求の平均応答時間（ミリ秒）。
Request Count | サーブレットが処理した要求数。
Concurrent Request Count | サーブレットが同時に処理中の要求数。
Error Count | サーブレットで発生したエラー数。

Thread Pool Use Rate（最近1か月間の履歴レポート）

概要

Thread Pool Use Rateレポートは，最近1か月間のスレッドプールの使用率について，1日ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Monthly Trend/Advanced/Thread Pool/

レコード

Thread Pool（PI_THRP）

フィールド

フィールド名 | 説明
Thread Pool Name | スレッドプール名。
Thread Pool Use % | スレッドプールの最大サイズに対する使用率（%）。

Thread Pool Use Rate（最近24時間の履歴レポート）

概要

Thread Pool Use Rateレポートは，最近24時間のスレッドプールの使用率について，1時間ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Status Reporting/Daily Trend/Advanced/Thread Pool/

レコード

Thread Pool（PI_THRP）

フィールド

フィールド名 | 説明
Thread Pool Name | スレッドプール名。
Thread Pool Use % | スレッドプールの最大サイズに対する使用率（%）。

Thread Pool Use Rate（リアルタイムレポート）

概要

Thread Pool Use Rateレポートは，スレッドプールの使用率をリアルタイムで表示します。

格納先

Reports/WebSphere Application Server/Status Reporting/Real-Time/Advanced/Thread Pool/

レコード

Thread Pool（PI_THRP）

フィールド

フィールド名 | 説明
Thread Pool Name | スレッドプール名。
Thread Pool Use % | スレッドプールの最大サイズに対する使用率（%）。

Thread Pool Use Rate（最近1時間の履歴レポート）

概要

Thread Pool Use Rateレポートは，最近1時間のスレッドプールの使用率について，1分ごとの統計情報を表示します。

格納先

Reports/WebSphere Application Server/Troubleshooting/Recent Past/Advanced/Thread Pool/

レコード

Thread Pool（PI_THRP）

フィールド

フィールド名 | 説明
Thread Pool Name | スレッドプール名。
Thread Pool Use % | スレッドプールの最大サイズに対する使用率（%）。
Thread Pool Size | スレッドプールのサイズ。
Active Thread Count | 使用中のスレッド数。
All Thread Use Time % | すべてのスレッドが使用中である時間の割合（%）。

6.　レコード

この章では，PFM - Agent for WebSphere Application Serverのレコードについて説明します。各レコードのパフォーマンスデータの収集方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」のPerformance Managementの機能について説明している章，または「JP1/Performance Management 運用ガイド」の稼働監視データの管理について説明している章を参照してください。

＜この章の構成＞

データモデルについて

レコードの記載形式

ODBCキーフィールド一覧

要約ルール

データ型一覧

フィールドの値

Storeデータベースに記録されるときだけ追加されるフィールド

Storeデータベースに格納されているデータをエクスポートすると出力されるフィールド

レコード一覧

Server State（PD）

Server Information（PI）

EJB（PI_EJB）

J2C Connection Pool（PI_J2C）

JDBC Connection Pool（PI_JDBC）

Java VM（PI_JVM）

ORB（PI_ORB）

Servlet（PI_SVLT）

Thread Pool（PI_THRP）

Transaction（PI_TRNS）

Web Application（PI_WEBA）

Web Container（PI_WEBC）

Web Service（PI_WEBS）

データモデルについて

各PFM - Agentが持つレコードおよびフィールドの総称を「データモデル」と呼びます。各PFM - Agentと，そのPFM - Agentが持つデータモデルには，それぞれ固有のバージョン番号が付与されています。PFM - Agent for WebSphere Application Serverのデータモデルのバージョンについては，「付録H バージョン互換」を参照してください。

各PFM - Agentのデータモデルのバージョンは，PFM - Web Consoleの［エージェント階層］画面でエージェントのプロパティを表示して確認してください。

データモデルについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の，Performance Managementの機能について説明している章を参照してください。

レコードの記載形式

この章では，PFM - Agent for WebSphere Application Serverのレコードをアルファベット順に記載しています。各レコードの説明は，次の項目から構成されています。

カテゴリー

各レコードが収集する情報の種類を示します。PFM - Agent for WebSphere Application Serverで収集する情報の種類について次に説明します。

サーバの情報
WebSphere Application Serverについてのパフォーマンスデータや，WebSphere Application Serverの状態についての情報を収集します。

Java仮想マシンの情報
Java仮想マシンについてのパフォーマンスデータを収集します。

Webコンテナーの情報
Webコンテナーについてのパフォーマンスデータを収集します。

Webアプリケーションの情報
Webアプリケーションについてのパフォーマンスデータを収集します。

サーブレットの情報
サーブレットについてのパフォーマンスデータを収集します。

EJBの情報
EJBについてのパフォーマンスデータを収集します。

スレッドプールの情報
スレッドプールについてのパフォーマンスデータを収集します。

JDBC接続プールの情報
JDBC接続プールについてのパフォーマンスデータを収集します。

J2C接続プールの情報
J2C接続プールについてのパフォーマンスデータを収集します。

トランザクションの情報
トランザクションについてのパフォーマンスデータを収集します。

Webサービスの情報
Webサービスについてのパフォーマンスデータを収集します。

オブジェクトリクエストブローカーの情報
オブジェクトリクエストブローカーについてのパフォーマンスデータを収集します。

機能

各レコードに格納されるパフォーマンスデータの概要および注意事項について説明します。

デフォルト値および変更できる値

各レコードに設定されているパフォーマンスデータの収集条件のデフォルト値およびユーザーが変更できる値を表で示します。「デフォルト値および変更できる値」に記載している項目とその意味を次の表に示します。この表で示す各項目については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

表6-1　デフォルト値および変更できる値

項目
意味
変更可否

Collection Interval※1
パフォーマンスデータの収集間隔（秒単位）。
○：変更できる
×：変更できない

Collection Offset※2
パフォーマンスデータの収集を開始するオフセット値（秒単位）。オフセット値については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働監視データの管理について説明している章を参照のこと。
また，パフォーマンスデータの収集開始時刻については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，Performance Managementの機能について説明している章を参照のこと。

Log
収集したパフォーマンスデータをStoreデータベースに記録するかどうか。
Yes：記録する。ただし，「Collection Interval=0」の場合，記録しない。
No：記録しない。

LOGIF
収集したパフォーマンスデータをStoreデータベースに記録するかどうかの条件。

注※1

指定できる値は0～2,147,483,647秒です。

注※2

指定できる値は，0～32,767秒（Collection Intervalで指定した値の範囲内）です。これは，複数のデータを収集する場合に，一度にデータの収集処理が実行されると負荷が集中するので，収集処理の負荷を分散するために使用します。なお，データ収集の記録時間は，Collection Offsetの値に関係なく，Collection Intervalと同様の時間となります。

Collection Offsetの値を変更する場合は，収集処理の負荷を考慮した上で値を指定してください。

ODBCキーフィールド

PFM - ManagerまたはPFM - Baseで，SQLを使用してStoreデータベースに格納されているレコードのデータを利用する場合に必要なODBCキーフィールドを示します。ODBCキーフィールドには，全レコード共通のものと各レコード固有のものとがあります。ここで示すのは，各レコード固有のODBCキーフィールドです。複数インスタンスレコードだけが，固有のODBCキーフィールドを持っています。

全レコード共通のODBCキーフィールドについては，この章の「ODBCキーフィールド一覧」を参照してください。ODBCキーフィールドの使用方法については，マニュアル「JP1/Performance Management 運用ガイド」の，ODBC準拠のアプリケーションプログラムと連携した稼働分析について説明している章を参照してください。

ライフタイム

各レコードに収集されるパフォーマンスデータの一貫性が保証される期間を示します。ライフタイムについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の，Performance Managementの機能について説明している章を参照してください。

レコードサイズ

1回の収集で各レコードに格納されるパフォーマンスデータの容量を示します。

フィールド

各レコードのフィールドについて表で説明します。表の各項目について次に説明します。

PFM - View名（PFM - Manager名）

PFM - View名
PFM - Web Consoleで表示されるフィールド名を示します。

PFM - Manager名
PFM - Managerで，SQLを使用してStoreデータベースに格納されているフィールドのデータを利用する場合，SQL文で記述するフィールド名を示します。
SQL文では，先頭に各レコードのレコードIDを付加した形式で記述します。例えば，EJB（PI_EJB）レコードのEJB Name（EJB_NAME）フィールドの場合，「PI_EJB_EJB_NAME」と記述します。

説明
各フィールドに格納されるパフォーマンスデータについて説明します。

要約
Agent Storeがデータを要約するときの方法（要約ルール）を示します。要約ルールについては，この章の「要約ルール」を参照してください。

形式
char型やstring型など，各フィールドの値のデータ型を示します。データ型については，この章の「データ型一覧」を参照してください。

デルタ
累積値として収集するデータに対し，変化量でデータを表すことを「デルタ」と呼びます。デルタについては，この章の「フィールドの値」を参照してください。

データソース
該当するフィールドの値の計算方法または取得先を示します。フィールドの値については，この章の「フィールドの値」を参照してください。

ODBCキーフィールド一覧

ODBCキーフィールドには，全レコード共通のものと各レコード固有のものとがあります。ここで示すのは，全レコード共通のODBCキーフィールドです。PFM - Managerで，SQLを使用してStoreデータベースに格納されているレコードのデータを利用する場合，ODBCキーフィールドが必要です。

各レコード共通のODBCキーフィールド一覧を次の表に示します。各レコード固有のODBCキーフィールドについては，各レコードの説明を参照してください。

表6-2　各レコード共通のODBCキーフィールド一覧

ODBCキーフィールド
ODBCフォーマット
データ
説明

レコードID_DATE
SQL_INTEGER
内部
レコードが生成された日付を表すレコードのキー。

レコードID_DATETIME
SQL_INTEGER
内部
レコードID_DATEフィールドとレコードID_TIMEフィールドの組み合わせ。

レコードID_DEVICEID
SQL_VARCHAR
内部
インスタンス名 ［ホスト名］

レコードID_DRAWER_TYPE
SQL_VARCHAR
内部
区分。有効な値を次に示す。
m：分
H：時
D：日
W：週
M：月
Y：年

レコードID_PROD_INST
SQL_VARCHAR
内部
PFM - Agentのインスタンス名。

レコードID_PRODID
SQL_VARCHAR
内部
PFM - AgentのプロダクトID。

レコードID_RECORD_TYPE
SQL_VARCHAR
内部
レコードタイプを表す識別子（4バイト）。

レコードID_TIME
SQL_INTEGER
内部
レコードが生成された時刻（グリニッジ標準時）。

レコードID_UOWID
SQL_VARCHAR
内部
作業単位の32バイトの固有な識別子。該当しないレコードの場合は，アスタリスク（*）が入ります。

レコードID_UOW_INST
SQL_VARCHAR
内部
作業単位のこのインスタンスの9バイトの固有な識別子。該当しないレコードの場合は，アスタリスク（*）が入ります。

要約ルール

PIレコードタイプのレコードでは，Collection Intervalに設定された間隔で収集されるデータと，あらかじめ定義されたルールに基づき一定の期間（分，時，日，週，月，または年単位）ごとに要約されたデータが，Storeデータベースに格納されます。要約の種類はフィールドごとに定義されています。この定義を「要約ルール」と呼びます。

要約ルールによっては，要約期間中の中間データを保持する必要のあるものがあります。この場合，中間データを保持するためのフィールドがStoreデータベース内のレコードに追加されます。このフィールドを「追加フィールド」と呼びます。追加フィールドの一部は，PFM - Web Consoleでレコードのフィールドとして表示されます。PFM - Web Consoleに表示される追加フィールドは，履歴レポートに表示するフィールドとして使用できます。

なお，要約によって追加される「追加フィールド」と区別するために，ここでは，この章の各レコードの説明に記載されているフィールドを「固有フィールド」と呼びます。

追加フィールドのフィールド名は次のようになります。

Storeデータベースに格納される追加フィールド名
固有フィールドのPFM - Manager名にサフィックスが付加されたフィールド名になります。

PFM - Web Consoleで表示される追加フィールド名
固有フィールドのPFM - View名にサフィックスが付加されたフィールド名になります。

PFM - Manager名に付加されるサフィックスと，それに対応するPFM - View名に付加されるサフィックス，およびフィールドに格納されるデータを次の表に示します。

表6-3　追加フィールドのサフィックス一覧

PFM - Manager名に付加されるサフィックス | PFM - View名に付加されるサフィックス | 格納データ
_TOTAL | (Total) | 要約期間内のレコードのフィールドの値の総和
_TOTAL_SEC | (Total) | 要約期間内のレコードのフィールドの値の総和（utime型の場合）
_COUNT | － | 要約期間内の収集レコード数
_HI | (Max) | 要約期間内のレコードのフィールド値の最大値
_LO | (Min) | 要約期間内のレコードのフィールド値の最小値

（凡例）

－：追加フィールドがないことを示します。

要約ルールを次の表に示します。

表6-4　要約ルール一覧

要約
ルール名
要約ルール

COPY
要約期間内の最新のレコードのフィールド値がそのまま格納される。

AVG
要約期間内のフィールド値の平均値が格納される。
次に計算式を示す。

(フィールド値の総和)/(収集レコード数)

追加フィールド（Storeデータベース）

_TOTAL

_TOTAL_SEC（utime型の場合）

_COUNT

追加フィールド（PFM - Web Console）※1，※2

(Total)

ADD
要約期間内のフィールド値の総和が格納される。

－
要約されないことを示す。

注※1

PFM - Manager名に「_AVG」が含まれるutime型のフィールドは，PFM - Web Consoleに追加される「(Total)」フィールドを履歴レポートで利用できません。

注※2

PFM - Manager名に次の文字列が含まれるフィールドは，PFM - Web Consoleに追加される（Total）フィールドを履歴レポートで利用できません。

「_PER_」，「PCT 」，「PERCENT 」，「_AVG 」，「_RATE_TOTAL 」

データ型一覧

各フィールドの値のデータ型と，対応するCおよびC++のデータ型の一覧を次の表に示します。この表で示す「データ型」の「フィールド」の値は，各レコードのフィールドの表にある「形式」の列に示されています。

表6-5　データ型一覧

データ型
サイズ
（バイト）
説明

フィールド
CおよびC++

char(n)
char( )
( )内の数
nバイトの長さを持つ文字データ。

double
double
8
数値（1.7E±308（15桁））。

float
float
4
数値（3.4E±38（7桁））。

long
long
4
数値（-2,147,483,648～2,147,483,647）。

short
short
2
数値（-32,768～32,767）。

string(n)
char[ ]
( )内の数
nバイトの長さを持つ文字列（7ビットアスキー以外は格納できない）。最後の文字は，「null」。

time_t
unsigned long
4
数値（0～4,294,967,295）。

timeval
構造体
8
数値（最初の4バイトは秒，次の4バイトはマイクロ秒を表す）。

ulong
unsigned long
4
数値（0～4,294,967,295）。

utime
構造体
8
数値（最初の4バイトは秒，次の4バイトはマイクロ秒を表す）。

word
unsigned short
2
数値（0～65,535）。

（該当なし）
unsigned char
1
数値（0～255）。

フィールドの値

ここでは，各フィールドに格納される値について説明します。

データソース

各フィールドには，Performance Managementや監視対象プログラムから取得した値や，これらの値をある計算式に基づいて計算した値が格納されます。各フィールド値の取得先または計算方法は，フィールドの表の「データソース」列で示します。「データソース」列に「－」と書かれている場合，パフォーマンスデータを加工してフィールドの値を設定していないことを示します。

デルタ

累積値として収集するデータに対し，変化量でデータを表すことを「デルタ」と呼びます。例えば，1回目に収集されたパフォーマンスデータが「3」，2回目に収集されたパフォーマンスデータが「4」とすると，変化量として「1」が格納されます。各フィールドの値がデルタ値かどうかは，フィールドの表の「デルタ」列で示します。

PFM - Agent for WebSphere Application Serverで収集されるパフォーマンスデータは，次の表のとおりです。

表6-6　PFM - Agent for WebSphere Application Serverで収集されるパフォーマンスデータ

レコードタイプ
デルタ
データ種別
［デルタ値で表示］のチェック※
レコードの値

PIレコードタイプ
Yes
リアルタイムデータ
あり
変化量が表示される。

なし
収集時点の値が表示される。

・履歴データ
・アラームの監視データ
－
変化量が表示される。

No
リアルタイムデータ
あり
収集時点の値が表示される。

なし
収集時点の値が表示される。

・履歴データ
・アラームの監視データ
－
収集時点の値が表示される。

PDレコードタイプ
Yes
－
－
－

No
リアルタイムデータ
あり
収集時点の値が表示される。

なし
収集時点の値が表示される。

・履歴データ
・アラームの監視データ
－
収集時点の値が表示される。

（凡例）

－：該当しない

注※

次に示すPFM - Web Consoleの項目がチェックされているかどうかを示します。

レポートウィザードの［編集 > 表示設定（リアルタイムレポート）］画面の［デルタ値で表示］

レポートウィンドウの［Properties］タブの［表示設定（リアルタイムレポート）］の［デルタ値で表示］

パフォーマンスデータが収集される際の注意事項を次に示します。

PIレコードタイプの履歴データで，前回の収集データとの差分を必要とするデータ（デルタ）は，Agent Collector起動後の初回の値としては0がStoreデータベースに格納されます。

リアルタイムレポートには，最初にデータが収集されたときから値が表示されます。ただし，前回のデータを必要とするレポートの場合，初回の値は0で表示されます。2回目以降のデータ収集は，レポートによって動作が異なります。

Storeデータベースに記録されるときだけ追加されるフィールド

Storeデータベースに記録されるときだけ追加されるフィールドを次の表に示します。

これらのフィールドの内容をレポートで参照するには，履歴レポートを使用する必要があります。履歴レポートについては，「1.1.1 WebSphere Application Serverのパフォーマンスデータを収集できます」を参照してください。

表6-7　Storeデータベースに記録されるときだけ追加されるフィールド

PFM - View名
（PFM - Manager名）
説明
形式
デルタ
サポートバージョン
データソース

Agent Host
（DEVICEID）
PFM - Agentが動作しているホスト名。
string(256)
No
すべて
－

Agent Instance
（PROD_INST）
PFM - Agentのインスタンス名。
string(256)
No
すべて
－

Agent Type
（PRODID）
PFM - AgentのプロダクトID。1バイトの識別子で表される。
char
No
すべて
－

Date
（DATE）
レコードが作成された日。グリニッジ標準時。※1,※2
char(3)
No
すべて
－

Date and Time
（DATETIME）
Date（DATE）フィールドとTime（TIME）フィールドの組み合わせ。※2
char(6)
No
すべて
－

Drawer Type
（DRAWER_TYPE）
PIレコードタイプのレコードの場合，データが要約される区分。PFM - Web Consoleのレポートで表示する場合とODBCドライバを使用して表示する場合とで，区分の表示が異なる。※3
char
No
すべて
－

GMT Offset
（GMT_ADJUST）
グリニッジ標準時とローカル時間の差。秒単位。
long
No
すべて
－

Time
（TIME）
レコードが作成された時刻。グリニッジ標準時。※1,※2
char(3)
No
すべて
－

（凡例）

－：WindowsまたはUNIXから取得したパフォーマンスデータを加工してフィールドの値を設定していないことを意味します。

注※1

PIレコードタイプのレコードでは，データが要約されるため，要約される際の基準となる時刻が設定されます。レコード区分ごとの設定値を次の表に示します。

表6-8　レコード区分ごとの設定値

区分 | レコード区分ごとの設定値
分 | レコードが作成された時刻の0秒
時 | レコードが作成された時刻の0分0秒
日 | レコードが作成された日の0時0分0秒
週 | レコードが作成された週の月曜日の0時0分0秒
月 | レコードが作成された月の1日の0時0分0秒
年 | レコードが作成された年の1月1日の0時0分0秒

注※2

レポートやODBCドライバによるデータ表示を行った場合，DateフィールドはYYYYMMDD形式で，Date and TimeフィールドはYYYYMMDD hh:mm:ss形式で，Timeフィールドはhh:mm:ss形式で表示されます。

注※3

PFM - Web Consoleのレポートで表示する場合とODBCドライバを使用して表示する場合の違いを次の表に示します。

表6-9　表示方法によるデータ要約区分の違い

区分 | PFM - Web Console | ODBCドライバ
分 | Minute | m
時 | Hour | H
日 | Day | D
週 | Week | W
月 | Month | M
年 | Year | Y

Storeデータベースに格納されているデータをエクスポートすると出力されるフィールド

jpctool db dump (jpcctrl dump)コマンドで，Storeデータベースに格納されているデータをエクスポートすると，次に示すフィールドが出力されます。これらのフィールドも，Storeデータベースに記録されるとき追加されるフィールドですが，PFM - Web Consoleでは表示されないため，レポートに表示するフィールドとして使用できません。これらのフィールドは，PFM - Agentが内部で使用するフィールドなので，運用では使用しないでください。

レコードID_DATE_F

レコードID_DEVICEID_F

レコードID_DRAWER_TYPE_F

レコードID_DRAWER_COUNT

レコードID_DRAWER_COUNT_F

レコードID_INST_SEQ

レコードID_PRODID_F

レコードID_PROD_INST_F

レコードID_RECORD_TYPE

レコードID_RECORD_TYPE_F

レコードID_SEVERITY

レコードID_SEVERITY_F

レコードID_TIME_F

レコードID_UOWID

レコードID_UOWID_F

レコードID_UOW_INST

レコードID_UOW_INST_F

レコードID_PFM - Manager名_SEC

レコードID_PFM - Manager名_MSEC

レコード一覧

PFM - Agent for WebSphere Application Serverで収集できるレコードおよびそのレコードに格納される情報を，カテゴリー別に次の表に示します。

表6-10　PFM - Agent for WebSphere Application Serverのレコード一覧（カテゴリー別）

カテゴリー | レコード名 | レコードID | 格納される情報
サーバの情報 | Server State | PD | WebSphere Application Serverの状態についての，ある時点での情報。
Server Information | PI | WebSphere Application Serverについての，ある一定の時間を単位としたパフォーマンスデータ。
Java仮想マシンの情報 | Java VM | PI_JVM | Java仮想マシンについての，ある一定の時間を単位としたパフォーマンスデータ。
Webコンテナーの情報 | Web Container | PI_WEBC | Webコンテナーについての，ある一定の時間を単位としたパフォーマンスデータ。
Webアプリケーションの情報 | Web Application | PI_WEBA | Webアプリケーションについての，ある一定の時間を単位としたパフォーマンスデータ。
サーブレットの情報 | Servlet | PI_SVLT | サーブレットについての，ある一定の時間を単位としたパフォーマンスデータ。
EJBの情報 | EJB | PI_EJB | EJBについての，ある一定の時間を単位としたパフォーマンスデータ。
スレッドプールの情報 | Thread Pool | PI_THRP | スレッドプールについての，ある一定の時間を単位としたパフォーマンスデータ。
JDBC接続プールの情報 | JDBC Connection Pool | PI_JDBC | JDBC接続プールについての，ある一定の時間を単位としたパフォーマンスデータ。
J2C接続プールの情報 | J2C Connection Pool | PI_J2C | J2C接続プールについての，ある一定の時間を単位としたパフォーマンスデータ。
トランザクションの情報 | Transaction | PI_TRNS | トランザクションについての，ある一定の時間を単位としたパフォーマンスデータ。
Webサービスの情報 | Web Service | PI_WEBS | Webサービスについての，ある一定の時間を単位としたパフォーマンスデータ。
オブジェクトリクエストブローカーの情報 | ORB | PI_ORB | オブジェクトリクエストブローカーについての，ある一定の時間を単位としたパフォーマンスデータ。

Server State（PD）

カテゴリー

サーバの情報

機能

Server State（PD）レコードには，WebSphere Application Serverの状態についての，ある時点での情報が格納されます。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

なし

レコードサイズ

固定部：683バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「PD」。
－
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
－
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
－
ulong
No
－

State
（STATE）
WebSphere Application Serverの稼働状態。稼働している場合は1，それ以外の場合は0。
－
short
No
－

Server Information（PI）

カテゴリー

サーバの情報

機能

Server Information（PI）レコードには，WebSphere Application Serverの概要についての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

WebSphere Application Serverのバージョンが6.0の場合，次に示すフィールドの値は無効な値として常に「0」になります。
・Dynamic Cache Hit %

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | Yes | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

WebSphere Application Serverの起動から停止までです。

レコードサイズ

固定部：701バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「PI」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

Dynamic Cache Hit %
（DYNAMIC_CACHE_HIT_PERCENT）
WebSphere Application Server起動後からの動的キャッシュのキャッシュヒット率（％）。※1
AVG
double
No
(HitsInMemoryCount(Count) + HitsOnDiskCount(Count)) / ClientRequestCount(Count)＊100※2

注※1

ディスクオフロードを有効にしている場合は，ディスクからのキャッシュヒット率も含みます。

注※2

PMIモジュール（リソースカテゴリー）「動的キャッシュ」のカウンターです。括弧内は統計タイプの属性です。

EJB（PI_EJB）

カテゴリー

EJBの情報

機能

EJB（PI_EJB）レコードには，EJBについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PI_EJB_ENTERPRISE_APPLICATION_NAME

ライフタイム

アプリケーションの始動から停止までです。

レコードサイズ

固定部：681バイト

可変部：544バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「EJB」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

Enterprise Application Name
（ENTERPRISE_APPLICATION_NAME）
エンタープライズアプリケーション名。
COPY
string(257)
No
－

EJB Name
（EJB_NAME）
EJB名。
COPY
string(257)
No
－

EJB Type
（EJB_TYPE）
EJBの種類。識別子は次のとおり。
L：Stateless Session Bean
F：Stateful Session Bean
E：Entity Bean
M：Message-driven Bean
COPY
string(2)
No
－

Method Response Time
（METHOD_RESPONSE_TIME）
WebSphere Application Server起動後からのBeanメソッドの平均応答時間（ミリ秒）。
AVG
double
No
MethodResponseTime(Total) / MethodResponseTime(Count)※

Method Call Count
（METHOD_CALL_COUNT）
Beanメソッドの呼び出し回数。
ADD
double
Yes
MethodCallCount(Count)※

注※

PMIモジュール（リソースカテゴリー）「EnterpriseBean」のカウンターです。括弧内は統計タイプの属性です。

J2C Connection Pool（PI_J2C）

カテゴリー

J2C接続プールの情報

機能

J2C Connection Pool（PI_J2C）レコードには，J2C接続プールについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

J2C接続プールの最大接続数を「なし（0）」としている場合，次に示すフィールドの値は無効な値として常に「0」になります。
・Connection Pool Use %

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PI_J2C_J2_C_CONNECTION_POOL_NAME

ライフタイム

WebSphere Application Serverの起動から停止までです。

レコードサイズ

固定部：681バイト

可変部：626バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「J2C」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

J2C Connection Pool Name
（J2_C_CONNECTION_POOL_NAME）
J2C接続プールの接続ファクトリー名。
COPY
string(257)
No
－

Resource Adapter Name
（RESOURCE_ADAPTER_NAME）
リソースアダプター名。
COPY
string(257)
No
－

Connection Pool Use %
（CONNECTION_POOL_USE_PERCENT）
接続プールの使用率（%）。
AVG
double
No
PercentUsed(Current)※

Connection Count
（CONNECTION_COUNT）
使用されている接続数。
AVG
ulong
No
PoolSize(Current) - FreePoolSize(Current)※

Free Connection Count
（FREE_CONNECTION_COUNT）
使用できる空き接続数。
AVG
ulong
No
FreePoolSize(Current)

Waiting Thread Count
（WAITING_THREAD_COUNT）
待機中のスレッド数。
AVG
ulong
No
WaitingThreadCount(Current)※

Error Count
（ERROR_COUNT）
接続失敗数。
ADD
ulong
Yes
FaultCount(Count)※

Wait Time
（WAIT_TIME）
WebSphere Application Server起動後からのスレッドの平均待機時間（ミリ秒）。
AVG
double
No
WaitTime(Total) / WaitTime(Count)※

Use Time
（USE_TIME）
WebSphere Application Server起動後からの接続の平均使用時間（ミリ秒）。
AVG
double
No
UseTime(Total) / UseTime(Count)※

注※

PMIモジュール（リソースカテゴリー）「J2C接続プール」のカウンターです。括弧内は統計タイプの属性です。

JDBC Connection Pool（PI_JDBC）

カテゴリー

JDBC接続プールの情報

機能

JDBC Connection Pool（PI_JDBC）レコードには，JDBC接続プールについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

JDBC接続プールの最大接続数を「なし（0）」としている場合，次に示すフィールドの値は無効な値として常に「0」になります。
・Connection Pool Use %

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PI_JDBC_JDBC_CONNECTION_POOL_NAME

ライフタイム

WebSphere Application Serverの起動から停止までです。

レコードサイズ

固定部：681バイト

可変部：626バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「JDBC」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

JDBC Connection Pool Name
（JDBC_CONNECTION_POOL_NAME）
JDBC接続プールのデータソース名。
COPY
string(257)
No
－

JDBC Provider Name
（JDBC_PROVIDER_NAME）
JDBCプロバイダー名。
COPY
string(257)
No
－

Connection Pool Use %
（CONNECTION_POOL_USE_PERCENT）
接続プールの使用率（%）。
AVG
double
No
PercentUsed(Count)※

Connection Count
（CONNECTION_COUNT）
使用されている接続数。
AVG
ulong
No
PoolSize(Current) - FreePoolSize(Current)※

Free Connection Count
（FREE_CONNECTION_COUNT）
使用できる空き接続数。
AVG
ulong
No
FreePoolSize(Current)

Waiting Thread Count
（WAITING_THREAD_COUNT）
待機中のスレッド数。
AVG
ulong
No
WaitingThreadCount(Current)※

Error Count
（ERROR_COUNT）
接続失敗数。
ADD
ulong
Yes
FaultCount(Count)※

Wait Time
（WAIT_TIME）
WebSphere Application Server起動後からのスレッドの平均待機時間（ミリ秒）。
AVG
double
No
WaitTime(Total) / WaitTime(Count)※

Use Time
（USE_TIME）
WebSphere Application Server起動後からの接続の平均使用時間（ミリ秒）。
AVG
double
No
UseTime(Total) / UseTime(Count)※

注※

PMIモジュール（リソースカテゴリー）「JDBC接続プール」のカウンターです。括弧内は統計タイプの属性です。

Java VM（PI_JVM）

カテゴリー

Java仮想マシンの情報

機能

Java VM（PI_JVM）レコードには，Java仮想マシンについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

JVMプロファイラーが有効になっていない場合，次に示すフィールドの値は無効な値として常に「0」になります。
・GC Count
・GC Time

WebSphere Application Serverのバージョンが6.0の場合，次に示すフィールドの値は無効な値として常に「0」になります。
・CPU Use %

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

WebSphere Application Serverの起動から停止までです。

レコードサイズ

固定部：773バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「JVM」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

CPU Use %
（CPU_USE_PERCENT）
JVMランタイムのCPU使用率（%）。
AVG
double
No
ProcessCpuUsage(Count)※

Memory Use %
（MEMORY_USE_PERCENT）
JVMランタイムのメモリー使用率（%）。
AVG
double
No
UsedMemory(Count) / HeapSize(UpperBound)＊100※

Used Memory
（USED_MEMORY）
JVMランタイムのメモリー使用量（メガバイト）。
AVG
double
No
UsedMemory(Count) / 1,024※

Free Memory
（FREE_MEMORY）
JVMランタイムの空きメモリー量（メガバイト）。
AVG
double
No
FreeMemory(Count) / 1,024※

GC Count
（GC_COUNT）
ガーベッジコレクションの発生回数。
ADD
ulong
Yes
GCCount(Count)※

GC Time
（GC_TIME）
ガーベッジコレクションの所要時間（ミリ秒）。
ADD
double
Yes
GCTime(Total)※

注※

PMIモジュール（リソースカテゴリー）「Java仮想マシン」のカウンターです。括弧内は統計タイプの属性です。

ORB（PI_ORB）

カテゴリー

オブジェクトリクエストブローカーの情報

機能

ORB（PI_ORB）レコードには，オブジェクトリクエストブローカーについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

WebSphere Application Serverの起動から停止までです。

レコードサイズ

固定部：721バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「ORB」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

Lookup Time
（LOOKUP_TIME）
WebSphere Application Server起動後からのオブジェクト参照の検索に要した平均時間（ミリ秒）。
AVG
double
No
LookupTime(Total) / LookupTime(Count)※

Request Count
（REQUEST_COUNT）
ORBに送信された要求数。
ADD
ulong
Yes
RequestCount(Count)※

Concurrent Request Count
（CONCURRENT_REQUEST_COUNT）
ORBで同時に処理中の要求数。
AVG
ulong
No
ConcurrentRequestCount(Current)※

注※

PMIモジュール（リソースカテゴリー）「オブジェクトリクエストブローカー」のカウンターです。括弧内は統計タイプの属性です。

Servlet（PI_SVLT）

カテゴリー

サーブレットの情報

機能

Servlet（PI_SVLT）レコードには，サーブレットについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PI_SVLT_WEB_APPLICATION_NAME

PI_SVLT_SERVLET_NAME

ライフタイム

アプリケーションの始動から停止までです。

レコードサイズ

固定部：681バイト

可変部：558バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「SVLT」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

WebApplication Name
（WEB_APPLICATION_NAME）
Webアプリケーション名。
COPY
string(257)
No
－

Servlet Name
（SERVLET_NAME）
サーブレット名。
COPY
string(257)
No
－

Request Count
（REQUEST_COUNT）
サーブレットが処理した要求数。
ADD
ulong
Yes
RequestCount (Count)※

Concurrent Request Count
（CONCURRENT_REQUEST_COUNT）
サーブレットが同時に処理中の要求数。
AVG
ulong
No
ConcurrentRequests(Count)※

Error Count
（ERROR_COUNT）
サーブレットで発生したエラー数。
ADD
ulong
Yes
ErrorCount(Count)※

Service Time
（SERVICE_TIME）
WebSphere Application Server起動後からのサーブレット要求の平均応答時間（ミリ秒）。
AVG
double
No
ServiceTime(Total) / ServiceTime(Count)※

注※

PMIモジュール（リソースカテゴリー）「Webアプリケーション」のカウンターです。括弧内は統計タイプの属性です。

Thread Pool（PI_THRP）

カテゴリー

スレッドプールの情報

機能

Thread Pool（PI_THRP）レコードには，スレッドプールについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PI_THRP_THREAD_POOL_NAME

ライフタイム

WebSphere Application Serverの起動から停止までです。

レコードサイズ

固定部：681バイト

可変部：329バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「THRP」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

Thread Pool Name
（THREAD_POOL_NAME）
スレッドプール名。
COPY
string(257)
No
－

Thread Pool Use %
（THREAD_POOL_USE_PERCENT）
スレッドプールの最大サイズに対する使用率（%）。
AVG
double
No
PoolSize(Current) / PoolSize(UpperBound)＊100※

Thread Pool Size
（THREAD_POOL_SIZE）
スレッドプールのサイズ。
AVG
ulong
No
PoolSize(Current)※

Active Thread Count
（ACTIVE_THREAD_COUNT）
使用中のスレッド数。
AVG
ulong
No
ActiveCount(Current)※

All Thread Use Time %
（ALL_THREAD_USE_TIME_PERCENT）
すべてのスレッドが使用中である時間の割合（%）。
AVG
double
No
PercentMaxed(Current)※

注※

PMIモジュール（リソースカテゴリー）「スレッドプール」のカウンターです。括弧内は統計タイプの属性です。

Transaction（PI_TRNS）

カテゴリー

トランザクションの情報

機能

Transaction（PI_TRNS）レコードには，トランザクションについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

WebSphere Application Serverの起動から停止までです。

レコードサイズ

固定部：689バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「TRNS」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

Commit Count
（COMMIT_COUNT）
グローバルトランザクションのコミット数。
ADD
ulong
Yes
CommittedCount(Count)※

Rollback Count
（ROLLBACK_COUNT）
グローバルトランザクションのロールバック数。
ADD
ulong
Yes
RolledbackCount(Count)※

注※

PMIモジュール（リソースカテゴリー）「トランザクション」のカウンターです。括弧内は統計タイプの属性です。

Web Application（PI_WEBA）

カテゴリー

Webアプリケーションの情報

機能

Web Application（PI_WEBA）レコードには，Webアプリケーションについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PI_WEBA_WEB_APPLICATION_NAME

ライフタイム

アプリケーションの始動から停止までです。

レコードサイズ

固定部：681バイト

可変部：281バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「WEBA」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

WebApplication Name
（WEB_APPLICATION_NAME）
Webアプリケーション名。
COPY
string(257)
No
－

Request Count
（REQUEST_COUNT）
Webアプリケーションが処理した要求数。
ADD
ulong
Yes
RequestCount(Count)※1

Error Count
（ERROR_COUNT）
Webアプリケーションで発生したエラー数。
ADD
ulong
Yes
ErrorCount(Count)※1

Session Count
（SESSION_COUNT）
Webアプリケーションのセッション数。
AVG
ulong
No
LiveCount(Current)※2

注※1

PMIモジュール（リソースカテゴリー）「Webアプリケーション」（各Webアプリケーション当たりの値）のカウンターです。括弧内は統計タイプの属性です。

注※2

PMIモジュール（リソースカテゴリー）「サーブレットセッション」（各Webアプリケーション当たりの値）のカウンターです。括弧内は統計タイプの属性です。

Web Container（PI_WEBC）

カテゴリー

Webコンテナーの情報

機能

Web Container（PI_WEBC）レコードには，Webコンテナーについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

なし

ライフタイム

WebSphere Application Serverの起動から停止までです。

レコードサイズ

固定部：705バイト

可変部：0バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「WEBC」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

Request Count
（REQUEST_COUNT）
Webコンテナーが処理した要求数。
ADD
ulong
Yes
RequestCount(Count)※1

Error Count
（ERROR_COUNT）
Webコンテナーで発生したエラー数。
ADD
ulong
Yes
ErrorCount(Count)※1

Session Count
（SESSION_COUNT）
Webコンテナーのセッション数。
AVG
ulong
No
LiveCount(Current)※2

注※1

PMIモジュール（リソースカテゴリー）「Webアプリケーション」（Webコンテナー当たりの値）のカウンターです。括弧内は統計タイプの属性です。

注※2

PMIモジュール（リソースカテゴリー）「サーブレットセッション」（Webコンテナー当たりの値）のカウンターです。括弧内は統計タイプの属性です。

Web Service（PI_WEBS）

カテゴリー

Webサービスの情報

機能

Web Service（PI_WEBS）レコードには，Webサービスについての，ある一定の時間を単位としたパフォーマンスデータが格納されます。

注意

各フィールドのデータソースに記載されているPMIのカウンターが使用不可となっている場合，フィールドの値は無効な値として常に「0」になります。

デフォルト値および変更できる値

項目 | デフォルト値 | 変更可否
Collection Interval | 60 | ○
Collection Offset | 0 | ○
Log | No | ○
LOGIF | 空白 | ○

ODBCキーフィールド

PI_WEBS_WEB_SERVICE_NAME

ライフタイム

アプリケーションの始動から停止までです。

レコードサイズ

固定部：681バイト

可変部：542バイト

フィールド

PFM - View名
（PFM - Manager名）
説明
要約
形式
デルタ
データソース

Record Type
（INPUT_RECORD_TYPE）
レコード名。常に「WEBS」。
COPY
char(8)
No
－

Record Time
（RECORD_TIME）
レコードが作成された時刻（グリニッジ標準時）。
COPY
time_t
No
－

Interval
（INTERVAL）
前回収集した時刻からの間隔（秒）。
COPY
ulong
No
－

WebApplication Name
（WEB_APPLICATION_NAME）
Webアプリケーション名。
COPY
string(257)
No
－

WebService Name
（WEB_SERVICE_NAME）
Webサービス名。
COPY
string(257)
No
－

Received Request Count
（RECEIVED_REQUEST_COUNT）
受信した要求数。
ADD
ulong
Yes
ReceivedRequestCount(Count)※

Processed Request Count
（PROCESSED_REQUEST_COUNT）
正常に処理した要求数。
ADD
ulong
Yes
ProcessedRequestCount(Count)※

Response Time
（RESPONSE_TIME）
WebSphere Application Server起動後からのWebサービスへの平均応答時間（ミリ秒）。
AVG
double
No
ResponseTime(Total) / ResponseTime(Count)※

注※

PMIモジュール（リソースカテゴリー）「Webサービス」のカウンターです。括弧内は統計タイプの属性です。

7.　メッセージ

この章では，PFM - Agent for WebSphere Application Serverのメッセージ形式，出力先一覧，syslogとWindowsイベントログの一覧，およびメッセージ一覧について説明します。

＜この章の構成＞

7.1　メッセージの形式

7.2　メッセージの出力先一覧

7.3　syslogとWindowsイベントログの一覧

7.4　メッセージ一覧

7.1　メッセージの形式

PFM - Agent for WebSphere Application Serverが出力するメッセージの形式と，マニュアルでの記載形式を示します。

＜この節の構成＞

7.1.1　メッセージの出力形式

7.1.2　メッセージの記載形式

7.1.1　メッセージの出力形式

PFM - Agent for WebSphere Application Serverが出力するメッセージの形式を説明します。メッセージは，メッセージIDとそれに続くメッセージテキストで構成されます。形式を次に示します。

KAVLnnnnn-Yメッセージテキスト

メッセージIDは，次の内容を示しています。

K

システム識別子を示します。

AVL

PFM - Agentのメッセージであることを示します。

nnnnn

メッセージの通し番号を示します。PFM - Agent for WebSphere Application Serverのメッセージ番号は，「14xxx」です。

Y

メッセージの種類を示します。

E：エラー
処理は中断されます。

W：警告
メッセージ出力後，処理は続けられます。

I：情報
ユーザーに情報を知らせます。

Q：応答
ユーザーに応答を促します。

メッセージの種類とsyslogのpriorityレベルとの対応を次に示します。

-E

レベル：LOG_ERR

意味：エラーメッセージ。

-W

レベル：LOG_WARNING

意味：警告メッセージ。

-I

レベル：LOG_INFO

意味：付加情報メッセージ。

-Q

（出力されない）

メッセージの種類とWindowsイベントログの種類との対応を次に示します。

-E

レベル：エラー

意味：エラーメッセージ。

-W

レベル：警告

意味：警告メッセージ。

-I

レベル：情報

意味：付加情報メッセージ。

-Q

（出力されない）

7.1.2　メッセージの記載形式

このマニュアルでのメッセージの記載形式を示します。メッセージテキストで太字になっている部分は，メッセージが表示される状況によって表示内容が変わることを示しています。また，メッセージをメッセージID順に記載しています。記載形式の例を次に示します。

メッセージID

英語メッセージテキスト
日本語メッセージテキスト

メッセージの説明文

(S)

システムの処置を示します。

(O)

メッセージが表示されたときに，オペレーターが取る処置を示します。

参考

システム管理者がオペレーターから連絡を受けた場合は，「8.　トラブルへの対処方法」を参照してログ情報を採取し，初期調査をしてください。

トラブル要因の初期調査をする場合は，OSのログ情報（Windowsイベントログ）や，PFM - Agent for WebSphere Application Serverが出力する各種ログ情報を参照してください。これらのログ情報のトラブル発生時間帯の内容を参照して，トラブルを回避したり，トラブルに対処したりしてください。また，トラブルが発生するまでの操作方法などを記録してください。同時に，できるだけ再現性の有無を確認するようにしてください。

7.2　メッセージの出力先一覧

ここでは，PFM - Agent for WebSphere Application Serverが出力する各メッセージの出力先を一覧で示します。

表中では，出力先を凡例のように表記しています。

（凡例）

○：出力する

－：出力しない

表7-1　PFM - Agent for WebSphere Application Serverのメッセージの出力先一覧

メッセージID | 出力先
syslog | Windowsイベントログ | 共通メッセージログ | JP1システムイベント※1 | エージェントイベント※2
KAVL14000-I | ○ | ○ | ○ | － | －
KAVL14001-I | ○ | ○ | ○ | － | －
KAVL14002-E | ○ | ○ | ○ | － | －
KAVL14003-E | ○ | ○ | ○ | － | －
KAVL14004-E | － | － | ○ | ○ | ○
KAVL14005-E | － | － | ○ | ○ | ○
KAVL14006-E | ○ | ○ | ○ | ○ | ○
KAVL14007-I | － | － | － | ○ | ○
KAVL14008-I | － | － | － | ○ | ○

注※1

JP1システムイベントは，エージェントの状態の変化をJP1/IMに通知するイベントです。JP1システムイベントの詳細については，マニュアル「JP1/Performance Management 運用ガイド」の，統合管理製品（JP1/IM）と連携した稼働監視について説明している章を参照してください。

JP1システムイベントを発行するための前提プログラムを次の表に示します。

表7-2　JP1システムイベントを発行するための前提プログラム

ホスト種別
前提プログラム
バージョン

監視マネージャー
PFM - Manager
09-00以降

監視コンソールサーバ
PFM - Web Console
08-00以降

監視エージェント
PFM - Agent for WebSphere Application Server
08-00以降
（PFM - Agentが出力するイベントを発行するには，09-00以降が必要です）

PFM - ManagerまたはPFM - Base
09-00以降

JP1/Base
08-50以降

注※2

エージェントイベントは，エージェントの状態の変化をPFM - Managerに通知するイベントです。エージェントイベントの詳細については，マニュアル「JP1/Performance Management 運用ガイド」の，イベントの表示について説明している章を参照してください。

エージェントイベントを発行するための前提プログラムを次の表に示します。

表7-3　エージェントイベントを発行するための前提プログラム

ホスト種別 | 前提プログラム | バージョン
監視マネージャー | PFM - Manager | 09-00以降
監視コンソールサーバ | PFM - Web Console | 08-00以降
監視エージェント | PPFM - Agent for WebSphere Application Server | 09-00以降
PFM - ManagerまたはPFM - Base | 09-00以降

7.3　syslogとWindowsイベントログの一覧

ここでは，PFM - Agent for WebSphere Application ServerがsyslogとWindowsイベントログに出力するメッセージ情報の一覧を示します。

syslogは，syslogファイルに出力されます。syslogファイルの格納場所については，syslogデーモンコンフィギュレーションファイル（デフォルトは /etc/syslogd.conf）を参照してください。

Windowsイベントログは，［イベントビューア］ウィンドウのアプリケーションログに表示されます。

参考

［イベントビューア］ウィンドウは，Windowsの［スタート］メニューから表示される［管理ツール］－［イベントビューア］を選択することで表示できます。

PFM - Agent for WebSphere Application Serverが出力するイベントの場合，［イベントビューア］ウィンドウの［ソース］に識別子「PFM-WAS」が表示されます。

PFM - Agent for WebSphere Application ServerがsyslogとWindowsイベントログに出力するメッセージ情報の一覧を次の表に示します。

表7-4　syslogとWindowsイベントログに出力するメッセージ情報一覧

メッセージID | syslog | Windowsイベントログ
ファシリティ | レベル | イベントID | 種類
KAVL14000-I | LOG_DAEMON | LOG_INFO | 14000 | 情報
KAVL14001-I | LOG_DAEMON | LOG_INFO | 14001 | 情報
KAVL14002-E | LOG_DAEMON | LOG_ERR | 14002 | エラー
KAVL14003-E | LOG_DAEMON | LOG_ERR | 14003 | エラー
KAVL14006-E | LOG_DAEMON | LOG_ERR | 14006 | エラー

7.4　メッセージ一覧

PFM - Agent for WebSphere Application Serverが出力するメッセージと対処方法について説明します。

KAVL14000-I

Agent Collector has started. (host=ホスト名, service=ホスト名<WAS>)
Agent Collectorが起動しました（host=ホスト名, service=ホスト名<WAS>）

Agent Collectorサービスの起動が完了しました。

(S)

WebSphere Application Serverのパフォーマンスデータの収集処理を開始します。

KAVL14001-I

Agent Collector has stopped. (host=ホスト名, service=ホスト名<WAS>)
Agent Collectorが停止しました（host=ホスト名, service=ホスト名<WAS>）

Agent Collectorサービスが正常終了しました。

(S)

Agent Collectorサービスの処理を終了します。

KAVL14002-E

Agent Collector failed to start. (host=ホスト名, service=ホスト名<WAS>)
Agent Collectorの起動に失敗しました（host=ホスト名, service=ホスト名<WAS>）

Agent Collectorサービスの起動処理中にエラーが発生しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

共通メッセージログの内容を確認して原因を調査してください。原因が判明しない場合は，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management 運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL14003-E

Initialization of Agent Collector failed. (host=ホスト名, service=ホスト名<WAS>)
Agent Collectorの初期化に失敗しました（host=ホスト名, service=ホスト名<WAS>）

Agent Collectorサービスの起動処理（初期化）でエラーが発生しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

次の点を確認してください。

Agent Collectorサービス起動情報ファイル（jpcagt.ini）の存在

WebSphere Application Serverがインストールされているかどうか

Java VMオプションファイル（jpcagt2jnijvm.cfg）の存在

Java VM用環境変数ファイル（jpcagt2jnienv.cfg）の存在

インスタンス環境のセットアップ時に設定した値に誤りがないかどうか

インスタンス環境の確認方法については，「2.4.2　インスタンス環境の更新の設定」（Windowsの場合），または「3.4.2　インスタンス環境の更新の設定」（UNIXの場合）を参照してください。

原因が判明しない場合は，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management 運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL14004-E

Agent Collector failed to connect to WebSphere Application Server. (host=ホスト名, service=ホスト名<WAS>)
WebSphere Application Serverへの接続に失敗しました（host=ホスト名, service=ホスト名<WAS>）

WebSphere Application Serverへの接続に失敗しました。

(S)

Agent Collectorサービスの処理を続行します。

(O)

次の点を確認してください。

WebSphere Application Serverが起動されているかどうか

インスタンス環境のセットアップ時に設定した値に誤りがないかどうか

インスタンス環境の確認方法については，「2.4.2　インスタンス環境の更新の設定」（Windowsの場合），または「3.4.2　インスタンス環境の更新の設定」（UNIXの場合）を参照してください。

原因が判明しない場合は，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management 運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL14005-E

An attempt to collect a record failed. (host=ホスト名, service=サービスID, Record=ホスト名<WAS>)
レコードの収集に失敗しました（host=ホスト名, service=サービスID, Record=ホスト名<WAS>）

レコードIDに示されるレコードの収集に失敗しました。

(S)

Agent Collectorサービスの処理を続行します。

(O)

共通メッセージログの内容を確認して原因を調査してください。原因が判明しない場合は，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management 運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL14006-E

Agent Collector stopped abnormally. (host=ホスト名, service=ホスト名<WAS>)
Agent Collectorが異常停止しました（host=ホスト名, service=ホスト名<WAS>）

Agent Collectorサービスが異常終了しました。

(S)

Agent Collectorサービスの処理を終了します。

(O)

共通メッセージログの内容を確認して原因を調査してください。原因が判明しない場合は，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management 運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

KAVL14007-I

Agent Collector succeeded to connect to WebSphere Application Server. (host=ホスト名, service=ホスト名<WAS>, Record=レコードID)
WebSphere Application Serverへの接続に成功しました（host=ホスト名, service=ホスト名<WAS>, Record=レコードID）

WebSphere Application Serverへの接続に失敗していた状態から回復しました。

(S)

Agent Collector サービスの処理を続行します。

KAVL14008-I

An attempt to collect a record succeeded. (host=ホスト名, service=ホスト名<WAS>, Record=レコードID)
レコードの収集に成功しました（host=ホスト名, service=ホスト名<WAS>, Record=レコードID）

レコードIDに示されるレコードの収集に失敗していた状態から回復しました。

(S)

Agent Collector サービスの処理を続行します。

8.　トラブルへの対処方法

この章では，Performance Managementの運用中にトラブルが発生した場合の対処方法などについて説明します。ここでは，主にPFM - Agentでトラブルが発生した場合の対処方法について記載しています。Performance Managementシステム全体のトラブルへの対処方法については，マニュアル「JP1/Performance Management 運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

＜この章の構成＞

8.1　対処の手順

8.2　トラブルシューティング

8.3　ログ情報

8.4　トラブル発生時に採取が必要な資料

8.5　資料の採取方法

8.6　Performance Managementの障害検知

8.7　Performance Managementシステムの障害回復

8.1　対処の手順

Performance Managementでトラブルが起きた場合の対処の手順を次に示します。

現象の確認

次の内容を確認してください。

トラブルが発生したときの現象

メッセージの内容（メッセージが出力されている場合）

共通メッセージログなどのログ情報

各メッセージの要因と対処方法については，「7.　メッセージ」を参照してください。また，Performance Managementが出力するログ情報については，「8.3　ログ情報」を参照してください。

資料の採取

トラブルの要因を調べるために資料の採取が必要です。「8.4　トラブル発生時に採取が必要な資料」および「8.5　資料の採取方法」を参照して，必要な資料を採取してください。

問題の調査

採取した資料を基に問題の要因を調査し，問題が発生している部分，または問題の範囲を切り分けてください。

8.2　トラブルシューティング

ここでは，Performance Management使用時のトラブルシューティングについて記述します。Performance Managementを使用しているときにトラブルが発生した場合，まず，この節で説明している現象が発生していないか確認してください。

Performance Managementに発生する主なトラブルの内容を次の表に示します。

表8-1　トラブルの内容

分類
トラブルの内容
記述個所

セットアップやサービスの起動について

Performance Managementのプログラムのサービスが起動しない

サービスの起動要求をしてからサービスが起動するまで時間が掛かる

Performance Managementのプログラムのサービスを停止した直後に，別のプログラムがサービスを開始したとき，通信が正しく実行されない

「ディスク容量が不足しています」というメッセージが出力されたあとMaster StoreサービスまたはAgent Storeサービスが停止する

8.2.1

コマンドの実行について

jpctool service list (jpcctrl list)コマンドを実行すると稼働していないサービス名が出力される

jpctool db dump (jpcctrl dump)コマンドを実行すると，指定したStoreデータベースと異なるデータが出力される

8.2.2

レポートの定義について

履歴レポートに表示されない時間帯がある

8.2.3

アラームの定義について

アクション実行で定義したプログラムが正しく動作しない

アラームイベントが表示されない

アラームしきい値を超えているのに，エージェント階層の［アラームの状態の表示］画面に表示されているアラームアイコンの色が緑のまま変わらない

8.2.4

パフォーマンスデータの収集と管理について

データの保存期間を短く設定したにもかかわらず，PFM - AgentのStoreデータベースのサイズが小さくならない

共通メッセージログに「Storeデータベースに不正なデータが検出されました」というメッセージが出力される

PFM - Agentを起動してもパフォーマンスデータが収集されない

8.2.5

＜この節の構成＞

8.2.1　セットアップやサービスの起動について

8.2.2　コマンドの実行について

8.2.3　レポートの定義について

8.2.4　アラームの定義について

8.2.5　パフォーマンスデータの収集と管理について

8.2.6　その他のトラブルについて

8.2.1　セットアップやサービスの起動について

セットアップやサービスの起動に関するトラブルの対処方法を次に示します。

＜この項の構成＞

(1)　Performance Managementのプログラムのサービスが起動しない

(2)　サービスの起動要求をしてからサービスが起動するまで時間が掛かる

(3)　Performance Managementのプログラムのサービスを停止した直後に，別のプログラムがサービスを開始したとき，通信が正しく実行されない

(4)　「ディスク容量が不足しています」というメッセージが出力されたあとMaster StoreサービスまたはAgent Storeサービスが停止する

(5)　PFM - AgentのAgent Collectorサービスが起動しない

(1)　Performance Managementのプログラムのサービスが起動しない

考えられる要因およびその対処方法を次に示します。

PFM - Managerが停止している
PFM - ManagerとPFM - Agentが同じホストにある場合，PFM - Managerが停止していると，PFM - Agentサービスは起動できません。PFM - Managerサービスが起動されているか確認してください。PFM - Managerサービスが起動されていない場合は，起動してください。サービスの起動方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

Performance Managementのプログラムの複数のサービスに対して同一のポート番号を設定している
Performance Managementのプログラムの複数のサービスに対して同一のポート番号を設定している場合，Performance Managementのプログラムのサービスは起動できません。デフォルトでは，ポート番号は自動的に割り当てられるため，ポート番号が重複することはありません。Performance Managementのセットアップ時にPerformance Managementのプログラムのサービスに対して固定のポート番号を設定している場合は，ポート番号の設定を確認してください。Performance Managementのプログラムの複数のサービスに対して同一のポート番号を設定している場合は，異なるポート番号を設定し直してください。ポート番号の設定については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

Storeデータベースの格納ディレクトリの設定に誤りがある
次のディレクトリを，アクセスできないディレクトリまたは存在しないディレクトリに設定していると，Agent Storeサービスは起動できません。ディレクトリ名や属性の設定を見直し，誤りがあれば修正してください。

Storeデータベースの格納先ディレクトリ

Storeデータベースのバックアップディレクトリ

Storeデータベースの部分バックアップディレクトリ（Storeバージョン2.0の場合）

Storeデータベースのエクスポート先ディレクトリ

Storeデータベースのインポート先ディレクトリ（Storeバージョン2.0の場合）

また，これらのディレクトリを複数のAgent Storeサービスに対して設定していると，Agent Storeサービスは起動できません。ディレクトリ設定を見直し，誤りがあれば修正してください。

指定された方法以外の方法でマシンのホスト名を変更した
マシンのホスト名の変更方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。指定された方法以外の方法でホスト名を変更した場合，Performance Managementのプログラムのサービスが起動しないことがあります。

サービスコントロールマネージャーでエラーが発生した
Windowsでjpcspm start (jpcstart)コマンドを実行した場合，「Windowsのサービスコントロールマネージャーでエラーが発生しました」というエラーメッセージが出力され，サービスの起動に失敗することがあります。この現象が発生した場合，jpcspm start (jpcstart)コマンドを再実行してください。頻繁に同じ現象が発生する場合は，jpcspm start (jpcstart)コマンド実行時にサービス起動処理がリトライされる間隔および回数を，jpccomm.iniファイルを編集して変更してください。リトライ間隔およびリトライ回数を変更する方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

WebSphere Application Serverがインストールされていない
WebSphere Application Serverがインストールされていない場合，Agent Collectorサービスは起動できません。PFM - AgentホストにWebSphere Application Serverをインストールしてください。

(2)　サービスの起動要求をしてからサービスが起動するまで時間が掛かる

jpcspm start (jpcstart)コマンドを実行してから，または［サービス］アイコンでサービスを開始してから，実際にサービスが起動するまでに時間が掛かることがあります。次の要因で時間が掛かっている場合，2回目の起動時からはサービスの起動までに掛かる時間が短縮されます。

スタンドアロンモードで起動する場合，サービスが起動するまでに時間が掛かることがあります。

システム停止時にサービスを自動で停止させる設定をしないで，システムを再起動してサービスを起動すると，Storeデータベースのインデックスが再構築される場合があります。この場合，サービスが起動するまでに時間が掛かることがあります。

エージェントを新規に追加したあとサービスを起動すると，初回起動時だけStoreデータベースのインデックスが作成されます。そのため，サービスが起動するまでに時間が掛かることがあります。

電源切断などによってStoreサービスが正常な終了処理を行えなかったときは，再起動時にStoreデータベースのインデックスが再構築されるため，Storeサービスの起動に時間が掛かることがあります。

(3)　Performance Managementのプログラムのサービスを停止した直後に，別のプログラムがサービスを開始したとき，通信が正しく実行されない

Performance Managementのプログラムのサービスを停止した直後に，このサービスが使用していたポート番号で，ほかのプログラムがサービスを開始した場合，通信が正しく実行されないことがあります。この現象を回避するために，次の設定をしてください。

Performance Managementのプログラムのサービスに割り当てるポート番号を固定する
Performance Managementのプログラムの各サービスに対して，固定のポート番号を割り当てて運用してください。ポート番号の設定方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

Performance Managementのプログラムのサービスのポート番号を固定しても通信が正しく実行されないときは，次の設定をするとよい場合があります。ただし，システム全体に影響を与えるおそれがあるため，十分に注意して設定してください。

TCP_TIMEWAIT値の設定をする
OSごとに，TCP_TIMEWAIT値で接続待ち時間を設定してください。
AIXの場合，次のように指定して，接続待ち時間を75秒以上にしてください。

AIXの場合：tcp_timewait:5

Windows，Solarisの場合，接続待ち時間をデフォルトの設定としてください。デフォルト値は，次のとおりです。

Solarisの場合：4分

Windows Server 2003の場合：2分

Windows Server 2008の場合：2分

Linuxの場合，接続待ち時間のデフォルト値（60秒）は変更できません。
Performance Managementのプログラムのサービスに割り当てるポート番号を固定する方法で対応してください。

これらの対処を実施したあとも通信が正しく実行されない場合は，保守資料を採取したあと，システム管理者に連絡してください。保守資料の採取方法については，マニュアル「JP1/Performance Management 運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

(4)　「ディスク容量が不足しています」というメッセージが出力されたあとMaster StoreサービスまたはAgent Storeサービスが停止する

Storeデータベースが使用しているディスクに十分な空き容量がない場合，Storeデータベースへのデータの格納が中断されます。この場合，「ディスク容量が不足しています」というメッセージが出力されたあと，Master StoreサービスまたはAgent Storeサービスが停止します。

このメッセージが表示された場合，次のどちらかの方法で対処してください。

十分なディスク容量を確保する
Storeデータベースのディスク占有量を見積もり，Storeデータベースの格納先を十分な容量があるディスクに変更してください。Storeデータベースのディスク占有量を見積もる方法については，「付録A システム見積もり」を参照してください。Storeデータベースの格納先を変更する方法については，「2.4.1 パフォーマンスデータの格納先の変更」（Windowsの場合）または「3.4.1 パフォーマンスデータの格納先の変更」（UNIXの場合）を参照してください。

Storeデータベースの保存条件を変更する
Storeデータベースの保存条件を変更し，Storeデータベースのデータ量の上限値を調整してください。Storeデータベースの保存条件を変更する方法については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

これらの対処を実施したあともMaster StoreサービスまたはAgent Storeサービスが起動されない場合，Storeデータベースに回復できない論理矛盾が発生しています。この場合，バックアップデータからStoreデータベースをリストアしたあと，Master StoreサービスまたはAgent Storeサービスを起動してください。利用できるバックアップデータが存在しない場合は，Storeデータベースを初期化したあと，Master StoreサービスまたはAgent Storeサービスを起動してください。Storeデータベースを初期化するには，Storeデータベースの格納先ディレクトリにある次のファイルをすべて削除してください。

拡張子が.DBであるファイル

拡張子が.IDXであるファイル

Storeデータベースの格納先ディレクトリについては，「2.4.1　パフォーマンスデータの格納先の変更」（Windowsの場合）または「3.4.1　パフォーマンスデータの格納先の変更」（UNIXの場合）を参照してください。

(5)　PFM - AgentのAgent Collectorサービスが起動しない

PFM - AgentホストがWindowsの場合，PFM - Agentの起動時にAgent Collectorサービスの起動に失敗して，Windowsの再起動時，Windowsのイベントログに次のどちらかのメッセージが出力されることがあります。

「サービス名サービスは起動時に停止しました。」

「サービス名サービスは開始時にハングしました。」

この現象は，Windowsのサービスコントロールマネージャのタイムアウトによって発生するため，PFM - Managerへの通信負荷が高く，PFM - Managerからの応答に時間が掛かるときに発生しやすくなります。次の条件にすべて該当する場合に発生します。

JP1/PFM - Managerへの通信負荷が高い
例えば，多数のPFM - Agentの起動処理が同時に実行されている場合などが該当します。

PFM - Agentの各サービスについて，Windowsの［サービス］アプレットでスタートアップ種別が「自動」に設定されている

OSを再起動する

この現象を回避するためには，次のどちらかの設定をして運用してください。

OSの再起動と同時にサービスを起動する場合，Windowsのサービスコントロールマネージャから起動するのではなく，jpcspm startコマンドを実行して起動する

PFM - Agentホストで次の設定を行って，PFM - Agentの起動時間を短縮する
この設定で，PFM - Agentのサービスの起動時に，PFM - Managerに接続できない場合の再接続処理が短縮されます。この場合，PFM - Agentのサービスがスタンドアロンモードで起動する確率が高くなります。
PFM - Agentの起動時間を短縮するには，起動情報ファイル（jpccomm.ini）の［Agent Collector x Section］※および［Agent Store x Section］※の「NS Init Retry Count」ラベルを，「NS Init Retry Count =2」から「NS Init Retry Count =1」に変更します。

注※

「x」には，PFM - AgentのプロダクトIDが入ります。プロダクトIDについては，「付録C　識別子一覧」を参照してください。同一ホスト上にPFM - Agentが複数インストールされている場合は，それぞれのプロダクトIDごとに「NS Init Retry Count」ラベルの値を設定してください。

起動情報ファイル（jpccomm.ini）の格納先は，次のとおりです。

PFM - Agentホストが物理ホストの場合

インストール先フォルダ¥jpccomm.ini

PFM - Agentホストが論理ホストの場合

環境ディレクトリ※¥jp1pc¥jpccomm.ini

注※

論理ホスト作成時に指定した共有ディスク上のディレクトリを示します。

8.2.2　コマンドの実行について

Performance Managementのコマンドの実行に関するトラブルの対処方法を次に示します。

＜この項の構成＞

(1)　jpctool service list (jpcctrl list)コマンドを実行すると稼働していないサービス名が出力される

(2)　jpctool db dump (jpcctrl dump)コマンドを実行すると，指定したStoreデータベースと異なるデータが出力される

(1)　jpctool service list (jpcctrl list)コマンドを実行すると稼働していないサービス名が出力される

考えられる要因およびその対処方法を次に示します。

Performance Managementのプログラムのサービス情報を削除しないでPerformance Managementのプログラムをアンインストールした
Performance ManagementのプログラムをアンインストールしてもPerformance Managementのプログラムのサービス情報はデータベースに残っています。jpctool service delete (jpcctrl delete)コマンドを実行して，Performance Managementのプログラムのサービス情報を削除してください。サービス情報の削除方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

Performance Managementのプログラムのサービス情報を削除しないでマシンのホスト名を変更した
Performance Managementのプログラムのサービス情報を削除しないでマシンのホスト名を変更した場合，以前のホスト名が付加されているサービスIDのサービス情報が，Master Managerサービスが管理しているデータベースに残っています。jpctool service delete (jpcctrl delete)コマンドを実行して，Performance Managementのプログラムのサービス情報を削除してください。サービス情報の削除方法，およびホスト名の変更方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

(2)　jpctool db dump (jpcctrl dump)コマンドを実行すると，指定したStoreデータベースと異なるデータが出力される

同じMaster StoreサービスまたはAgent Storeサービスに対して，同じエクスポートファイル名を指定して，複数回jpctool db dump (jpcctrl dump)コマンドを実行すると，先に実行した出力結果があとから実行された実行結果に上書きされます。同じMaster StoreサービスまたはAgent Storeサービスに対して，複数回jpctool db dump (jpcctrl dump)コマンドを実行する場合は，異なる名称のエクスポートファイルを指定してください。Storeデータベースのエクスポート方法については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働監視データの管理について説明している章を参照してください。

8.2.3　レポートの定義について

Performance Managementのレポートの定義に関するトラブルの要因を次に示します。

＜この項の構成＞

(1)　履歴レポートに表示されない時間帯がある

(1)　履歴レポートに表示されない時間帯がある

PFM - Agentがインストールされたマシンの現在時刻を，現在時刻よりも未来の時刻に変更した場合，変更前の時刻から変更後の時刻までの履歴情報は保存されません。

8.2.4　アラームの定義について

Performance Managementのアラームの定義に関するトラブルの対処方法を次に示します。

＜この項の構成＞

(1)　アクション実行で定義したプログラムが正しく動作しない

(2)　アラームイベントが表示されない

(3)　アラームしきい値を超えているのに，エージェント階層の［アラームの状態の表示］画面に表示されているアラームアイコンの色が緑のまま変わらない

(1)　アクション実行で定義したプログラムが正しく動作しない

考えられる要因とその対処方法を次に示します。

PFM - Managerまたはアクション実行先ホストのAction Handlerサービスが起動されていない
PFM - Managerまたはアクション実行先ホストのAction Handlerサービスが停止していると，アクションが実行されません。アクションを実行する場合は，PFM - Managerおよびアクション実行先ホストのAction Handlerサービスを起動しておいてください。

(2)　アラームイベントが表示されない

考えられる要因とその対処方法を次に示します。

PFM - Managerが起動されていない
PFM - Managerを停止すると，PFM - Agentからのアラームイベントを正しく発行できません。アラームイベントを監視する場合は，PFM - Managerを起動しておいてください。

(3)　アラームしきい値を超えているのに，エージェント階層の［アラームの状態の表示］画面に表示されているアラームアイコンの色が緑のまま変わらない

考えられる要因とその対処方法を次に示します。

PFM - ManagerホストおよびPFM - AgentホストのLANG環境変数が日本語にそろっていない環境で，日本語を使用したアラームテーブルをバインドしている
このような場合，日本語を使用したアラームは正常に評価されません。PFM - ManagerホストおよびPFM - AgentホストのLANG環境変数を，日本語にそろえて運用してください。LANG環境変数の設定は共通メッセージログを確認し，最新のサービス起動メッセージが日本語と英語のどちらで出力されているか確認してください。
なお，PFM - Managerホストが英語環境の場合，現在の設定のまま日本語環境に変更すると，既存のアラーム定義が文字化けして削除できなくなります。このため，次の作業を実施してください。

アラーム定義内に日本語を使用したアラームテーブルが必要な場合は，PFM - Web Consoleからすべてエクスポートする。
エクスポートする際に，jpctool alarm export (jpcalarm export)コマンドは使用できません。

アラーム定義内に日本語を使用したアラームテーブルをすべて削除する。

PFM - Managerを停止する。

PFM - ManagerホストのLANG環境変数を日本語に変更する。

PFM - Managerを起動する。

手順1でアラームテーブルをエクスポートした場合は，PFM - Web Consoleまたはjpctool alarm import (jpcalarm import)コマンドを使用して，アラームテーブルをインポートする。

また，日本語および英語の混在環境での，その他の注意事項については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，日本語版と英語版の混在環境での注意事項について記載している章を参照してください。

8.2.5　パフォーマンスデータの収集と管理について

Performance Managementのパフォーマンスデータの収集と管理に関するトラブルの対処方法を次に示します。

＜この項の構成＞

(1)　データの保存期間を短く設定したにもかかわらず，PFM - AgentのStoreデータベースのサイズが小さくならない

(2)　共通メッセージログに「Storeデータベースに不正なデータが検出されました」というメッセージが出力される

(3)　PFM - Agentを起動してもパフォーマンスデータが収集されない

(1)　データの保存期間を短く設定したにもかかわらず，PFM - AgentのStoreデータベースのサイズが小さくならない

Storeバージョン1.0でStoreデータベースのファイル容量がすでに限界に達している場合，データの保存期間を短く設定してもファイルサイズは小さくなりません。この場合，保存期間を短く設定したあと，いったんStoreデータベースをバックアップし，リストアし直してください。

データの保存期間の設定方法については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働監視データの管理について説明している章を参照してください。また，Storeデータベースのバックアップとリストアの方法については，マニュアル「JP1/Performance Management 運用ガイド」の，バックアップとリストアについて説明している章を参照してください。

(2)　共通メッセージログに「Storeデータベースに不正なデータが検出されました」というメッセージが出力される

予期しないサービスの停止またはマシンのシャットダウンによって，Storeデータベースに不整合なデータが発生したおそれがあります。次の方法で対処してください。

Storeデータベースをバックアップしている場合は，Storeデータベースをリストアしてください。

Storeデータベースをバックアップしていない場合は，Agent Storeサービスを停止したあと，対応するデータベースファイル（*.DBファイルおよび*.IDXファイル）を削除し，サービスを再起動してください。

(3)　PFM - Agentを起動してもパフォーマンスデータが収集されない

次の方法で対処してください。

WebSphere Application Serverの起動状態を確認し，停止している場合は起動してください。

インスタンス環境をセットアップしたときの設定を見直してください。
jpcconf inst setup (jpcinssetup)コマンドを実行して，各項目の正しい値を設定し直してください。jpcconf inst setup (jpcinssetup)コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

8.2.6　その他のトラブルについて

トラブルが発生したときの現象を確認してください。メッセージが出力されている場合は，メッセージの内容を確認してください。また，Performance Managementが出力するログ情報については，「8.3　ログ情報」を参照してください。

「8.2.1　セットアップやサービスの起動について」～「8.2.5　パフォーマンスデータの収集と管理について」に示した対処をしても，トラブルが解決できなかった場合，または，これら以外のトラブルが発生した場合，トラブルの要因を調査するための資料を採取し，システム管理者に連絡してください。

採取が必要な資料および採取方法については，「8.4　トラブル発生時に採取が必要な資料」および「8.5　資料の採取方法」を参照してください。

8.3　ログ情報

Performance Managementでトラブルが発生した場合，ログ情報を確認して対処方法を検討します。Performance Managementを運用しているときに出力されるログ情報には，次の4種類があります。

システムログ

共通メッセージログ

稼働状況ログ

トレースログ

ここでは，4種類のログ情報，および各ログ情報に設定できるログオプションについて説明します。

＜この節の構成＞

8.3.1　ログ情報の種類

8.3.2　ログファイルおよびディレクトリ一覧

8.3.1　ログ情報の種類

＜この項の構成＞

(1)　システムログ

(2)　共通メッセージログ

(3)　稼働状況ログ

(4)　トレースログ

(1)　システムログ

システムログとは，システムの状態やトラブルを通知するログ情報のことです。このログ情報は次のログファイルに出力されます。

Windowsの場合
イベントログファイル

UNIXの場合
syslogファイル

出力形式については，マニュアル「JP1/Performance Management リファレンス」の，ログ情報について説明している章を参照してください。

論理ホスト運用の場合の注意事項

Performance Managementのシステムログのほかに，クラスタソフトによるPerformance Managementの制御などを確認するためにクラスタソフトのログが必要です。

(2)　共通メッセージログ

共通メッセージログとは，システムの状態やトラブルを通知するログ情報のことです。システムログよりも詳しいログ情報が出力されます。共通メッセージログの出力先ファイル名やファイルサイズについては，「8.3.2 ログファイルおよびディレクトリ一覧」を参照してください。また，出力形式については，マニュアル「JP1/Performance Management リファレンス」の，ログ情報について説明している章を参照してください。

論理ホスト運用の場合の注意事項

論理ホスト運用のPerformance Managementの場合，共通メッセージログは共有ディスクに出力されます。共有ディスク上にあるログファイルは，フェールオーバーするときにシステムとともに引き継がれるため，メッセージは同じログファイルに記録されます。

(3)　稼働状況ログ

稼働状況ログとは，PFM - Web Consoleが出力するログ情報のことです。稼働状況ログの出力先ファイル名やファイルサイズについては，マニュアル「JP1/Performance Management 運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。また，出力形式については，マニュアル「JP1/Performance Management リファレンス」の，ログ情報について説明している章を参照してください。

(4)　トレースログ

トレースログとは，トラブルが発生した場合に，トラブル発生の経緯を調査したり，各処理の処理時間を測定したりするために採取するログ情報のことです。

トレースログは，Performance Managementのプログラムの各サービスが持つログファイルに出力されます。

論理ホスト運用の場合の注意事項

論理ホスト運用のPerformance Managementの場合，トレースログは共有ディスクに出力されます。共有ディスク上にあるログファイルは，フェールオーバーするときにシステムとともに引き継がれるため，メッセージは同じログファイルに記録されます。

8.3.2　ログファイルおよびディレクトリ一覧

ここでは，Performance Managementから出力されるログ情報について説明します。

Performance Managementが出力するログ情報は次のとおりです。

共通メッセージログ

トレースログ

稼働状況ログの出力先ファイル名やファイルサイズについては，マニュアル「JP1/Performance Management 運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

＜この項の構成＞

(1)　共通メッセージログ

(2)　トレースログ

(1)　共通メッセージログ

ここでは，Performance Managementのログ情報のうち，共通メッセージログについて，ログの出力元であるサービス名または制御名，ログファイル名，およびディスク使用量を，OSごとに表に示します。

表8-2　共通メッセージログのファイル名（Windowsの場合）

ログ情報の種類
出力元
ファイル名
ディスク使用量※1（キロバイト）

共通メッセージログ
Performance Management
インストール先フォルダ¥log¥jpclog{01|02}※2
2,048
(＊2)

インストール先フォルダ¥log¥jpclogw{01|02}※2
2,048
(＊2)

共通メッセージログ（論理ホスト運用の場合）
論理ホスト運用のPerformance Management
環境ディレクトリ※3
¥jp1pc¥log¥jpclog{01|02}※2
2,048
(＊2)

環境ディレクトリ※3
¥jp1pc¥log¥jpclogw{01|02}※2
2,048
(＊2)

注※1

（　）内の数字は，1つのサービスに対して作成されるログファイルの数を示します。例えば，「2,048(＊2)」の場合，ディスク使用量が2,048キロバイトのログファイルが最大で2つ作成されることを示します。この場合，ディスク使用量は合計で4,096キロバイトとなります。

注※2

共通メッセージログのログファイル名には，末尾に「01」または「02」が付加されます。

シーケンシャルファイル（jpclog）方式の場合

ログ情報は，まず，末尾が「01」のログファイルに出力されます。ログファイルのサイズが上限に達すると，ログファイル名の末尾が「01」から「02」に変更され，ファイル名の末尾が「01」のログファイルが新規作成されます。そのあと出力されるログ情報は，末尾が「01」のログファイルに出力されます。すでにファイル名の末尾が「02」のログファイルがある場合は，上書きされます。最新のログは常にファイル名の末尾が「01」のログファイルに出力されます。

ラップアラウンドファイル（jpclogw）方式の場合

ログ情報は，まず，末尾が「01」のログファイルに出力されます。ログファイルのサイズが上限に達すると，ファイル名の末尾が「02」のログファイルが新規作成されます。そのあと出力されるログ情報は，末尾が「02」のログファイルに出力されます。すでにファイル名の末尾が「02」のログファイルがある場合は，一度データをすべて削除し，先頭行からログが出力されます。そのあとログの出力ファイルが交互に入れ替わります。

ログファイルの出力方式については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

注※3

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

表8-3　共通メッセージログのファイル名（UNIXの場合）

ログ情報の種類
出力元
ファイル名
ディスク使用量※1（キロバイト）

共通メッセージログ
Performance Management
/opt/jp1pc/log/jpclog{01|02}※2
2,048
(＊2)

/opt/jp1pc/log/jpclogw{01|02}※2
2,048
(＊2)

共通メッセージログ（論理ホスト運用の場合）
論理ホスト運用のPerformance Management
環境ディレクトリ※3
/jp1pc/log/jpclog{01|02}※2
2,048
(＊2)

環境ディレクトリ※3
/jp1pc/log/jpclogw{01|02}※2
2,048
(＊2)

注※1

（　）内の数字は，1つのサービスに対して作成されるログファイルの数を示します。例えば，「2,048(＊2)」の場合，ディスク使用量が2,048キロバイトのログファイルが最大で2つ作成されることを示します。この場合，ディスク使用量は合計で4,096キロバイトとなります。

注※2

共通メッセージログのログファイル名には，末尾に「01」または「02」が付加されます。

シーケンシャルファイル（jpclog）方式の場合

ログ情報は，まず，末尾が「01」のログファイルに出力されます。ログファイルのサイズが上限に達すると，ログファイル名の末尾が「01」から「02」に変更され，ファイル名の末尾が「01」のログファイルが新規作成されます。そのあと出力されるログ情報は，末尾が「01」のログファイルに出力されます。すでにファイル名の末尾が「02」のログファイルがある場合は，上書きされます。最新のログは常にファイル名の末尾が「01」のログファイルに出力されます。

ラップアラウンドファイル（jpclogw）方式の場合

ログ情報は，まず，末尾が「01」のログファイルに出力されます。ログファイルのサイズが上限に達すると，ファイル名の末尾が「02」のログファイルが新規作成されます。そのあと出力されるログ情報は，末尾が「02」のログファイルに出力されます。すでにファイル名の末尾が「02」のログファイルがある場合は，一度データをすべて削除し，先頭行からログが出力されます。そのあとログの出力ファイルが交互に入れ替わります。

ログファイルの出力方式については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

注※3

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

(2)　トレースログ

ここでは，Performance Managementのログ情報のうち，PFM - Agentのトレースログの出力元であるサービス名または制御名，および格納先ディレクトリ名を，OSごとに表に示します。

表8-4　トレースログの格納先フォルダ名（Windowsの場合）

ログ情報の種類 | 出力元 | フォルダ名
トレースログ | Action Handlerサービス | インストール先フォルダ¥bin¥action¥log¥
Performance Managementコマンド | インストール先フォルダ¥tools¥log¥
Agent Collectorサービス | インストール先フォルダ¥agt2¥agent¥インスタンス名¥log¥
Agent Storeサービス | インストール先フォルダ¥agt2¥store¥インスタンス名¥log¥
Status Serverサービス | インストール先フォルダ¥bin¥statsvr¥log¥
トレースログ（論理ホスト運用の場合） | Action Handlerサービス | 環境ディレクトリ※¥jp1pc¥bin¥action¥log¥
Performance Managementコマンド | 環境ディレクトリ※¥jp1pc¥tools¥log¥
Agent Collectorサービス | 環境ディレクトリ※¥jp1pc¥agt2¥agent¥インスタンス名¥log¥
Agent Storeサービス | 環境ディレクトリ※¥jp1pc¥agt2¥store¥インスタンス名¥log¥

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

表8-5　トレースログの格納先ディレクトリ名（UNIXの場合）

ログ情報の種類 | 出力元 | ディレクトリ名
トレースログ | Action Handlerサービス | /opt/jp1pc/bin/action/log/
Performance Managementコマンド | /opt/jp1pc/tools/log/
Agent Collectorサービス | /opt/jp1pc/agt2/agent/インスタンス名/log/
Agent Storeサービス | /opt/jp1pc/agt2/store/インスタンス名/log/
Status Serverサービス | /opt/jp1pc/bin/statsvr/log/
トレースログ（論理ホスト運用の場合） | Action Handlerサービス | 環境ディレクトリ※/jp1pc/bin/action/log/
Performance Managementコマンド | 環境ディレクトリ※/jp1pc/tools/log/
Agent Collectorサービス | 環境ディレクトリ※/jp1pc/agt2/agent/インスタンス名/log/
Agent Storeサービス | 環境ディレクトリ※/jp1pc/agt2/store/インスタンス名/log/

注※

環境ディレクトリは，論理ホスト作成時に指定した共有ディスク上のディレクトリです。

8.4　トラブル発生時に採取が必要な資料

「8.2 トラブルシューティング」に示した対処をしてもトラブルを解決できなかった場合，トラブルの要因を調べるための資料を採取し，システム管理者に連絡する必要があります。この節では，トラブル発生時に採取が必要な資料について説明します。

Performance Managementでは，採取が必要な資料を一括採取するためのコマンドを用意しています。PFM - Agentの資料を採取するには，jpcrasコマンドを使用します。jpcrasコマンドを使用して採取できる資料については，表中に記号で示しています。

注意

jpcrasコマンドで採取できる資料は，コマンド実行時に指定するオプションによって異なります。コマンドに指定するオプションと採取できる資料については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

論理ホスト運用の場合の注意事項

論理ホスト運用する場合のPerformance Managementのログは，共有ディスクに格納されます。なお，共有ディスクがオンラインになっている場合（Windows），またはマウントされている場合（UNIX）は，jpcrasコマンドで共有ディスク上のログも一括して採取できます。

また，フェールオーバー時の問題を調査するには，フェールオーバーの前後の資料が必要です。このため，実行系と待機系の両方の資料が必要になります。

なお，論理ホスト運用のPerformance Managementの調査には，クラスタソフトの資料が必要です。論理ホスト運用のPerformance Managementは，クラスタソフトから起動や停止を制御されているので，クラスタソフトの動きとPerformance Managementの動きを対比して調査するためです。

＜この節の構成＞

8.4.1　Windowsの場合

8.4.2　UNIXの場合

8.4.1　Windowsの場合

＜この項の構成＞

(1)　OSのログ情報

(2)　Performance Managementの情報

(3)　オペレーション内容

(4)　画面上のエラー情報

(5)　ユーザーダンプ（Windows Server 2008の場合）

(6)　問題レポートの採取（Windows Server 2008の場合）

(7)　その他の情報

(1)　OSのログ情報

OSのログ情報で，採取が必要な情報を次の表に示します。

表8-6　OSのログ情報（Windowsの場合）

情報の種類
概要
デフォルトのファイル名
jpcrasコマンドでの採取

システムログ
Windowsイベントログ
－
○

プロセス情報
プロセスの一覧
－
○

システムファイル
hostsファイル
システムフォルダ¥system32¥drivers¥etc¥hosts
○

servicesファイル
システムフォルダ¥system32¥drivers¥etc¥services
○

OS情報
システム情報
－
○

ネットワークステータス
－
○

ホスト名
－
○

Windowsファイアウォールの情報
－
○

ダンプ情報
ワトソンログファイル※1
システムドライブ¥Documents and Settings¥All Users¥Application Data¥Microsoft¥Dr Watson¥drwtsn32.log※2
システムドライブ¥Documents and Settings¥All Users¥Application Data¥Microsoft¥Dr Watson¥user.dump※2
○

（凡例）

○：採取できる

－：該当しない

注※1

Windows Server 2008では，「ワトソン博士」は「問題のレポートと解決策」に変更されています。

注※2

別のフォルダにログファイルが出力されるように設定している場合は，該当するフォルダから資料を採取してください。

(2)　Performance Managementの情報

Performance Managementに関する次の情報の採取が必要です。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。

Performance Managementの情報を次の表に示します。

表8-7　Performance Managementの情報（Windowsの場合）

情報の種類
概要
デフォルトのファイル名
またはレジストリ
jpcrasコマンドでの採取

共通メッセージログ
Performance Managementから出力されるメッセージログ
（シーケンシャルファイル方式）
インストール先フォルダ¥log¥jpclog{01|02}※1
○

Performance Managementから出力されるメッセージログ
（ラップアラウンドファイル方式）
インストール先フォルダ¥log¥jpclogw{01|02}※1
○

構成情報
各構成情報ファイル
－
○

jpctool service list (jpcctrl list)コマンドの出力結果
－
○

バージョン情報
製品バージョン
－
○

履歴情報
－
○

データベース情報
Agent Storeサービス

Storeバージョン1.0の場合

インストール先フォルダ¥agt2¥store¥インスタンス名¥*.DB

インストール先フォルダ¥agt2¥store¥インスタンス名¥*.IDX

Storeバージョン2.0の場合

インストール先フォルダ¥agt2¥store¥インスタンス名¥STPD

インストール先フォルダ¥agt2¥store¥インスタンス名¥STPL

インストール先フォルダ¥agt2¥store¥インスタンス名¥STPIフォルダ下の次に示すファイル

*.DB

*.IDX

○

トレースログ
Performance Managementのプログラムの各サービスのトレース情報
－※2
○

インストールログ※3
インストール時のメッセージログ
（Windows Server 2003の場合）
%TEMP%¥pfm_inst.log
×

インストール時のメッセージログ
（Windows Server 2008の場合）
システムフォルダ¥TEMP¥HCDINSTフォルダ下の次に示すファイル。

HCDMAIN.LOGおよびHCDMAINn.LOG※4

HCDINST.LOGおよびHCDINSTn.LOG※4

製品形名.LOG

×

（凡例）

○：採取できる

×：採取できない

－：該当しない

注※1

共通メッセージログのログファイル名には，末尾に「01」または「02」が付加されます。

シーケンシャルファイル（jpclog）方式の場合

ログ情報は，まず，末尾が「01」のログファイルに出力されます。ログファイルのサイズが上限に達すると，ログファイル名の末尾が「01」から「02」に変更され，ファイル名の末尾が「01」のログファイルが新規作成されます。そのあと出力されるログ情報は，末尾が「01」のログファイルに出力されます。すでにファイル名の末尾が「02」のログファイルがある場合は，上書きされます。最新のログは常にファイル名の末尾が「01」のログファイルに出力されます。

ラップアラウンドファイル（jpclogw）方式の場合

ログ情報は，まず，末尾が「01」のログファイルに出力されます。ログファイルのサイズが上限に達すると，ファイル名の末尾が「02」のログファイルが新規作成されます。そのあと出力されるログ情報は，末尾が「02」のログファイルに出力されます。すでにファイル名の末尾が「02」のログファイルがある場合は，末尾が「02」のログファイルのデータをすべて削除し，先頭行からログが出力されます。そのあとログの出力ファイルが交互に入れ替わります。

ログファイルの出力方式については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

注※2

トレースログの格納先フォルダについては，「8.3.2(2) トレースログ」を参照してください。

注※3

インストールに失敗した場合に採取してください。

注※4

nは数字を示します。

(3)　オペレーション内容

トラブル発生時のオペレーション内容について，次に示す情報が必要です。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，PFM - ManagerとPFM - Agentの構成など）

再現性の有無

PFM - Web Consoleからログインしている場合は，ログイン時のPerformance Managementユーザー名

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

(4)　画面上のエラー情報

次に示すハードコピーを採取してください。

アプリケーションエラーが発生した場合は，操作画面のハードコピー

エラーメッセージダイアログボックスのハードコピー（詳細ボタンがある場合はその内容を含む）

コマンド実行時にトラブルが発生した場合は，［コマンドプロンプト］ウィンドウまたは［管理者コンソール］ウィンドウのハードコピー

(5)　ユーザーダンプ（Windows Server 2008の場合）

Windows Server 2008でPerformance Managementのプロセスがアプリケーションエラーで停止した場合は，ユーザーダンプを採取してください。

(6)　問題レポートの採取（Windows Server 2008の場合）

Windows Server 2008でPerformance Managementのプロセスがアプリケーションエラーで停止した場合は，問題レポートを採取してください。

(7)　その他の情報

上記以外で必要な情報を次に示します。

Windowsの［イベントビューア］ウィンドウの，［システム］および［アプリケーション］の内容

［アクセサリ］－［システムツール］－［システム情報］の内容

8.4.2　UNIXの場合

＜この項の構成＞

(1)　OSのログ情報

(2)　Performance Managementの情報

(3)　オペレーション内容

(4)　エラー情報

(5)　その他の情報

(1)　OSのログ情報

OSのログ情報で，採取が必要な情報を次の表に示します。

表8-8　OSのログ情報（UNIXの場合）

情報の種類
概要
デフォルトのファイル名
jpcrasコマンドでの採取

システムログ
syslog

Solarisの場合

/var/adm/messages*

AIXの場合

/var/adm/syslog*

Linuxの場合

/var/log/messages*

○※1

プロセス情報
プロセスの一覧
－
○

システムファイル
hostsファイル
/etc/hosts
○

/etc/inet/ipnodes※2
○※3

servicesファイル
/etc/services
○

OS情報
パッチ情報
－
○

カーネル情報
－
○

バージョン情報
－
○

ネットワークステータス
－
○

環境変数
－
○

ホスト名
－
○

ダンプ情報
coreファイル
－
○

（凡例）

○：採取できる

－：該当しない

注※1

デフォルトのパスおよびファイル名以外に出力されるように設定されているシステムでは，収集できません。手動で収集してください。

注※2

/etc/inet/ipnodesファイルはSolarisだけに存在するファイルです。/etc/hostsファイルと一緒に収集してください。

注※3

PFM - Manager 08-50以降またはPFM - Base 08-50以降のjpcrasコマンドだけで収集できます。

(2)　Performance Managementの情報

Performance Managementに関する情報で，採取が必要な情報を次の表に示します。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。

表8-9　Performance Managementの情報（UNIXの場合）

情報の種類
概要
デフォルトのファイル名
jpcrasコマンドでの採取

共通メッセージログ
Performance Managementから出力されるメッセージログ（シーケンシャルファイル方式）
/opt/jp1pc/log/jpclog{01|02}※1
○

Performance Managementから出力されるメッセージログ
（ラップアラウンドファイル方式）
/opt/jp1pc/log/jpclogw{01|02}※1
○

構成情報
各構成情報ファイル
－
○

jpctool service list (jpcctrl list)コマンドの出力結果
－
○

バージョン情報
製品バージョン
－
○

履歴情報
－
○

データベース情報
Agent Storeサービス

Storeバージョン1.0の場合

/opt/jp1pc/agt2/store/インスタンス名/*.DB

/opt/jp1pc/agt2/store/インスタンス名/*.IDX

Storeバージョン2.0の場合

/opt/jp1pc/agt2/store/インスタンス名/STPD

/opt/jp1pc/agt2/store/インスタンス名/STPL

/opt/jp1pc/agt2/store/インスタンス名/STPIディレクトリ下の次に示すファイル。

*.DB

*.IDX

○

トレースログ
Performance Managementのプログラムの各サービスのトレース情報
－※2
○

定義ファイル
アプリケーション定義ファイル

/opt/jp1pc/agt2/agent/jpcapp

○

ユーザー独自のパフォーマンスデータ収集機能の情報
構成情報

/opt/jp1pc/agt2/agent/jpcuser/jpcuser.ini

○

デバッグログ

/opt/jp1pc/agt2/agent/jpcuser/debug/jpcuser_dbg_{01|02|03|04|05}.log

○

トレースログ

/opt/jp1pc/agt2/agent/jpcuser/log/trace/msglog{01|02}

○

パブリックログ

/opt/jp1pc/agt2/agent/jpcuser/log/public/jpclog{01|02}

○

ユーザーデータファイル

/opt/jp1pc/agt2/agent/jpcuser/userdata/jpcuser_{UPI|UPIB|UPD|UPDB}

○

coreダンプファイル※3

/opt/jp1pc/agt2/agent/jpcuser/core

○

インストールログ※4
Hitachi PP Installerの標準ログ
/etc/.hitachi/.hitachi.log
/etc/.hitachi/.hitachi.log{01|02|03|04|05}
/etc/.hitachi/.install.log
/etc/.hitachi/.install.log{01|02|03|04|05}
×

（凡例）

○：採取できる

×：採取できない

－：該当しない

注※1

ログファイルの出力方式については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

注※2

トレースログの格納先ディレクトリについては，「8.3.2　ログファイルおよびディレクトリ一覧」を参照してください。

注※3

HP-UX 11i V3 (IPF)では，coreadmコマンドによってcoreダンプファイルの名称を任意に変更できます。ファイル名の先頭が「core」以外に変更されたファイルについては，jpcrasコマンドでは収集できません。手動で収集してください。

注※4

インストールに失敗した場合に採取してください。

(3)　オペレーション内容

トラブル発生時のオペレーション内容について，次に示す情報が必要です。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，PFM - ManagerとPFM - Agentの構成など）

再現性の有無

PFM - Web Consoleからログインしている場合は，ログイン時のPerformance Managementユーザー名

(4)　エラー情報

次に示すエラー情報を採取してください。

コマンド実行時にトラブルが発生した場合は，コンソールに出力されたメッセージ

(5)　その他の情報

上記以外で必要な情報を次に示します。

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

8.5　資料の採取方法

トラブルが発生したときに資料を採取する方法を次に示します。

＜この節の構成＞

8.5.1　Windowsの場合

8.5.2　UNIXの場合

8.5.1　Windowsの場合

＜この項の構成＞

(1)　ダンプ情報を採取する（Windows Server 2008の場合）

(2)　資料採取コマンドを実行する

(3)　資料採取コマンドを実行する（論理ホスト運用の場合）

(4)　WebSphere Application Serverの情報を採取する

(5)　Windowsイベントログを採取する

(6)　オペレーション内容を確認する

(7)　画面上のエラー情報を採取する

(8)　その他の情報を採取する

(1)　ダンプ情報を採取する（Windows Server 2008の場合）

Windows Server 2008の環境でのダンプ情報の採取手順を次に示します。

タスクマネージャーを開く。

［プロセス］タブを選択する。

ダンプを取得するプロセス名を右クリックし，［ダンプファイルの作成］を選択する。
次のフォルダに，ダンプファイルが格納されます。

システムドライブ¥Users¥ユーザー名¥AppData¥Local¥Temp

手順3のフォルダからダンプファイルを採取する。
手順3と異なるフォルダにダンプファイルが出力されるように環境変数の設定を変更している場合は，変更先のフォルダからダンプファイルを採取してください。

(2)　資料採取コマンドを実行する

トラブルの要因を調べるための資料の採取には，jpcrasコマンドを使用します。資料採取コマンドの実行手順を次に示します。なお，ここで説明する操作は，OSユーザーとしてAdministrators権限を持つユーザーが実行してください。

資料採取するサービスがインストールされているホストにログオンする。

コマンドプロンプトで次に示すコマンドを実行して，コマンドインタープリタの「コマンド拡張機能」を有効にする。

cmd /E:ON

採取する資料および資料の格納先フォルダを指定して，jpcrasコマンドを実行する。
jpcrasコマンドで，採取できるすべての情報をc:¥tmp¥jpc¥agtフォルダに格納する場合の，コマンドの指定例を次に示します。

インストール先フォルダ¥tools¥jpcras c:¥tmp¥jpc¥agt all all

jpcrasコマンドを実行すると，PFMサービスの一覧取得および起動状態の確認のため，内部的にjpctool service list -id * -host * (jpcctrl list * host=*)コマンドが実行されます。コマンド実行ホストとほかのPerformance Managementシステムのホストとの間にファイアウォールが設定されていたり，システム構成が大規模だったりすると，jpctool service list -id * -host * (jpcctrl list * host=*)コマンドの実行に時間が掛かる場合があります。そのような場合は，環境変数JPC_COLCTRLNOHOSTに1を設定することでjpctool service list -id * -host * (jpcctrl list * host=*)コマンドの処理を抑止し，コマンドの実行時間を短縮できます。

jpcrasコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

Windows Server 2008の環境で実行する場合の注意事項

OSのユーザーアカウント制御機能（UAC）を有効にしている場合は，コマンド実行時にユーザーアカウント制御のダイアログボックスが表示されることがあります。ダイアログボックスが表示された場合は，［続行］ボタンをクリックして資料採取を続行します。［キャンセル］ボタンをクリックした場合は，資料採取を中止します。

(3)　資料採取コマンドを実行する（論理ホスト運用の場合）

論理ホスト運用のPerformance Managementの資料は共有ディスクにあり，資料は実行系と待機系の両方で採取する必要があります。

トラブルの要因を調べるための資料の採取には，jpcrasコマンドを使用します。資料採取コマンドの実行手順を次に示します。なお，ここで説明する操作は，OSユーザーとしてAdministrators権限を持つユーザーが実行してください。

共有ディスクをオンラインにする。
論理ホストの資料は共有ディスクに格納されています。実行系ノードでは，共有ディスクがオンラインになっていることを確認して資料を採取してください。

実行系と待機系の両方で，採取する資料および資料の格納先フォルダを指定して，jpcrasコマンドを実行する。
jpcrasコマンドで，採取できるすべての情報をc:¥tmp¥jpc¥agtフォルダに格納する場合の，コマンドの指定例を次に示します。

インストール先フォルダ¥tools¥jpcras c:¥tmp¥jpc¥agt all all

jpcrasコマンドをlhostの引数を指定しないで実行すると，そのノードの物理ホストと論理ホストのPerformance Managementの資料が一とおり採取されます。論理ホスト環境のPerformance Managementがある場合は，共有ディスク上のログファイルが取得されます。
なお，共有ディスクがオフラインになっているノードでjpcrasコマンドを実行すると，共有ディスク上のファイルを取得できませんが，エラーは発生しないで正常終了します。

注意

実行系ノードと待機系ノードの両方で，資料採取コマンドを実行して資料採取をしてください。フェールオーバーの前後の調査をするには，実行系と待機系の両方の資料が必要です。

jpcrasコマンドを実行すると，PFMサービスの一覧取得および起動状態の確認のため，内部的にjpctool service list -id * -host * (jpcctrl list * host=*)コマンドが実行されます。コマンド実行ホストとほかのPerformance Managementシステムのホストとの間にファイアウォールが設定されていたり，システム構成が大規模だったりすると，jpctool service list -id * -host * (jpcctrl list * host=*)コマンドの実行に時間が掛かる場合があります。そのような場合は，環境変数JPC_COLCTRLNOHOSTに1を設定することでjpctool service list -id * -host * (jpcctrl list * host=*)コマンドの処理を抑止し，コマンドの実行時間を短縮できます。
jpcrasコマンドについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

クラスタソフトの資料を採取する。
この資料は，クラスタソフトとPerformance Managementのどちらでトラブルが発生しているのかを調査するために必要になります。クラスタソフトからPerformance Managementへの起動停止などの制御要求と結果を調査できる資料を採取してください。

Windows Server 2008で実行する場合の注意事項

OSのユーザーアカウント制御機能（UAC）を有効にしている場合は，コマンド実行時にユーザーアカウント制御のダイアログボックスが表示されることがあります。ダイアログボックスが表示された場合は，［続行］ボタンをクリックして資料採取を続行してください。［キャンセル］ボタンをクリックした場合は，資料採取が中止されます。

(4)　WebSphere Application Serverの情報を採取する

次のフォルダの下にあるファイルを，サブフォルダ以下も含めてすべて手動で採取してください。

設定ファイル

PFM - Agent for WebSphere Application Serverインストール先フォルダ¥profiles¥プロファイル名¥config¥cells¥セル名¥nodes¥ノード名¥servers¥サーバ名

ログファイル

PFM - Agent for WebSphere Application Serverインストール先フォルダ¥profiles¥プロファイル名¥logs

注意事項

ログファイルの出力先を変更している場合は，出力先に指定したフォルダにあるすべてのファイルを採取してください。

(5)　Windowsイベントログを採取する

Windowsの［イベントビューア］ウィンドウの，［システム］および［アプリケーション］の内容を採取してください。

(6)　オペレーション内容を確認する

トラブル発生時のオペレーション内容を確認し，記録しておいてください。確認が必要な情報を次に示します。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，PFM - ManagerとPFM - Agentの構成など）

再現性の有無

PFM - Web Consoleからログインしている場合は，ログイン時のPerformance Managementユーザー名

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

(7)　画面上のエラー情報を採取する

次に示すハードコピーを採取してください。

アプリケーションエラーが発生した場合は，操作画面のハードコピー

エラーメッセージダイアログボックスのハードコピー
詳細情報がある場合はその内容をコピーしてください。

コマンド実行時にトラブルが発生した場合は，［コマンドプロンプト］ウィンドウまたは［管理者コンソール］ウィンドウのハードコピー
［コマンドプロンプト］ウィンドウまたは［管理者コンソール］ウィンドウのハードコピーを採取する際は，［"コマンドプロンプト"のプロパティ］ウィンドウについて次のように設定しておいてください。

［オプション］タブの［編集オプション］
［簡易編集モード］がチェックされた状態にする。

［レイアウト］タブ
［画面バッファのサイズ］の［高さ］に「500」を設定する。

(8)　その他の情報を採取する

上記以外で必要な情報を採取してください。

［アクセサリ］－［システムツール］－［システム情報］の内容

8.5.2　UNIXの場合

＜この項の構成＞

(1)　資料採取コマンドを実行する

(2)　資料採取コマンドを実行する（論理ホスト運用の場合）

(3)　WebSphere Application Serverの情報を採取する

(4)　オペレーション内容を確認する

(5)　エラー情報を採取する

(6)　その他の情報を採取する

(1)　資料採取コマンドを実行する

トラブルの要因を調べるための資料の採取には，jpcrasコマンドを使用します。資料採取コマンドの実行手順を次に示します。なお，ここで説明する操作は，OSユーザーとしてrootユーザー権限を持つユーザーが実行してください。

資料採取するサービスがインストールされているホストにログインする。

採取する資料および資料の格納先ディレクトリを指定して，jpcrasコマンドを実行する。
jpcrasコマンドで，採取できるすべての情報を/tmp/jpc/agtディレクトリに格納する場合の，コマンドの指定例を次に示します。

/opt/jp1pc/tools/jpcras /tmp/jpc/agt all all

資料採取コマンドで収集された資料は，tarコマンドおよびcompressコマンドで圧縮された形式で，指定されたディレクトリに格納されます。ファイル名を次に示します。
jpcrasYYMMDD.tar.Z
YYMMDDには年月日が付加されます。

jpcrasコマンドを実行すると，PFMサービスの一覧取得および起動状態の確認のため，内部的にjpctool service list -id * -host * (jpcctrl list * host=*)コマンドが実行されます。コマンド実行ホストとほかのPerformance Managementシステムのホストとの間にファイアウォールが設定されていたり，システム構成が大規模だったりすると，jpctool service list -id * -host * (jpcctrl list * host=*)コマンドの実行に時間が掛かる場合があります。そのような場合は，環境変数JPC_COLCTRLNOHOSTに1を設定することでjpctool service list -id * -host * (jpcctrl list * host=*)コマンドの処理を抑止し，コマンドの実行時間を短縮できます。

jpcrasコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

(2)　資料採取コマンドを実行する（論理ホスト運用の場合）

論理ホスト運用のPerformance Managementの資料は共有ディスクにあり，資料は実行系と待機系の両方で採取する必要があります。

トラブルの要因を調べるための資料の採取には，jpcrasコマンドを使用します。資料採取コマンドの実行手順を次に示します。なお，ここで説明する操作は，OSユーザーとしてrootユーザー権限を持つユーザーが実行してください。

共有ディスクをマウントする。
論理ホストの資料は共有ディスクに格納されています。実行系ノードでは，共有ディスクがマウントされていることを確認して資料を採取してください。

実行系と待機系の両方で，採取する資料および資料の格納先ディレクトリを指定して，jpcrasコマンドを実行する。
jpcrasコマンドで，採取できるすべての情報を/tmp/jpc/agtディレクトリに格納する場合の，コマンドの指定例を次に示します。

/opt/jp1pc/tools/jpcras /tmp/jpc/agt all all

資料採取コマンドで収集された資料は，tarコマンドおよびcompressコマンドで圧縮された形式で，指定されたディレクトリに格納されます。ファイル名を次に示します。
jpcrasYYMMDD.tar.Z
YYMMDDには年月日が付加されます。
jpcrasコマンドをlhostの引数を指定しないで実行すると，そのノードの物理ホストと論理ホストのPerformance Managementの資料が一とおり採取されます。論理ホスト環境のPerformance Managementがある場合は，共有ディスク上のログファイルが取得されます。
なお，共有ディスクがマウントされていないノードでjpcrasコマンドを実行すると，共有ディスク上のファイルを取得できませんが，エラーは発生しないで正常終了します。

注意

実行系ノードと待機系ノードの両方で，資料採取コマンドを実行して資料採取をしてください。フェールオーバーの前後の調査をするには，実行系と待機系の両方の資料が必要です。

jpcrasコマンドを実行すると，PFMサービスの一覧取得および起動状態の確認のため，内部的にjpctool service list -id * -host * (jpcctrl list * host=*)コマンドが実行されます。コマンド実行ホストとほかのPerformance Managementシステムのホストとの間にファイアウォールが設定されていたり，システム構成が大規模だったりすると，jpctool service list -id * -host * (jpcctrl list * host=*)コマンドの実行に時間が掛かる場合があります。そのような場合は，環境変数JPC_COLCTRLNOHOSTに1を設定することでjpctool service list -id * -host * (jpcctrl list * host=*)コマンドの処理を抑止し，コマンドの実行時間を短縮できます。
jpcrasコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

クラスタソフトの資料を採取する。
この資料は，クラスタソフトとPerformance Managementのどちらでトラブルが発生しているのかを調査するために必要になります。クラスタソフトからPerformance Managementへの起動停止などの制御要求と結果を調査できる資料を採取してください。

(3)　WebSphere Application Serverの情報を採取する

次のディレクトリの下にあるファイルを，サブディレクトリ以下も含めてすべて手動で採取してください。

設定ファイル

PFM - Agent for WebSphere Application Serverインストール先ディレクトリ/profiles/プロファイル名/config/cells/セル名/nodes/ノード名/servers/サーバ名

ログファイル

PFM - Agent for WebSphere Application Serverインストール先ディレクトリ/profiles/プロファイル名/logs

注意事項

ログファイルの出力先を変更している場合は，出力先に指定したディレクトリにあるすべてのファイルを採取してください。

(4)　オペレーション内容を確認する

トラブル発生時のオペレーション内容を確認し，記録しておいてください。確認が必要な情報を次に示します。

オペレーション内容の詳細

トラブル発生時刻

マシン構成（各OSのバージョン，ホスト名，PFM - ManagerとPFM - Agentの構成など）

再現性の有無

PFM - Web Consoleからログインしている場合は，ログイン時のPerformance Managementユーザー名

(5)　エラー情報を採取する

次に示すエラー情報を採取してください。

コマンド実行時にトラブルが発生した場合は，コンソールに出力されたメッセージ

(6)　その他の情報を採取する

上記以外で必要な情報を採取してください。

コマンド実行時にトラブルが発生した場合は，コマンドに指定した引数

8.6　Performance Managementの障害検知

Performance Managementでは，ヘルスチェック機能を利用することでPerformance Management自身の障害を検知できます。ヘルスチェック機能では，監視エージェントや監視エージェントが稼働するホストの稼働状態を監視し，監視結果を監視エージェントの稼働状態の変化としてPFM - Web Console上に表示します。

また，PFMサービス自動再起動機能を利用することで，PFMサービスが何らかの原因で異常停止した場合に自動的にPFMサービスを再起動したり，定期的にPFMサービスを再起動したりできます。

ヘルスチェック機能によって監視エージェントの稼働状態を監視したり，PFMサービス自動再起動機能によってPFMサービスを自動再起動したりするには，Performance Managementのサービスの詳細な状態を確認するステータス管理機能を使用します。このため，対象となる監視エージェントがステータス管理機能に対応したバージョンであり，ステータス管理機能が有効になっている必要があります。ホストの稼働状態を監視する場合は前提となる条件はありません。

また，Performance Managementのログファイルをシステム統合監視製品であるJP1/Baseで監視することによっても，Performance Management自身の障害を検知できます。これによって，システム管理者は，トラブルが発生したときに障害を検知し，要因を特定して復旧の対処をします。

Performance Management自身の障害検知の詳細については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの障害検知について説明している章を参照してください。

8.7　Performance Managementシステムの障害回復

Performance Managementのサーバで障害が発生したときは，バックアップファイルを基にして，障害が発生する前の正常な状態に回復する必要があります。

障害が発生する前の状態に回復する手順については，マニュアル「JP1/Performance Management 運用ガイド」の，トラブルへの対処方法について説明している章を参照してください。

付録

＜この付録の構成＞

付録A　システム見積もり

付録B　カーネルパラメーター

付録C　識別子一覧

付録D　プロセス一覧

付録E　ポート番号一覧

付録F　PFM - Agent for WebSphere Application Serverのプロパティ

付録G　ファイルおよびディレクトリ一覧

付録H　バージョン互換

付録I　動作ログの出力

付録J　JP1/ITSLMとの連携

付録K　各バージョンの変更内容

付録L　このマニュアルの参考情報

付録M　用語解説

付録A　システム見積もり

PFM - Agent for WebSphere Application Serverを使ったシステムを構築する前に，使用するマシンの性能が，PFM - Agent for WebSphere Application Serverを運用するのに十分であるか，見積もってください。

見積もり項目を次に説明します。

＜この節の構成＞

付録A.1　メモリー所要量

付録A.2　ディスク占有量

付録A.3　クラスタ運用時のディスク占有量

付録A.1　メモリー所要量

メモリー所要量は，PFM - Agent for WebSphere Application Serverの設定状況や使用状況によって変化します。メモリー所要量の見積もり式については，リリースノートを参照してください。

付録A.2　ディスク占有量

ディスク占有量は，パフォーマンスデータを収集するレコード数によって変化します。ディスク占有量の見積もりには，システム全体のディスク占有量，Storeデータベース（Storeバージョン1.0）のディスク占有量，またはStoreデータベース（Storeバージョン2.0）の見積もりが必要になります。これらの見積もり式については，リリースノートを参照してください。

付録A.3　クラスタ運用時のディスク占有量

クラスタ運用時のディスク占有量の見積もりは，クラスタシステムで運用しない場合のディスク占有量の見積もりと同じです。ディスク占有量については，リリースノートを参照してください。

付録B　カーネルパラメーター

PFM - Agent for WebSphere Application Serverでは，カーネルパラメーターの調整は不要です。

なお，UNIX環境でPFM - ManagerおよびPFM - Web Consoleを使用する場合の，カーネルパラメーターの調整については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，付録に記載されているカーネルパラメーター一覧を参照してください。

付録C　識別子一覧

PFM - Agent for WebSphere Application Serverを操作したり，PFM - Agent for WebSphere Application ServerのStoreデータベースからパフォーマンスデータを抽出したりする際，PFM - Agent for WebSphere Application Serverであることを示す識別子が必要な場合があります。PFM - Agent for WebSphere Application Serverの識別子を次の表に示します。

表C-1　PFM - Agent for WebSphere Application Serverの識別子一覧

用途 | 名称 | 識別子 | 説明
コマンドなど | プロダクトID | 2 | プロダクトIDとは，サービスIDの一部。サービスIDは，コマンドを使用してPerformance Managementのシステム構成を確認する場合や，パフォーマンスデータをバックアップする場合などに必要である。サービスIDについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録に記載されている命名規則を参照のこと。
サービスキー | agt2またはWAS | コマンドを使用してPFM - Agent for WebSphere Application Serverを起動する場合や，終了する場合などに必要である。サービスキーについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の，Performance Managementの付録に記載されている命名規則を参照のこと。
ODBC | 製品タイプ識別子 | WAS | SQL文を使用してデータを抽出する場合に必要である。詳細については，マニュアル「JP1/Performance Management 運用ガイド」の，ODBC準拠のアプリケーションプログラムと連携した稼働分析について説明している章を参照のこと。
ヘルプ | ヘルプID | pca2 | PFM - Agent for WebSphere Application Serverのヘルプであることを表す。

付録D　プロセス一覧

ここでは，PFM - Agent for WebSphere Application Serverのプロセス一覧を記載します。

PFM - Manager ，PFM - Base，および PFM - Web Consoleのプロセスについては，マニュアル「JP1/Performance Management リファレンス」の付録を参照してください。PFM - Agent for WebSphere Application Serverのプロセス一覧を次の表に示します。なお，プロセス名の後ろに記載されている値は，同時に起動できるプロセス数です。nの場合は，PFM - Agent for WebSphere Application Serverのインスタンスごとにプロセスが1つ起動することを表します。

注意

論理ホストのPFM - Agent でも，動作するプロセスおよびプロセス数は同じです。

表D-1　PFM - Agent for WebSphere Application Serverのプロセス一覧（Windows版）

プロセス名
（プロセス数）
機能

jpcagt2.exe(n)
Agent Collectorサービスプロセス。このプロセスは，PFM - Agent for WebSphere Application Serverのインスタンスごとに1つ起動する。

jpcsto.exe(n)
Agent Storeサービスプロセス。このプロセスは，PFM - Agent for WebSphere Application Serverのインスタンスごとに1つ起動する。

表D-2　PFM - Agent for WebSphere Application Serverのプロセス一覧（UNIX版）

プロセス名
（プロセス数）
機能

jpcagt2(n)
Agent Collectorサービスプロセス。このプロセスは，PFM - Agent for WebSphere Application Serverのインスタンスごとに1つ起動する。

jpcsto(n)
Agent Storeサービスプロセス。このプロセスは，PFM - Agent for WebSphere Application Serverのインスタンスごとに1つ起動する。

付録E　ポート番号一覧

ここでは，PFM - Agent for WebSphere Application Serverで使用するポート番号を記載します。

PFM - Manager，PFM - Web Console，およびPFM - Baseのポート番号およびファイアウォールの通過方向については，マニュアル「JP1/Performance Management リファレンス」の付録を参照してください。

ポート番号は，ユーザー環境に合わせて任意の番号に変更することもできます。

ポート番号の変更方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。なお，使用するプロトコルはTCP/IPです。

注意

Performance Managementは，1対1のアドレス変換をする静的NAT（Basic NAT）に対応しています。

動的NATや，ポート変換機能を含むNAPT（IP Masquerade，NAT+）には対応していません。

＜この節の構成＞

付録E.1　PFM - Agent for WebSphere Application Serverのポート番号

付録E.2　ファイアウォールの通過方向

付録E.1　PFM - Agent for WebSphere Application Serverのポート番号

PFM - Agent for WebSphere Application Serverで使用するポート番号を次の表に示します。

表E-1　PFM - Agent for WebSphere Application Serverで使用するポート番号

ポート番号 | サービス名 | パラメーター | 用途
自動※1 | Agent Storeサービス | jp1pcsto2[nnn]※2 | パフォーマンスデータを記録したり，履歴レポートを取得したりするときに使用する。
自動※1 | Agent Collectorサービス | jp1pcagt2[nnn]※2 | アラームをバインドしたり，リアルタイムレポートを取得したりするときに使用する。

注※1

サービスが再起動されるたびに，システムで使用されていないポート番号が自動的に割り当てられます。

注※2

複数インスタンスを作成している場合，2番目以降に作成したインスタンスに通し番号（nnn）が付加されます。最初に作成したインスタンスには，通し番号は付加されません。

付録E.2　ファイアウォールの通過方向

＜この項の構成＞

(1)　ファイアウォールの通過方向の設定

(2)　ファイアウォールの通過方向の設定（論理ホスト運用の場合）

(1)　ファイアウォールの通過方向の設定

ファイアウォールを挟んでPFM - ManagerとPFM - Agent for WebSphere Application Serverを配置する場合は，PFM - ManagerとPFM - Agentのすべてのサービスにポート番号を固定値で設定してください。また，各ポート番号を次の表に示す方向で設定し，すべてのサービスについてファイアウォールを通過させるようにしてください。

表E-2　ファイアウォールの通過方向（PFM - ManagerとPFM - Agent間）

サービス名 | パラメーター | 通過方向
Agent Storeサービス | jp1pcsto2 | Agent←Manager
Agent Collectorサービス | jp1pcagt2 | Agent←Manager

（凡例）

Manager：PFM - Managerホスト

Agent：PFM - Agentホスト

←：右項から左項への通信（コネクション）を開始する方向

通信（コネクション）を開始するときは，接続を受ける側（矢印が向いている側）が，表E-1のポート番号を受信ポートとして使用します。接続する側は，OSによって割り当てられる空きポート番号を送信ポートとして使用します。この場合に使用するポート番号の範囲は，OSによって異なります。

Managerで一時的に使用される送信ポートがAgentの受信ポートを通過できるようにファイアウォールを設定してください。

注意

PFM - Agentのホストでjpctool db dump (jpcctrl dump)コマンドまたはjpctool service list (jpcctrl list)コマンドを実行したい場合，次のどちらかの方法でコマンドを実行してください。

jpctool db dump (jpcctrl dump)コマンドまたはjpctool service list (jpcctrl list)コマンドのproxyオプションで，PFM - Managerを経由して通信するように指定してください。jpctool db dump (jpcctrl dump)コマンドまたはjpctool service list (jpcctrl list)コマンドのproxyオプションについては，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

各PFM - Agentホスト間で次の表に示す方向でポート番号を設定し，ファイアウォールを通過させるようにしてください。

表E-3　ファイアウォールの通過方向（各PFM - Agentホスト間）

サービス名 | パラメーター | 通過方向
Agent Storeサービス | jp1pcsto2 | Agent←→Agent
Agent Collectorサービス | jp1pcagt2 | Agent←→Agent

（凡例）

Agent：PFM - Agentホスト

←→：左項から右項，および右項から左項への通信（コネクション）を開始する方向

(2)　ファイアウォールの通過方向の設定（論理ホスト運用の場合）

ファイアウォールを挟んでPFM - ManagerとPFM - Agent for WebSphere Application Serverを配置する場合は，PFM - ManagerとPFM - Agentのすべてのサービスにポート番号を固定値で設定してください。また，各ポート番号を次の表に示す方向で設定し，すべてのサービスについてファイアウォールを通過させるようにしてください。

表E-4　ファイアウォールの通過方向（PFM - ManagerとPFM - Agent間（論理ホスト運用の場合））

サービス名 | パラメーター | 通過方向
Agent Storeサービス（論理ホスト） | jp1pcsto2 | Agent（論理ホスト）←Manager
Agent Collectorサービス（論理ホスト） | jp1pcagt2 | Agent（論理ホスト）←Manager

（凡例）

Manager：PFM - Managerホスト

Agent（論理ホスト）：PFM - Agentホスト

←：右項から左項への通信（コネクション）を開始する方向

通信（コネクション）を開始するときは，接続を受ける側（矢印が向いている側）が，表E-1のポート番号を受信ポートとして使用します。接続する側は，OSによって割り当てられる空きポート番号を送信ポートとして使用します。この場合に使用するポート番号の範囲は，OSによって異なります。

Managerから一時的に使用される送信ポートがAgentの論理ホストの受信ポートに通過できるようにファイアウォールを設定してください。

付録F　PFM - Agent for WebSphere Application Serverのプロパティ

ここでは，PFM - Web Consoleで表示されるPFM - Agent for WebSphere Application ServerのAgent Storeサービスのプロパティ一覧，およびAgent Collectorサービスのプロパティ一覧を記載します。

＜この節の構成＞

付録F.1　Agent Storeサービスのプロパティ一覧

付録F.2　Agent Collectorサービスのプロパティ一覧

付録F.1　Agent Storeサービスのプロパティ一覧

PFM - Agent for WebSphere Application ServerのAgent Storeサービスのプロパティ一覧を次の表に示します。

表F-1　PFM - Agent for WebSphere Application ServerのAgent Storeサービスのプロパティ一覧

フォルダ名
プロパティ名
説明

－
First Registration Date
サービスがPFM - Managerに認識された最初の日時が表示される。

Last Registration Date
サービスがPFM - Managerに認識された最新の日時が表示される。

General
－
ホスト名やディレクトリなどの情報が格納されている。このディレクトリに格納されているプロパティは変更できない。

Directory
サービスの動作するカレントディレクトリ名が表示される。

Host Name
サービスが動作する物理ホスト名が表示される。

Process ID
サービスのプロセスIDが表示される。

Physical Address
サービスが動作するホストのIPアドレスおよびポート番号が表示される。

User Name
サービスプロセスを実行したユーザー名が表示される。

Time Zone
サービスで使用されるタイムゾーンが表示される。

System
－
サービスが起動されているOSの，OS情報が格納されている。このフォルダに格納されているプロパティは変更できない。

CPU Type
CPUの種類が表示される。

Hardware ID
ハードウェアIDが表示される。

OS Type
OSの種類が表示される。

OS Name
OS名が表示される。

OS Version
OSのバージョンが表示される。

Network Services
－
Performance Management通信共通ライブラリーについての情報が格納されている。このディレクトリに格納されているプロパティは変更できない。

Build Date
Agent Storeサービスの作成日が表示される。

INI File
jpcns.iniファイルの格納フォルダ名が表示される。

Network Services
Service
－
サービスについての情報が格納されている。このディレクトリに格納されているプロパティは変更できない。

Description
次の形式でホスト名が表示される。
インスタンス名_ホスト名

Local Service Name
サービスIDが表示される。

Remote Service Name
接続先PFM - ManagerホストのMaster ManagerサービスのサービスIDが表示される。

EP Service Name
接続先PFM - ManagerホストのCorrelatorサービスのサービスIDが表示される。

Retention
－
Storeバージョンが1.0の場合にデータの保存期間を設定する。詳細については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働監視データの管理について説明している章を参照のこと。

Product Interval - Minute Drawer
分ごとのPIレコードタイプのレコードの保存期間を設定する。次のリストから選択できる。

Minute

Hour

Day

2 Days

3 Days

4 Days

5 Days

6 Days

Week

Month

Year

Product Interval - Hour Drawer
時間ごとのPIレコードタイプのレコードの保存期間を設定する。次のリストから選択できる。

Hour

Day

2 Days

3 Days

4 Days

5 Days

6 Days

Week

Month

Year

Product Interval - Day Drawer
日ごとのPIレコードタイプのレコードの保存期間を設定する。次のリストから選択できる。

Day

2 Days

3 Days

4 Days

5 Days

6 Days

Week

Month

Year

Product Interval - Week Drawer
週ごとのPIレコードタイプのレコードの保存期間を設定する。次のリストから選択できる。

Week

Month

Year

Product Interval - Month Drawer
月ごとのPIレコードタイプのレコードの保存期間を設定する。次のリストから選択できる。

Month

Year

Product Interval - Year Drawer
年ごとのPIレコードタイプのレコードの保存期間を設定する。Yearで固定。

Product Detail - PDレコードタイプのレコードID
各PDレコードタイプのレコードの保存レコード数を設定する。0～2,147,483,647の整数が指定できる。

注意

範囲外の数値，またはアルファベットなどの文字を指定した場合，エラーメッセージが表示される。

Product Log - MESS
Log Messages（PL_MESS）レコードの保存レコード数を設定する。0～2,147,483,647の整数が指定できる。

注意

範囲外の数値，またはアルファベットなどの文字を指定した場合，エラーメッセージが表示される。

RetentionEx
－
Storeバージョンが2.0の場合にデータの保存期間を設定する。詳細については，マニュアル「JP1/Performance Management 運用ガイド」の，稼働監視データの管理について説明している章を参照のこと。

RetentionEx
Product Interval - PIレコードタイプのレコードID
－
PIレコードタイプのレコードの保存期間を設定する。

Period - Minute Drawer (Day)
PIレコードタイプのレコードIDごとに，分単位のパフォーマンスデータの保存期間を設定する。
保存期間（日数）を0～366の整数で指定できる。

Period - Hour Drawer (Day)
PIレコードタイプのレコードIDごとに，時間単位のパフォーマンスデータの保存期間を設定する。
保存期間（日数）を0～366の整数で指定できる。

Period - Day Drawer (Week)
PIレコードタイプのレコードIDごとに，日単位のパフォーマンスデータの保存期間を設定する。
保存期間（週の数）を0～522の整数で指定できる。

Period - Week Drawer (Week)
PIレコードタイプのレコードIDごとに，週単位のパフォーマンスデータの保存期間を設定する。
保存期間（週の数）を0～522の整数で指定できる。

Period - Month Drawer (Month)
PIレコードタイプのレコードIDごとに，月単位のパフォーマンスデータの保存期間を設定する。
保存期間（月の数）を0～120の整数で指定できる。

Period - Year Drawer (Year)
PIレコードタイプのレコードIDごとに，年単位のパフォーマンスデータの保存期間が表示される。

Product Detail - PDレコードタイプのレコードID
Period (Day)
PDレコードタイプのレコードIDごとに，パフォーマンスデータの保存期間を設定する。
保存期間（日数）を0～366の整数で指定できる。

Disk Usage
－
各データベースで使用されているディスク容量が格納されている。このフォルダに格納されているプロパティには，プロパティを表示した時点でのディスク使用量が表示される。このフォルダに格納されているプロパティは変更できない。

Product Interval
PIレコードタイプのレコードで使用されるディスク容量が表示される。

Product Detail
PDレコードタイプのレコードで使用されるディスク容量が表示される。

Product Alarm
PAレコードタイプのレコードで使用されるディスク容量が表示される。PFM - Agent for WebSphere Application Serverでは使用しない。

Product Log
PLレコードタイプのレコードで使用されるディスク容量が表示される。PFM - Agent for WebSphere Application Serverでは使用しない。

Total Disk Usage
データベース全体で使用されるディスク容量が表示される。

Configuration
－
Agent Storeサービスのプロパティが表示される。

Store Version
Storeデータベースのバージョンが表示される。

Storeバージョン1.0の場合
「1.0」

Storeバージョン2.0の場合
「2.0」

（凡例）

－：該当しない

付録F.2　Agent Collectorサービスのプロパティ一覧

PFM - Agent for WebSphere Application ServerのAgent Collectorサービスのプロパティ一覧を次の表に示します。

表F-2　PFM - Agent for WebSphere Application ServerのAgent Collectorサービスのプロパティ一覧

フォルダ名
プロパティ名
説明

－
First Registration Date
サービスがPFM - Managerに認識された最初の日時が表示される。

Last Registration Date
サービスがPFM - Managerに認識された最新の日時が表示される。

Data Model Version
データモデルのバージョンが表示される。

General
－
ホスト名やディレクトリなどの情報が格納されている。このディレクトリに格納されているプロパティは変更できない。

Directory
サービスの動作するカレントディレクトリ名が表示される。

Host Name
サービスが動作する物理ホスト名が表示される。

Process ID
サービスのプロセスIDが表示される。

Physical Address
サービスが動作するホストのIPアドレスおよびポート番号が表示される。

User Name
サービスプロセスを実行したユーザー名が表示される。

Time Zone
サービスで使用されるタイムゾーンが表示される。

System
－
サービスが起動されているOSの，OS情報が格納されている。このディレクトリに格納されているプロパティは変更できない。

CPU Type
CPUの種類が表示される。

Hardware ID
ハードウェアIDが表示される。

OS Type
OSの種類が表示される。

OS Name
OS名が表示される。

OS Version
OSのバージョンが表示される。

Network Services
－
Performance Management通信共通ライブラリーについての情報が格納されている。このディレクトリに格納されているプロパティは変更できない。

Build Date
Agent Collectorサービスの作成日が表示される。

INI File
jpcns.iniファイルの格納フォルダ名が表示される。

Network Services
Service
－
サービスについての情報が格納されている。このディレクトリに格納されているプロパティは変更できない。

Description
次の形式でホスト名が表示される。
インスタンス名_ホスト名

Local Service Name
サービスIDが表示される。

Remote Service Name
Agent Collectorサービスが接続するAgent StoreサービスのサービスIDが表示される。

EP Service Name
接続先PFM - ManagerホストのCorrelatorサービスのサービスID が表示される。

AH Service Name
同一ホストにあるAction HandlerサービスのサービスIDが表示される。

JP1 Event Configurations
－
JP1イベントの発行条件を設定する。

各サービス
Agent Collectorサービス，Agent Storeサービス，Action Handlerサービス，およびStatus Serverサービスのリスト項目から「Yes」または「No」を選択し，サービスごとにJP1システムイベントを発行するかどうかを指定する。

JP1 Event Send Host
JP1/Baseの接続先イベントサーバ名を指定する。ただし，Action Handlerサービスと同一マシンの論理ホストまたは物理ホストで動作しているイベントサーバだけ指定できる。指定できる値は0～255バイトの半角英数字，「.」および「-」である。範囲外の値を指定した場合は，省略したと仮定される。値を省略した場合は，Action Handlerサービスが動作するホストがイベント発行元ホストとして使用される。「localhost」を指定した場合は，物理ホストを指定したものと仮定される。

Monitoring Console Host
JP1/IM - Managerのモニター起動でPFM - Web Consoleのブラウザを起動する場合，起動するPFM - Web Consoleホストを指定する。指定できる値は0～255バイトの半角英数字，「.」および「-」である。範囲外の値を指定した場合は，省略したと仮定される。値を省略した場合は，接続先のPFM - Managerホストが仮定される。

Monitoring Console Port
起動するPFM - Web Consoleのポート番号（httpリクエストポート番号）を指定する。指定できる値は1～65535である。範囲外の値を指定した場合は，省略したと仮定される。値を省略した場合は，20358が設定される。

JP1 Event Configurations
Alarm
JP1 Event Mode
アラームの状態が変化した場合に，次のどちらのイベントを発行するか設定する。

JP1 User Event：JP1ユーザーイベントを発行する

JP1 System Event：JP1システムイベントを発行する

Detail Records
－
PDレコードタイプのレコードのプロパティが格納されている。収集されているレコードのレコードIDは，太字で表示される。

Detail Records
レコードID※1
－
レコードのプロパティが格納されている。

Description
レコードの説明が表示される。このプロパティは変更できない。

Log
リスト項目から「Yes」または「No」を選択し，レコードをStoreデータベースに記録するかどうかを指定する。この値が「Yes」でかつ，Collection Intervalが0より大きい値であれば，データベースに記録される。指定がない場合は「No」となる。

Monitoring（ITSLM）
レコードをJP1/ITSLM - Managerに送信するかどうかについて，JP1/ITSLM - Managerでの設定が表示される。ここでは，「No」が固定で表示される。読み取り専用のため設定はできない。

Log（ITSLM）
JP1/ITSLM - ManagerからレコードをPFM - Agent for WebSphere Application ServerのStoreデータベースに記録するかどうかについて示す。ここでは，「No」が固定で表示される。読み取り専用のため設定はできない。

Collection Interval
データの収集間隔を指定する。指定できる値は0～2,147,483,647秒で，1秒単位で指定できる。なお，0と指定した場合，データは収集されない。

Collection Offset
データの収集を開始するオフセット値を指定する。指定できる値は，Collection Intervalで指定した値の範囲内で，0～32,767秒の1秒単位で指定できる。なお，データ収集の記録時間は，Collection Offsetの値によらないで，Collection Intervalと同様の時間となる。

LOGIF
レコードをデータベースに記録するときの条件を指定する。条件に合ったレコードだけがデータベースに記録される。PFM - Web Consoleの［サービス階層］画面で表示されるサービスのプロパティ画面の，下部フレームの［LOGIF］をクリックすると表示される［ログ収集条件設定］画面で作成した条件式（文字列）が表示される。

Interval Records
－
PIレコードタイプのレコードのプロパティが格納されている。収集されているレコードのレコードIDは，太字で表示される。

Interval Records
レコードID※1
－
レコードのプロパティが格納されている。

Description
レコードの説明が表示される。このプロパティは変更できない。

Log
リスト項目から「Yes」または「No」を選択し，レコードをStoreデータベースに記録するかどうかを指定する。この値が「Yes」でかつ，Collection Intervalが0より大きい値であれば，データベースに記録される。指定がない場合は「No」となる。

Monitoring（ITSLM）
レコードをJP1/ITSLM - Managerに送信するかどうかについて，JP1/ITSLM - Managerでの設定が表示される。ここでは，「No」が固定で表示される。読み取り専用のため設定はできない。

Log（ITSLM）
JP1/ITSLM - ManagerからレコードをPFM - Agent for WebSphere Application ServerのStoreデータベースに記録するかどうかについて示す。ここでは，「No」が固定で表示される。読み取り専用のため設定はできない。

Collection Interval
データの収集間隔を指定する。指定できる値は0～2,147,483,647秒で，1秒単位で指定できる。なお，0と指定した場合，データは収集されない。

Collection Offset
データの収集を開始するオフセット値を指定する。指定できる値は，Collection Intervalで指定した値の範囲内で，0～32,767秒の1秒単位で指定できる。なお，データ収集の記録時間は，Collection Offsetの値によらないで，Collection Intervalと同様の時間となる。

LOGIF
レコードをデータベースに記録するときの条件を指定する。条件に合ったレコードだけがデータベースに記録される。PFM - Web Consoleの［サービス階層］画面で表示されるサービスのプロパティ画面の，下部フレームの［LOGIF］をクリックすると表示される［ログ収集条件設定］画面で作成した条件式（文字列）が表示される。

Log Records
－
PLレコードタイプのレコードのプロパティが格納されている。PFM - Agent for WebSphere Application Serverではこのレコードをサポートしていないため使用しない。

Restart Configurations
－
PFMサービス自動再起動の条件を設定する。PFM - ManagerまたはPFM - Baseが08-50以降の場合に設定できる。PFMサービス自動再起動機能については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，Performance Managementの機能について説明している章を参照のこと。

Restart when Abnormal Status
Status ServerサービスがAction Handlerサービス，Agent Collectorサービス，およびAgent Storeサービスの状態を正常に取得できない場合にサービスを自動再起動するかどうかを設定する。

Restart when Single Service Running
Agent StoreサービスとAgent Collectorサービスのどちらかしか起動していない場合にサービスを自動再起動するかどうかを設定する。

Restart Configurations
Action Handler
Auto Restart
Action Handlerサービスに対して自動再起動機能を利用するかどうかを設定する。

Auto Restart - Interval (Minute)
自動再起動機能を利用する場合，サービスの稼働状態を確認する間隔を分単位で設定する。

Auto Restart - Repeat Limit
自動再起動機能を利用する場合，連続して再起動を試行する回数を設定する。

Scheduled Restart
Action Handlerサービスに対して，定期再起動機能を利用するかどうかを設定する。

Scheduled Restart - Interval
定期再起動機能を利用する場合，再起動間隔を設定する。

Scheduled Restart - Interval Unit
定期再起動機能を利用する場合，再起動間隔の単位を設定する。

Scheduled Restart - Origin - Year
再起動する年を1971～2035の整数で指定できる。

Scheduled Restart - Origin - Month
再起動する月を1～12の整数で指定できる。

Scheduled Restart - Origin - Day
再起動する日を1～31の整数で指定できる。

Scheduled Restart - Origin - Hour
再起動する時間（時）を0～23の整数で指定できる。

Scheduled Restart - Origin - Minute
再起動する時間（分）を0～59の整数で指定できる。

Agent Collector
Auto Restart
Agent Collectorサービスに対して自動再起動機能を利用するかどうかを設定する。

Auto Restart - Interval (Minute)
自動再起動機能を利用する場合，サービスの稼働状態を確認する間隔を分単位で設定する。

Auto Restart - Repeat Limit
自動再起動機能を利用する場合，連続して再起動を試行する回数を設定する。

Scheduled Restart
Agent Collectorサービスに対して，定期再起動機能を利用するかどうかを設定する。

Scheduled Restart - Interval
定期再起動機能を利用する場合，再起動間隔を設定する。

Scheduled Restart - Interval Unit
定期再起動機能を利用する場合，再起動間隔の単位を設定する。

Scheduled Restart - Origin - Year
再起動する年を1971～2035の整数で指定できる。

Scheduled Restart - Origin - Month
再起動する月を1～12の整数で指定できる。

Scheduled Restart - Origin - Day
再起動する日を1～31の整数で指定できる。

Scheduled Restart - Origin - Hour
再起動する時間（時）を0～23の整数で指定できる。

Scheduled Restart - Origin - Minute
再起動する時間（分）を0～59の整数で指定できる。

Agent Store
Auto Restart
Agent Storeサービスに対して自動再起動機能を利用するかどうかを設定する。

Auto Restart - Interval (Minute)
自動再起動機能を利用する場合，サービスの稼働状態を確認する間隔を分単位で設定する。

Auto Restart - Repeat Limit
自動再起動機能を利用する場合，連続して再起動を試行する回数を設定する。

Scheduled Restart
Agent Storeサービスに対して，定期再起動機能を利用するかどうかを設定する。

Scheduled Restart - Interval
定期再起動機能を利用する場合，再起動間隔を設定する。

Scheduled Restart - Interval Unit
定期再起動機能を利用する場合，再起動間隔の単位を設定する。

Scheduled Restart - Origin - Year
再起動する年を1971～2035の整数で指定できる。

Scheduled Restart - Origin - Month
再起動する月を1～12の整数で指定できる。

Scheduled Restart - Origin - Day
再起動する日を1～31の整数で指定できる。

Scheduled Restart - Origin - Hour
再起動する時間（時）を0～23の整数で指定できる。

Scheduled Restart - Origin - Minute
再起動する時間（分）を0～59の整数で指定できる。

Agent
－
Agent Collectorサービスの概要が表示される。

Instance
PFM - Agent for WebSphere Application Serverのインスタンス名が表示される。

Agent Configuration
－
PFM - Agent for WebSphere Application Server固有の設定用プロパティが格納されている。

Agent Configuration
Parameters
－
Agent Collectorサービスのプロパティが表示される。

INST_DIR
WebSphere Application Serverのインストール先ディレクトリが表示される。

WAS_VER
WebSphere Application Serverのバージョンが表示される。

PORT_NUM
WebSphere Application ServerのSOAPコネクターポート番号が表示される。

USER_NAME※2
WebSphere Application Serverに接続するためのHTTP基本認証のユーザー名が表示される。
HTTP基本認証を使用していない場合は空白となる。

TRUSTSTORE_FILE_PATH
WebSphere Application ServerへSSL接続するためのトラストストアファイル名が表示される。
SSLを使用していない場合は空白となる。

（凡例）

－：該当しない

注※1

フォルダ名には，データベースIDを除いたレコードIDが表示されます。各レコードのレコードIDについては，「6. レコード」を参照してください。

注※2

ここで指定するユーザーには，Monitorセキュリティロールが与えられている必要があります。

付録G　ファイルおよびディレクトリ一覧

ここでは，PFM - Agent for WebSphere Application Serverのファイルおよびディレクトリ一覧をOSごとに記載します。

Performance Managementのインストール先ディレクトリをOSごとに示します。

Windowsの場合

Performance Managementのインストール先フォルダは任意です。デフォルトのインストール先フォルダは次に示すとおりです。

Windows Server 2003 (x64)，64ビット版のWindows Server 2008の場合
システムドライブ¥Program Files(x86)¥Hitachi¥jp1pc

上記以外の場合
システムドライブ¥Program Files¥Hitachi¥jp1pc

UNIXの場合

Performance Management のインストール先ディレクトリは，「/opt/jp1pc/」です。

＜この節の構成＞

付録G.1　PFM - Agent for WebSphere Application Serverのファイルおよびディレクトリ一覧

付録G.1　PFM - Agent for WebSphere Application Serverのファイルおよびディレクトリ一覧

＜この項の構成＞

(1)　Windowsの場合

(2)　UNIXの場合

(1)　Windowsの場合

Windows版PFM - Agent for WebSphere Application Serverのファイルおよびフォルダ一覧を次の表に示します。

表G-1　PFM - Agent for WebSphere Application Serverのファイルおよびフォルダ一覧（Windows版）

フォルダ名 | ファイル名 | 説明
インストール先フォルダ¥ | instagt2.ini | PFM - Agent for WebSphere Application Server製品情報ファイル
インストール先フォルダ¥agt2¥ | － | PFM - Agent for WebSphere Application Serverのルートフォルダ
insrules.dat | インスタンス起動環境定義ファイル
jpcagtras.bat | 保守資料採取コマンド
PATCHLOG.TXT | パッチ用ログファイル
readme.txt | README.TXT（日本語）
インストール先フォルダ¥agt2¥agent¥ | － | Agent Collectorサービスのルートフォルダ
agtlist.ini | インスタンスリストファイル※
jpcagt.ini.instmpl | Agent Collectorサービス起動情報ファイルのテンプレート
jpcagt2.exe | Agent Collectorサービス実行プログラム
jpcagt2.jar | PFM - Agent for WebSphere Application ServerのJavaクラスファイル
インストール先フォルダ¥agt2¥agent¥インスタンス名¥ | － | Agent Collectorサービスインスタンスフォルダ※
jpcagt.ini | Agent Collectorサービス起動情報ファイル※
jpcagt.ini.model | Agent Collectorサービス起動情報ファイルのモデルファイル※
インストール先フォルダ¥agt2¥agent¥インスタンス名¥log¥ | － | Agent Collector サービス内部ログファイル格納フォルダ※
インストール先フォルダ¥agt2¥jre¥ | － | JREのフォルダ
COPYRIGHT | JREコピーライトファイル
インストール先フォルダ¥agt2¥jre¥bin¥ | － | JRE実行ファイルフォルダ
インストール先フォルダ¥agt2¥jre¥lib¥ | － | JREライブラリフォルダ
インストール先フォルダ¥agt2¥lib¥ | － | ライブラリフォルダ
jpcagt2msg.dll | メッセージライブラリ
jpcagt2jni.dll | JNIエミュレータライブラリ
jpcagt2jnijvm.cfg | Java VMオプションファイル
jpcagt2jnienv.cfg | Java VM用環境変数ファイル
インストール先フォルダ¥agt2¥store¥ | － | Agent Storeサービスのルートフォルダ
jpcsto.ini.instmpl | Agent Storeサービス起動情報ファイルのテンプレートファイル
stolist.ini | インスタンスリストファイル※
*.DAT | データモデル定義ファイル
インストール先フォルダ¥agt2¥store¥インスタンス名¥ | － | Agent Storeインスタンスフォルダ※
jpcsto.ini | Agent Storeサービス起動情報ファイル※
jpcsto.ini.model | Agent Storeサービス起動情報ファイルのモデルファイル※
*.DAT | データモデル定義ファイル※
*.DB | パフォーマンスデータベースファイル※
*.IDX | パフォーマンスデータベースファイルのインデックスファイル※
*.LCK | パフォーマンスデータベースファイルのロックファイル※
インストール先フォルダ¥agt2¥store¥インスタンス名¥backup¥ | － | 標準のデータベースバックアップ先フォルダ※
datadir.lck | 標準のバックアップ先フォルダのロックファイル※
インストール先フォルダ¥agt2¥store¥インスタンス名¥dump¥ | － | 標準のデータベースエクスポート先フォルダ※
datadir.lck | 標準のエクスポート先フォルダのロックファイル※
インストール先フォルダ¥agt2¥store¥インスタンス名¥import¥ | － | 標準のインポート先フォルダ※（Storeバージョン2.0の場合）
datadir.lck | 標準のインポート先フォルダのロックファイル※（Storeバージョン2.0の場合）
インストール先フォルダ¥agt2¥store¥インスタンス名¥log¥ | － | Agent Storeサービス内部ログファイル格納フォルダ※
インストール先フォルダ¥agt2¥store¥インスタンス名¥partial¥ | － | 標準の部分バックアップ先フォルダ※（Storeバージョン2.0の場合）
datadir.lck | 標準の部分バックアップ先フォルダのロックファイル※（Storeバージョン2.0の場合）
インストール先フォルダ¥agt2¥store¥インスタンス名¥STPD¥ | － | Storeバージョン2.0のPDレコードタイプのレコード格納フォルダ
インストール先フォルダ¥agt2¥store¥インスタンス名¥STPI¥ | － | Storeバージョン2.0のPIレコードタイプのレコード格納フォルダ
インストール先フォルダ¥agt2¥store¥インスタンス名¥STPL¥ | － | Storeバージョン2.0のPLレコードタイプのレコード格納フォルダ
インストール先フォルダ¥patch_files¥ | － | パッチ用フォルダ
インストール先フォルダ¥patch_files¥agt2¥ | － | パッチ用フォルダ（Agentパッチ用）
インストール先フォルダ¥setup¥ | － | セットアップファイル格納フォルダ
jpcagt2u.Z | PFM - Agentセットアップ用アーカイブファイル（UNIX用）
jpcagt2w.EXE | PFM - Agentセットアップ用アーカイブファイル（Windows用）
インストール先フォルダ¥setup¥alarm¥ | － | アラーム定義ファイル格納フォルダ
2ALARM0811 | アラームテーブル修正用ファイル

（凡例）

－：該当しない

注※

jpcconf inst setup (jpcinssetup)コマンドの実行で作成されます。

(2)　UNIXの場合

UNIX版PFM - Agent for WebSphere Application Serverのファイルおよびディレクトリ一覧を次の表に示します。

表G-2　PFM - Agent for WebSphere Application Serverのファイルおよびディレクトリ一覧（UNIX版）

ディレクトリ名 | ファイル名 | 説明
/opt/jp1pc/ | instagt2.ini | PFM - Agent for WebSphere Application Server製品情報ファイル
/opt/jp1pc/agt2/ | － | PFM - Agent for WebSphere Application Serverのルートディレクトリ
insrules.dat | インスタンス起動定義ファイル
jpcagtras | 保守資料採取コマンド
patch_history | パッチ履歴ファイル
PATCHLOG.TXT | パッチ用ログファイル
/opt/jp1pc/agt2/agent/ | － | Agent Collectorサービスのルートディレクトリ
agtlist.ini | インスタンスリストファイル※
jpcagt.ini.instmpl | Agent Collectorサービス起動情報ファイルのテンプレート
jpcagt2 | Agent Collectorサービス実行プログラム
jpcagt2.jar | PFM - Agent for WebSphere Application ServerのJavaクラスファイル
/opt/jp1pc/agt2/agent/インスタンス名/ | － | Agent Collectorサービスインスタンスディレクトリ※
jpcagt.ini | Agent Collectorサービス起動情報ファイル※
jpcagt.ini.model | Agent Collectorサービス起動情報ファイルのモデルファイル※
/opt/jp1pc/agt2/agent/インスタンス名/log/ | － | Agent Collectorサービス内部ログファイル格納ディレクトリ※
/opt/jp1pc/agt2/jre/ | － | JREのディレクトリ
COPYRIGHT | JREコピーライトファイル
/opt/jp1pc/agt2/jre/bin/ | － | JRE実行ファイルディレクトリ
/opt/jp1pc/agt2/jre/lib/ | － | JREライブラリディレクトリ
/opt/jp1pc/agt2/lib/ | － | ライブラリディレクトリ
jpcagt2jni.so | JNIエミュレータライブラリ（AIX以外の場合）
jpcagt2jni.a | JNIエミュレータライブラリ（AIXの場合）
jpcagt2jnijvm.cfg | Java VMオプションファイル
jpcagt2jnienv.cfg | Java VM用環境変数ファイル
/opt/jp1pc/agt2/nls/ | － | メッセージカタログ格納ディレクトリ
/opt/jp1pc/agt2/store/ | － | Agent Storeサービスのルートディレクトリ
jpcsto.ini.instmpl | Agent Storeサービス起動情報ファイルのテンプレートファイル
stolist.ini | インスタンスリストファイル※
*.DAT | データモデル定義ファイル
/opt/jp1pc/agt2/store/インスタンス名/ | － | Agent Storeインスタンスディレクトリ※
jpcsto.ini | Agent Storeサービス起動情報ファイル※
jpcsto.ini.model | Agent Storeサービス起動情報ファイルのモデルファイル※
*.DAT | データモデル定義ファイル※
*.DB | パフォーマンスデータベースファイル※
*.IDX | パフォーマンスデータベースファイルのインデックスファイル※
*.LCK | パフォーマンスデータベースファイルのロックファイル※
/opt/jp1pc/agt2/store/インスタンス名/backup/ | － | 標準のデータベースバックアップ先ディレクトリ※
datadir.lck | 標準のバックアップ先ディレクトリのロックファイル※
/opt/jp1pc/agt2/store/インスタンス名/dump/ | － | 標準のデータベースエクスポート先ディレクトリ※
datadir.lck | 標準のエクスポート先ディレクトリのロックファイル※
/opt/jp1pc/agt2/store/インスタンス名/import/ | － | 標準のデータベースインポート先ディレクトリ※（Storeバージョン2.0の場合）
datadir.lck | 標準のインポート先ディレクトリのロックファイル※（Storeバージョン2.0の場合）
/opt/jp1pc/agt2/store/インスタンス名/log/ | － | Agent Storeサービス内部ログファイル格納ディレクトリ※
/opt/jp1pc/agt2/store/インスタンス名/partial/ | － | 標準のデータベース部分バックアップ先ディレクトリ※（Storeバージョン2.0の場合）
datadir.lck | 標準の部分バックアップ先ディレクトリのロックファイル※（Storeバージョン2.0の場合）
/opt/jp1pc/agt2/store/インスタンス名/STPD/ | － | Storeバージョン2.0のPDレコードタイプのレコード格納ディレクトリ
/opt/jp1pc/agt2/store/インスタンス名/STPI/ | － | Storeバージョン2.0のPIレコードタイプのレコード格納ディレクトリ
/opt/jp1pc/agt2/store/インスタンス名/STPL/ | － | Storeバージョン2.0のPLレコードタイプのレコード格納ディレクトリ
/opt/jp1pc/patch_files/ | － | パッチ用ディレクトリ
/opt/jp1pc/patch_files/agt2/ | － | パッチ用ディレクトリ（Agentパッチ用）
/opt/jp1pc/setup/ | － | セットアップファイル格納ディレクトリ
jpcagt2u.Z | PFM - Agentセットアップ用アーカイブファイル（UNIX用）
jpcagt2w.EXE | PFM - Agentセットアップ用アーカイブファイル（Windows用）
/opt/jp1pc/setup/alarm/ | － | アラーム定義ファイル格納ディレクトリ
2ALARM0811 | アラームテーブル修正用ファイル

（凡例）

－：該当しない

注※

jpcconf inst setup (jpcinssetup)コマンドの実行で作成されます。

付録H　バージョン互換

PFM - Agentには，製品のバージョンのほかに，データモデルのバージョンがあります。

PFM - Agent for WebSphere Application Serverのバージョンの対応を次の表に示します。

表H-1　PFM - Agent for WebSphere Application Serverのバージョン対応表

PFM - Agent for WebSphere Application Serverのバージョン | データモデルのバージョン | 監視テンプレートのアラームテーブルのバージョン
08-11 | 4.0 | 8.11
09-00 | 4.0 | 09.00
10-00 | 4.0 | 09.00

バージョン互換については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，付録に記載されているバージョン互換を参照してください。

付録I　動作ログの出力

Performance Managementの動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。

例えば，PFMサービスの起動・停止時や，PFM - Managerとの接続状態の変更時に動作ログに出力されます。

動作ログは，PFM - ManagerまたはPFM - Baseが08-10以降の場合に出力できます。

動作ログは，CSV形式で出力されるテキストファイルです。定期的に保存して表計算ソフトで加工することで，分析資料として利用できます。

動作ログは，jpccomm.iniの設定によって出力されるようになります。ここでは，PFM - AgentおよびPFM - Baseが出力する動作ログの出力内容と，動作ログを出力するための設定方法について説明します。

＜この節の構成＞

付録I.1　動作ログに出力される事象の種別

付録I.2　動作ログの保存形式

付録I.3　動作ログの出力形式

付録I.4　動作ログを出力するための設定

付録I.1　動作ログに出力される事象の種別

動作ログに出力される事象の種別およびPFM - AgentおよびPFM - Baseが動作ログを出力する契機を次の表に示します。事象の種別とは，動作ログに出力される事象を分類するための，動作ログ内での識別子です。

表I-1　動作ログに出力される事象の種別

事象の種別
説明
PFM - AgentおよびPFM - Baseが出力する契機

StartStop
ソフトウェアの起動と終了を示す事象。

PFMサービスの起動・停止

スタンドアロンモードの開始・終了

ExternalService
JP1製品と外部サービスとの通信結果を示す事象。
異常な通信の発生を示す事象。
PFM - Managerとの接続状態の変更

ManagementAction
プログラムの重要なアクションの実行を示す事象。
ほかの監査カテゴリーを契機にアクションが実行されたことを示す事象。
自動アクションの実行

付録I.2　動作ログの保存形式

ここでは，動作ログのファイル保存形式について説明します。

動作ログは規定のファイル（カレント出力ファイル）に出力され，満杯になった動作ログは別のファイル（シフトファイル）として保存されます。動作ログのファイル切り替えの流れは次のとおりです。

動作ログは，カレント出力ファイル「jpcaudit.log」に順次出力されます。

カレント出力ファイルが満杯になると，その動作ログはシフトファイルとして保存されます。
シフトファイル名は，カレント出力ファイル名の末尾に数値を付加した名称です。シフトファイル名は，カレント出力ファイルが満杯になるたびにそれぞれ「ファイル名末尾の数値+1」へ変更されます。つまり，ファイル末尾の数値が大きいほど，古いログファイルとなります。

例

カレント出力ファイル「jpcaudit.log」が満杯になると，その内容はシフトファイル「jpcaudit1.log」へ保管されます。

カレント出力ファイルが再び満杯になると，そのログは「jpcaudit1.log」へ移され，既存のシフトファイル「jpcaudit1.log」は「jpcaudit2.log」へリネームされます。

なお，ログファイル数が保存面数（jpccomm.iniファイルで指定）を超えると，いちばん古いログファイルが削除されます。

カレント出力ファイルが初期化され，新たな動作ログが書き込まれます。

動作ログの出力要否，出力先および保存面数は，jpccomm.iniファイルで設定します。jpccomm.iniファイルの設定方法については，「付録I.4　動作ログを出力するための設定」を参照してください。

付録I.3　動作ログの出力形式

Performance Managementの動作ログには，監査事象に関する情報が出力されます。動作ログは，ホスト（物理ホスト・論理ホスト）ごとに1ファイル出力されます。動作ログの出力先ホストは次のようになります。

サービスを実行した場合：実行元サービスが動作するホストに出力

コマンドを実行した場合：コマンドを実行したホストに出力

動作ログの出力形式，出力先，出力項目について次に説明します。

＜この項の構成＞

(1)　出力形式

(2)　出力先

(3)　出力項目

(4)　出力例

(1)　出力形式

CALFHM x.x,出力項目1=値1,出力項目2=値2,…,出力項目n=値n

(2)　出力先

物理ホストの場合

Windowsの場合
インストール先フォルダ¥auditlog¥

UNIXの場合
/opt/jp1pc/auditlog/

論理ホストの場合

Windowsの場合
環境フォルダ¥jp1pc¥auditlog¥

UNIXの場合
環境ディレクトリ/jp1pc/auditlog/

動作ログの出力先は，jpccomm.iniファイルで変更できます。jpccomm.iniファイルの設定方法については，「付録I.4　動作ログを出力するための設定」を参照してください。

(3)　出力項目

出力項目には2つの分類があります。

共通出力項目
動作ログを出力するJP1製品が共通して出力する項目です。

固有出力項目
動作ログを出力するJP1製品が任意に出力する項目です。

(a)　共通出力項目

共通出力項目に出力される値と項目の内容を次の表に示します。なお，この表はPFM - Managerが出力する項目や内容も含みます。

表I-2　動作ログの共通出力項目

項番
出力項目
値
内容

項目名
出力される属性名

1
共通仕様識別子
－
CALFHM
動作ログフォーマットであることを示す識別子

2
共通仕様リビジョン番号
－
x.x
動作ログを管理するためのリビジョン番号

3
通番
seqnum
通し番号
動作ログレコードの通し番号

4
メッセージID
msgid
KAVExxxxx-x
製品のメッセージID

5
日付・時刻
date
YYYY-MM-DDThh:mm:ss.sssTZD※
動作ログの出力日時およびタイムゾーン

6
発生プログラム名
progid
JP1PFM
事象が発生したプログラムのプログラム名

7
発生コンポーネント名
compid
サービスID
事象が発生したコンポーネント名

8
発生プロセスID
pid
プロセスID
事象が発生したプロセスのプロセスID

9
発生場所
ocp:host

ホスト名

IPアドレス

事象が発生した場所

10
事象の種別
ctgry

StartStop

Authentication

ConfigurationAccess

ExternalService

AnomalyEvent

ManagementAction

動作ログに出力される事象を分類するためのカテゴリー名

11
事象の結果
result

Success（成功）

Failure（失敗）

Occurrence（発生）

事象の結果

12
サブジェクト識別情報
subj:pid
プロセスID
次のどれかの情報

ユーザー操作によって動作するプロセスID

事象を発生させたプロセスID

事象を発生させたユーザー名

ユーザーに1：1で対応づけられた識別情報

subj:uid
アカウント識別子（PFMユーザー/JP1ユーザー）

subj:euid
実効ユーザーID（OSユーザー）

（凡例）

－：なし。

注※

Tは日付と時刻の区切りです。

TZDはタイムゾーン指定子です。次のどれかが出力されます。

+hh:mm：UTCからhh:mmだけ進んでいることを示す。

-hh:mm：UTCからhh:mmだけ遅れていることを示す。

Z：UTCと同じであることを示す。

(b)　固有出力項目

固有出力項目に出力される値と項目の内容を次の表に示します。なお，この表はPFM - Managerが出力する項目や内容も含みます。

表I-3　動作ログの固有出力項目

項番
出力項目
値
内容

項目名
出力される属性名

1
オブジェクト情報
obj

PFM - AgentのサービスID

追加，削除，更新されたユーザー名（PFMユーザー）

操作の対象

obj:table
アラームテーブル名

obj:alarm
アラーム名

2
動作情報
op

Start（起動）

Stop（停止）

Add（追加）

Update（更新）

Delete（削除）

Change Password（パスワード変更）

Activate（有効化）

Inactivate（無効化）

Bind（バインド）

Unbind（アンバインド）

事象を発生させた動作情報

3
権限情報
auth

管理者ユーザー
Management

一般ユーザー
Ordinary

Windows
Administrator

UNIX
SuperUser

操作したユーザーの権限情報

auth:mode

PFM認証モード
pfm

JP1認証モード
jp1

OSユーザー
os

操作したユーザーの認証モード

4
出力元の場所
outp:host
PFM - Managerのホスト名
動作ログの出力元のホスト

5
指示元の場所
subjp:host

ログイン元ホスト名

実行ホスト名（jpctool alarm (jpcalarm)コマンド実行時だけ）

操作の指示元のホスト

6
自由記述
msg
メッセージ
アラーム発生時，および自動アクションの実行時に出力されるメッセージ

固有出力項目は，出力契機ごとに出力項目の有無や内容が異なります。出力契機ごとに，メッセージIDと固有出力項目の内容を次に説明します。

●PFMサービスの起動・停止（StartStop）

出力ホスト：該当するサービスが動作しているホスト

出力コンポーネント：起動・停止を実行する各サービス

項目名
属性名
値

メッセージID
msgid
起動：KAVE03000-I
停止：KAVE03001-I

動作情報
op
起動：Start
停止：Stop

●スタンドアロンモードの開始・終了（StartStop）

出力ホスト：PFM - Agentホスト

出力コンポーネント：Agent Collectorサービス，Agent Storeサービス

項目名
属性名
値

メッセージID
msgid
スタンドアロンモードを開始：KAVE03002-I
スタンドアロンモードを終了：KAVE03003-I

注1　固有出力項目は出力されない。

注2　PFM - Agentの各サービスは，起動時にPFM - Managerホストに接続し，ノード情報の登録，最新のアラーム定義情報の取得などを行う。PFM - Managerホストに接続できない場合，稼働情報の収集など一部の機能だけが有効な状態（スタンドアロンモード）で起動する。その際，スタンドアロンモードで起動することを示すため，KAVE03002-Iが出力される。その後，一定期間ごとにPFM - Managerへの再接続を試み，ノード情報の登録，定義情報の取得などに成功すると，スタンドアロンモードから回復し，KAVE03003-Iが出力される。この動作ログによって，KAVE03002-IとKAVE03003-Iが出力されている間は，PFM - Agentが不完全な状態で起動していることを知ることができる。

●PFM - Managerとの接続状態の変更（ExternalService）

出力ホスト：PFM - Agentホスト

出力コンポーネント：Agent Collectorサービス，Agent Storeサービス

項目名
属性名
値

メッセージID
msgid
PFM - Managerへのイベントの送信に失敗（キューイングを開始）：KAVE03300-I
PFM - Managerへのイベントの再送が完了：KAVE03301-I

注1　固有出力項目は出力されない。

注2　Agent Storeサービスは，PFM - Managerへのイベント送信に失敗すると，イベントのキューイングを開始し，以降はイベントごとに最大3件がキューにためられる。KAVE03300-Iは，イベント送信に失敗し，キューイングを開始した時点で出力される。PFM - Managerとの接続が回復したあと，キューイングされたイベントの送信が完了した時点で，KAVE03301-Iが出力される。この動作ログによって，KAVE03300-IとKAVE03301-Iが出力されている間は，PFM - Managerへのイベント送信がリアルタイムでできていなかった期間と知ることができる。

注3　Agent Collectorサービスは，通常，Agent Storeサービスを経由してPFM - Managerにイベントを送信する。何らかの理由でAgent Storeサービスが停止している場合だけ，直接PFM - Managerにイベントを送信するが，失敗した場合にKAVE03300-Iが出力される。この場合，キューイングを開始しないため，KAVE03301-Iは出力されない。この動作ログによって，PFM - Managerに送信されなかったイベントがあることを知ることができる。

●自動アクションの実行（ManagementAction）

出力ホスト：アクションを実行したホスト

出力コンポーネント：Action Handlerサービス

項目名
属性名
値

メッセージID
msgid
コマンド実行プロセス生成に成功：KAVE03500-I
コマンド実行プロセス生成に失敗：KAVE03501-W
E-mail送信に成功：KAVE03502-I
E-mail送信に失敗：KAVE03503-W

自由記述
msg
コマンド実行：cmd=実行したコマンドライン
E-mail送信：mailto=送信先Eメールアドレス

注　コマンド実行プロセスの生成に成功した時点でKAVE03500-Iが出力される。その後，コマンドが実行できたかどうかのログ，および実行結果のログは，動作ログには出力されない。

(4)　出力例

動作ログの出力例を次に示します。

CALFHM 1.0, seqnum=1, msgid=KAVE03000-I, date=2007-01-18T22:46:49.682+09:00,
progid=JP1PFM, compid=TA1host01, pid=2076,
ocp:host=host01, ctgry=StartStop, result=Occurrence,
subj:pid=2076,op=Start

付録I.4　動作ログを出力するための設定

動作ログを出力するための設定は，jpccomm.iniファイルで定義します。設定しない場合，動作ログは出力されません。動作ログを出力するための設定内容とその手順について次に示します。

＜この項の構成＞

(1)　設定手順

(2)　jpccomm.iniファイルの詳細

(1)　設定手順

動作ログを出力するための設定手順を次に示します。

ホスト上の全PFMサービスを停止させる。

テキストエディターなどで，jpccomm.iniファイルを編集する。

jpccomm.iniファイルを保存して閉じる。

(2)　jpccomm.iniファイルの詳細

jpccomm.iniファイルの詳細について説明します。

(a)　格納先ディレクトリ

Windowsの場合

インストール先フォルダ

UNIXの場合

/opt/jp1pc/

(b)　形式

jpccomm.iniファイルには，次の内容を定義します。

動作ログの出力の有無

動作ログの出力先

動作ログの保存面数

動作ログのファイルサイズ

指定形式は次のとおりです。

"項目名"=値

設定項目を次の表に示します。

表I-4　jpccomm.iniファイルで設定する項目および初期値

項番
項目
説明

1
[Action Log Section]
セクション名です。変更はできません。

2
Action Log Mode
動作ログを出力するかどうかを指定します。この項目の設定は省略できません。

初期値
0（出力しない）

指定できる値
0（出力しない），1（出力する）
これ以外の値を指定すると，エラーメッセージが出力され，動作ログは出力されません。

3
Action Log Dir※
動作ログの出力先を指定します。
論理ホスト環境の場合は共有ディスク上のディレクトリを指定します。共有ディスク上にないディレクトリを指定した場合，論理ホストを構成する各物理ホストへ動作ログが出力されます。
なお，制限長を超えるパスを設定した場合や，ディレクトリへのアクセスが失敗した場合は，共通ログにエラーメッセージが出力され，動作ログは出力されません。

初期値
省略

省略した場合に適用される値（デフォルト値）
物理ホストの場合
　Windows：インストール先フォルダ¥auditlog¥
　UNIX：/opt/jp1pc/auditlog/
論理ホストの場合
　Windows：環境フォルダ¥jp1pc¥auditlog¥
　UNIX：環境ディレクトリ/jp1pc/auditlog/

指定できる値
1～185バイトの文字列

4
Action Log Num
ログファイルの総数の上限（保存面数）を指定します。カレント出力ファイルとシフトファイルの合計を指定してください。

初期値
省略

省略した場合に適用される値（デフォルト値）
5

指定できる値
2～10の整数

数値以外の文字列を指定した場合，エラーメッセージが出力され，デフォルト値である5が設定されます。
範囲外の数値を指定した場合，エラーメッセージを出力し，指定値に最も近い2～10の整数値が設定されます。

5
Action Log Size
ログファイルのサイズをキロバイト単位で指定します。

初期値
省略

省略した場合に適用される値（デフォルト値）
2048

指定できる値
512～2096128​の整数

数値以外の文字列を指定した場合，エラーメッセージが出力され，デフォルト値である2048が設定されます。
範囲外の数値を指定した場合，エラーメッセージが出力され，指定値に最も近い512～2096128​の整数値が設定されます。

注※

物理ホストで設定したあと，jpcconf ha (jpchasetup)コマンドで論理ホストを設定すると，物理ホストの設定が論理ホストにも反映されます。論理ホストと物理ホストを同時に使用する場合には，動作ログの出力先ディレクトリが同一にならないようにしてください。

付録J　JP1/ITSLMとの連携

PFM - Agent for WebSphere Application Serverは，JP1/ITSLM連携することによって，監視を強化できます。

PFM - Agent for WebSphere Application Serverは，JP1/ITSLM上での監視を実現するために，JP1/ITSLM用のデフォルト監視項目をPFM - Managerに提供します。

PFM - Agent for WebSphere Application ServerからPFM - Managerに提供するデフォルト監視項目は次のとおりです。

表J-1　PFM - Agent for WebSphere Application ServerがPFM - Managerに提供するデフォルト監視項目

フィールド名
（レコード名）
説明

CONNECTION_POOL_USE_PERCENT
（PI_JDBC）
JDBC接続プールの使用率。

CPU_USE_PERCENT
（PI_JVM）
JVMランタイムのCPU使用率。

MEMORY_USE_PERCENT
（PI_JVM）
JVMランタイムのメモリー使用率。

THREAD_POOL_USE_PERCENT
（PI_THRP）
スレッドプールの使用率。

これらのデフォルト監視項目はPFM - Agent for WebSphere Application Serverのインストール時にPFM - Managerに自動的に追加されます。PFM - Agent for WebSphere Application Server側の設定はありません。PFM - Manager側でセットアップコマンドを実行する必要があります。

付録K　各バージョンの変更内容

＜この節の構成＞

付録K.1　10-00の変更内容

付録K.2　09-00の変更内容

付録K.1　10-00の変更内容

次のデフォルト監視項目をPFM-Managerに提供することによって，JP1/IT Service Level Managementとの連携を強化しました。

CONNECTION_POOL_USE_PERCENT(PI_JDBC)

CPU_USE_PERCENT(PI_JVM)

MEMORY_USE_PERCENT(PI_JVM)

THREAD_POOL_USE_PERCENT(PI_THRP)

IPv6の環境でもパフォーマンスデータを収集できるようにしました。

付録K.2　09-00の変更内容

「ソリューションセット」の名称を「監視テンプレート」に変更しました。

収集データ追加ユーティリティの操作性が向上しました。

監視テンプレートのアラームテーブルのバージョンを8.11から09.00に変更しました。

JP1/IMとの連携機能を強化しました。これに伴い，Agent Collectorサービスのプロパティ一覧に次のフォルダを追加しました。
JP1 Event Configurations

08-51以前のコマンドと互換性を持つ新形式のコマンドが追加されたことに伴い，コマンドを次のように表記しました。
09-00以降のコマンド（08-51以前のコマンド）

PFM - Agent for WebSphere Application Serverが動作するOSに，次のOSを追加しました。

Windows Server 2008

PFM - Agent for WebSphere Application Serverの監視対象プログラムに，次のプログラムを追加しました。

IBM WebSphere Application Server V7.0

IBM WebSphere Application Server Network Deployment V7.0

付録L　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

＜この節の構成＞

付録L.1　関連マニュアル

付録L.2　このマニュアルでの表記

付録L.3　英略語

付録L.4　このマニュアルでのプロダクト名，サービスID，およびサービスキーの表記

付録L.5　Performance Managementのインストール先フォルダの表記

付録L.6　Performance Managementで対応するNNM製品について

付録L.7　KB（キロバイト）などの単位表記について

付録L.1　関連マニュアル

関連マニュアルを次に示します。必要に応じてお読みください。

JP1/Performance Management関連

JP1 Version 10 JP1/Performance Management 設計・構築ガイド（3021-3-041）

JP1 Version 10 JP1/Performance Management 運用ガイド（3021-3-042）

JP1 Version 10 JP1/Performance Management リファレンス（3021-3-043）

JP1関連

JP1 Version 8 JP1/Cm2/Network Node Manager ネットワーク管理ガイド（3020-3-L01）

JP1 Version 9 JP1/NETM/DM 運用ガイド1（Windows(R)用）（3020-3-S81）

JP1 Version 6 JP1/NETM/DM Manager（3000-3-841）

JP1 Version 8 JP1/NETM/DM SubManager（UNIX(R)用）（3020-3-L42）

JP1 Version 9 JP1/NETM/DM Client（UNIX(R)用）（3020-3-S85）

付録L.2　このマニュアルでの表記

このマニュアルでは，製品名を次のように表記しています。

表記 | 製品名
AIX | AIX V6.1
AIX V7.1
HP-UX | HP-UX 11i | HP-UX 11i V3 (IPF)
IPF | Itanium(R) Processor Family
JP1/IM | JP1/IM - Manager | JP1/Integrated Management - Manager
JP1/IM - View | JP1/Integrated Management - View
JP1/ITSLM | JP1/IT Service Level Management
JP1/NETM/DM | JP1/NETM/DM Client
JP1/NETM/DM Manager
JP1/NETM/DM SubManager
Linux | Linux (x64) | Linux 6 (x64) | Red Hat Enterprise Linux(R) Server 6 (64-bit x86_64)
Linux (x86) | Linux 6 (x86) | Red Hat Enterprise Linux(R) Server 6 (32-bit x86)
MSCS | Microsoft(R) Cluster Server
Microsoft(R) Cluster Service
NNM | HP NNM | HP Network Node Manager Software バージョン6以前
HP Network Node Manager Starter Edition Software バージョン7.5以前
JP1/Cm2/NNM | JP1/Cm2/Network Node Manager バージョン7以前
JP1/Cm2/Network Node Manager Starter Edition 250 バージョン8以前
JP1/Cm2/Network Node Manager Starter Edition Enterprise バージョン8以前
Performance Management | JP1/Performance Management
PFM - Agent | PFM - Agent for Cosminexus | JP1/Performance Management - Agent Option for uCosminexus Application Server
PFM - Agent for DB2 | JP1/Performance Management - Agent Option for IBM DB2
PFM - Agent for Domino | JP1/Performance Management - Agent Option for IBM Lotus Domino
PFM - Agent for Enterprise Applications | JP1/Performance Management - Agent Option for Enterprise Applications
PFM - Agent for Exchange Server | JP1/Performance Management - Agent Option for Microsoft(R) Exchange Server
PFM - Agent for HiRDB | JP1/Performance Management - Agent Option for HiRDB
PFM - Agent for IIS | JP1/Performance Management - Agent Option for Microsoft(R) Internet Information Server
PFM - Agent for JP1/AJS | PFM - Agent for JP1/AJS2 | JP1/Performance Management - Agent Option for JP1/AJS2
PFM - Agent for JP1/AJS3 | JP1/Performance Management - Agent Option for JP1/AJS3
PFM - Agent for Microsoft SQL Server | JP1/Performance Management - Agent Option for Microsoft(R) SQL Server
PFM - Agent for OpenTP1 | JP1/Performance Management - Agent Option for OpenTP1
PFM - Agent for Oracle | JP1/Performance Management - Agent Option for Oracle
PFM - Agent for Platform | PFM - Agent for Platform(UNIX) | JP1/Performance Management - Agent Option for Platform(UNIX用)
PFM - Agent for Platform(Windows) | JP1/Performance Management - Agent Option for Platform(Windows用)
PFM - Agent for Service Response | JP1/Performance Management - Agent Option for Service Response
PFM - Agent for Virtual Machine | JP1/Performance Management - Agent Option for Virtual Machine
PFM - Agent for WebLogic Server | JP1/Performance Management - Agent Option for BEA WebLogic Server
JP1/Performance Management - Agent Option for Oracle(R) WebLogic Server
PFM - Agent for WebSphere Application Server | JP1/Performance Management - Agent Option for IBM WebSphere Application Server
PFM - Agent for WebSphere MQ | JP1/Performance Management - Agent Option for IBM WebSphere MQ
PFM - Base | JP1/Performance Management - Base
PFM - Manager | JP1/Performance Management - Manager
PFM - RM | PFM - RM for Microsoft SQL Server | JP1/Performance Management - Remote Monitor for Microsoft(R) SQL Server
PFM - RM for Oracle | JP1/Performance Management - Remote Monitor for Oracle
PFM - RM for Platform | PFM - RM for Platform(UNIX) | JP1/Performance Management - Remote Monitor for Platform(UNIX用)
PFM - RM for Platform(Windows) | JP1/Performance Management - Remote Monitor for Platform(Windows用)
PFM - RM for Virtual Machine | JP1/Performance Management - Remote Monitor for Virtual Machine
PFM - Web Console | JP1/Performance Management - Web Console
Solaris | Solaris 10 | Solaris 10 (SPARC)

PFM - Manager，PFM - Agent，PFM - Base，PFM - Web Console，およびPFM - RMを総称して，Performance Managementと表記することがあります。

HP-UX，Solaris，AIX，およびLinuxを総称して，UNIXと表記することがあります。

付録L.3　英略語

このマニュアルで使用する英略語を次に示します。

英略語 | 英字での表記
CPU | Central Processing Unit
DHCP | Dynamic Host Configuration Protocol
FQDN | Fully Qualified Domain Name
HA | High Availability
HTML | Hyper Text Markup Language
HTTP | Hyper Text Transfer Protocol
IP | Internet Protocol
IPv4 | Internet Protocol Version 4
IPv6 | Internet Protocol Version 6
LAN | Local Area Network
NAPT | Network Address Port Translation
NAT | Network Address Translation
ODBC | Open Database Connectivity
OS | Operating System
PMI | Performance Monitoring Infrastructure
SNMP | Simple Network Management Protocol
SOAP | Simple Object Access Protocol
SSL | Secure Socket Layer
TCP | Transmission Control Protocol
TCP/IP | Transmission Control Protocol/Internet Protocol
UAC | User Account Control
Web | World Wide Web

付録L.4　このマニュアルでのプロダクト名，サービスID，およびサービスキーの表記

Performance Management 09-00以降では，プロダクト名表示機能を有効にすることで，サービスIDおよびサービスキーをプロダクト名で表示できます。

識別子 | プロダクト名表示機能
無効 | 有効
サービスID | 2S1ホスト名 | ホスト名<WAS>(Store)
2A1ホスト名 | ホスト名<WAS>
サービスキー | agt2 | WAS

このマニュアルでは，プロダクト名表示機能を有効としたときの形式で表記しています。

なお，プロダクト名表示機能を有効にできるのは，次の条件を同時に満たす場合です。

PFM - Agentの同一装置内の前提プログラム（PFM - ManagerまたはPFM - Base）のバージョンが09-00以降

PFM - Web Consoleおよび接続先のPFM - Managerのバージョンが09-00以降

付録L.5　Performance Managementのインストール先フォルダの表記

このマニュアルでは，Windows版Performance Managementのインストール先フォルダを，インストール先フォルダと表記しています。

PFM - Baseのインストール先フォルダ

Windows Server 2003 (x64)，64ビット版のWindows Server 2008の場合
システムドライブ¥Program Files (x86)¥Hitachi¥jp1pc

上記以外の場合
システムドライブ¥Program Files¥Hitachi¥jp1pc

このマニュアルでは，PFM - Baseのインストール先フォルダを，インストール先フォルダと表記しています。

PFM - Managerのインストール先フォルダ

Windows Server 2003 (x64)，64ビット版のWindows Server 2008の場合
システムドライブ¥Program Files (x86)¥Hitachi¥jp1pc

上記以外の場合
システムドライブ¥Program Files¥Hitachi¥jp1pc

PFM - Web Console のインストール先フォルダ

Windows Server 2003 (x64)，64ビット版のWindows Server 2008の場合
システムドライブ¥Program Files (x86)¥Hitachi¥jp1pcWebCon

上記以外の場合
システムドライブ¥Program Files¥Hitachi¥jp1pcWebCon

UNIX版Performance Managementのデフォルトのインストール先ディレクトリは，次のとおりです。

PFM - Baseのインストール先フォルダ

/opt/jp1pc

PFM - Managerのインストール先ディレクトリ

/opt/jp1pc

PFM - Web Consoleのインストール先ディレクトリ

/opt/jp1pcwebcon

付録L.6　Performance Managementで対応するNNM製品について

Performance Managementでは，次の製品との連携をサポートしています。

HP Network Node Manager Software バージョン6以前

HP Network Node Manager Starter Edition Software バージョン7.5以前

JP1/Cm2/Network Node Manager バージョン7以前

JP1/Cm2/Network Node Manager Starter Edition 250 バージョン8以前

JP1/Cm2/Network Node Manager Starter Edition Enterprise バージョン8以前

このマニュアルでは，これらの製品を「NNM」，これらの製品と連携するための機能を「NNM連携」と表記します。

なお，Performance Managementでは，次の製品との連携はサポートしていません。ご注意ください。

HP Network Node Manager i Software v8.10

JP1/Cm2/Network Node Manager i 09-00以降

付録L.7　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024 バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録M　用語解説

英字｜ア行｜カ行｜サ行｜タ行｜ハ行｜ラ行

英字

Action Handler

PFM - ManagerまたはPFM - Baseのサービスの1つです。アクションを実行するサービスのことです。

Agent Collector

PFM - Agentのサービスの1つです。パフォーマンスデータを収集したり，アラームに設定されたしきい値で，パフォーマンスデータを評価したりするサービスのことです。

Agent Store

PFM - Agentのサービスの1つです。パフォーマンスデータを格納するサービスのことです。Agent Storeサービスは，パフォーマンスデータの記録のためにデータベースを使用します。各PFM - Agentに対応して，各Agent Storeサービスがあります。

Correlator

PFM - Managerのサービスの1つです。サービス間のイベント配信を制御するサービスのことです。アラームの状態を評価して，しきい値を超過するとアラームイベントおよびエージェントイベントを，Trap GeneratorサービスおよびPFM - Web Consoleに送信します。

JP1/ITSLM

業務システムをサービス利用者が体感している性能などの視点で監視し，サービスレベルの維持を支援する製品です。

JP1/ITSLMと連携することで，稼働状況の監視を強化できます。

Master Manager

PFM - Managerのサービスの1つです。PFM - Managerのメインサービスのことです。

Master Store

PFM - Managerのサービスの1つです。各PFM - Agentから発行されたアラームイベントを管理するサービスのことです。Master Storeサービスはイベントデータの保持のためにデータベースを使用します。

Name Server

PFM - Managerのサービスの1つです。システム内のサービス構成情報を管理するサービスのことです。

ODBCキーフィールド

PFM - ManagerまたはPFM - Baseで，SQLを使用してStoreデータベースに格納されているレコードのデータを利用する場合に必要なODBCキーフィールドを示します。ODBCキーフィールドには，全レコード共通のものと各レコード固有のものとがあります。

PDレコードタイプ

→「Product Detailレコードタイプ」

Performance Management

システムのパフォーマンスに関する問題を監視および分析するために必要なソフトウェア群の総称です。Performance Managementは，次の5つのプログラムプロダクトで構成されます。

PFM - Manager

PFM - Web Console

PFM - Base

PFM - Agent

PFM - RM

PFM - Agent

Performance Managementを構成するプログラムプロダクトの1つです。PFM - Agentは，システム監視機能に相当し，監視対象となるアプリケーション，データベース，OSによって，各種のPFM - Agentがあります。PFM - Agentには，次の機能があります。

監視対象のパフォーマンスの監視

監視対象のデータの収集および記録

PFM - Base

Performance Managementを構成するプログラムプロダクトの1つです。Performance Managementの稼働監視をするための基盤機能を提供します。PFM - Agentを動作させるための前提製品です。PFM - Baseには，次の機能があります。

各種コマンドなどの管理ツール

Performance Managementと他システムとの連携に必要となる共通機能

PFM - Manager

Performance Managementを構成するプログラムプロダクトの1つです。PFM - Managerは，マネージャ機能に相当し，次の機能があります。

Performance Managementのプログラムプロダクトの管理

イベントの管理

PFM - Manager名

Storeデータベースに格納されているフィールドを識別するための名称です。コマンドでフィールドを指定する場合などに使用します。

PFM - View名

PFM - Manager名の別名です。PFM - Manager名に比べ，より直感的な名称になっています。例えば，PFM - Manager名の「INPUT_RECORD_TYPE」は，PFM - View名で「Record Type」です。PFM - Web ConsoleのGUI上でフィールドを指定する場合などに使用します。

PFM - Web Console

Performance Managementを構成するプログラムプロダクトの1つです。WebブラウザでPerformance Managementシステムを一元的に監視するためWebアプリケーションサーバの機能を提供します。PFM - Web Consoleには，次の機能があります。

GUIの表示

統合監視および管理機能

レポートの定義およびアラームの定義

PIレコードタイプ

→「Product Intervalレコードタイプ」

Product Detailレコードタイプ

現在起動しているプロセスの詳細情報など，ある時点でのシステムの状態を示すパフォーマンスデータが格納されるレコードタイプのことです。PDレコードタイプは，次のような，ある時点でのシステムの状態を知りたい場合に使用します。

システムの稼働状況

現在使用しているファイルシステム容量

Product Intervalレコードタイプ

1分ごとのプロセス数など，ある一定の時間（インターバル）ごとのパフォーマンスデータが格納されるレコードタイプのことです。PIレコードタイプは，次のような，時間の経過に伴うシステムの状態の変化や傾向を分析したい場合に使用します。

一定時間内に発生したシステムコール数の推移

使用しているファイルシステム容量の推移

Storeデータベース

Agent Collectorサービスが収集したパフォーマンスデータが格納されるデータベースのことです。

Trap Generator

PFM - Managerのサービスの1つです。SNMPトラップを発行するサービスのことです。

ア行

アクション

監視するデータがしきい値に達した場合に，Performance Managementによって自動的に実行される動作のことです。次の動作があります。

Eメールの送信

コマンドの実行

SNMPトラップの発行

JP1イベントの発行

アラーム

監視するデータがしきい値に達した場合のアクションやイベントメッセージを定義した情報のことです。

アラームテーブル

次の情報を定義した1つ以上のアラームをまとめたテーブルです。

監視するオブジェクト（Process，TCP，WebServiceなど）

監視する情報（CPU使用率，1秒ごとの受信バイト数など）

監視する条件（しきい値）

インスタンス

このマニュアルでは，インスタンスという用語を次のように使用しています。

レコードの記録形式を示す場合
1行で記録されるレコードを「単数インスタンスレコード」，複数行で記録されるレコードを「複数インスタンスレコード」，レコード中の各行を「インスタンス」と呼びます。

PFM - Agentの起動方式を示す場合
同一ホスト上の監視対象を1つのエージェントで監視する方式のエージェントを「シングルインスタンスエージェント」と呼びます。これに対して監視対象がマルチインスタンスをサポートする場合，監視対象のインスタンスごとにエージェントで監視する方式のエージェントを「マルチインスタンスエージェント」と呼びます。マルチインスタンスエージェントの各エージェントを「インスタンス」と呼びます。

エージェント

パフォーマンスデータを収集するPFM - Agentのサービスのことです。

カ行

監視テンプレート

PFM - Agentに用意されている，定義済みのアラームとレポートのことです。監視テンプレートを使用することで，複雑な定義をしなくてもPFM - Agentの運用状況を監視する準備が容易にできるようになります。

管理ツール

サービスの状態の確認やパフォーマンスデータを操作するために使用する各種のコマンドまたはGUI上の機能のことです。次のことができます。

サービスの構成および状態の表示

パフォーマンスデータの退避および回復

パフォーマンスデータのテキストファイルへのエクスポート

パフォーマンスデータの消去

クラスタシステム

クラスタシステムとは，複数のサーバシステムを連携して1つのシステムとして運用するシステムで，障害が発生しても業務を継続できるようにすることを目的としています。業務を実行中のサーバ（実行系）で障害が発生すると，待機していた別のサーバ（待機系）が業務の処理を引き継ぎます。実行「系」から待機「系」へ業務を切り替えるので，「系切り替えシステム」とも呼びます。

なお，クラスタシステムという用語には，並列処理による負荷分散機能という意味もありますが，このマニュアルでは，系を切り替えて業務の中断を防ぐ機能のことだけを指します。

サ行

サービスID

Performance Managementプログラムのサービスに付加された，一意のIDのことです。コマンドを使用してPerformance Managementのシステム構成を確認する場合，または個々のエージェントのパフォーマンスデータをバックアップする場合などは，Performance ManagementプログラムのサービスIDを指定してコマンドを実行します。サービスIDは，次の4つから構成されます。

サービスIDの形式は，プロダクト名表示機能の設定によって異なります。サービスIDの形式については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，Performance Managementの機能について説明している章を参照してください。

実行系ノード

クラスタシステムを構成するそれぞれのサーバシステムの，業務を実行中のノード（論理ホストがアクティブなノード）のことです。

スタンドアロンモード

PFM - Agent単独で起動している状態のことです。PFM - ManagerのMaster ManagerサービスおよびName Serverサービスが，障害などのため起動できない状態でも，PFM - Agentだけを起動して，パフォーマンスデータを収集できます。

ステータス管理機能

PFM - ManagerおよびPFM - Agent上で動作するすべてのサービスの状態を管理する機能です。ステータス管理機能を用いると，システム管理者は各ホストでのサービスの起動や停止などの状態を正しく把握できるため，障害復旧のための適切な対処を迅速に行うことができます。

タ行

待機系ノード

クラスタシステムを構成するそれぞれのサーバシステムの，実行系ノードの障害時に業務を引き継げるよう待機しているノードのことです。

単数インスタンスレコード

1行で記録されるレコードです。このレコードは，固有のODBCキーフィールドを持ちません。

→「インスタンス」を参照してください。

データベースID

PFM - Agentの各レコードに付けられた，レコードが格納されるデータベースを示すIDです。データベースIDは，そのデータベースに格納されるレコードの種類を示しています。データベースIDを次に示します。

PI：PIレコードタイプのレコードのデータベースであることを示します。

PD：PDレコードタイプのレコードのデータベースであることを示します。

データモデル

各PFM - Agentが持つレコードおよびフィールドの総称のことです。データモデルは，バージョンで管理されています。

ハ行

バインド

アラームをエージェントと関連づけることです。バインドすると，エージェントによって収集されているパフォーマンスデータがアラームで定義したしきい値に達した場合，ユーザーに通知できるようになります。

パフォーマンスデータ

監視対象システムから収集したリソースの稼働状況データのことです。

フィールド

レコードを構成するパフォーマンスデータの集まりのことです。

複数インスタンスレコード

複数行で記録されるレコードです。このレコードは，固有のODBCキーフィールドを持っています。

→「インスタンス」を参照してください。

物理ホスト

クラスタシステムを構成する各サーバに固有な環境のことです。物理ホストの環境は，フェールオーバー時にもほかのサーバに引き継がれません。

プロダクトID

該当するPerformance Managementプログラムのサービスが，Performance Managementのどのプログラムプロダクトのものかを示す1バイトの識別子のことです。サービスIDの一部です。

ラ行

ライフタイム

各レコードに収集されるパフォーマンスデータの一貫性が保証される期間のことです。

リアルタイムレポート

監視対象の現在の状況を示すレポートです。

履歴レポート

監視対象の過去から現在までの状況を示すレポートです。

レコード

収集したパフォーマンスデータを格納する形式のことです。レコードの種類は，Storeデータベースの各データベースによって異なります。

レポート

PFM - Agentが収集したパフォーマンスデータをグラフィカルに表示する際の情報を定義したものです。主に，次の情報を定義します。

レポートに表示させるレコード

パフォーマンスデータの表示項目

パフォーマンスデータの表示形式（表，グラフなど）

論理ホスト

クラスタシステムでの運用時にWebSphere Application Serverの実行環境となる論理上のサーバのことです。障害の発生時には，論理ホスト単位で系が切り替わります。

論理ホストは専用のIPアドレスを持ち，系切り替え時にはそのIPアドレスを引き継いで動作します。そのため，障害で物理的なサーバが切り替わった場合も，クライアントからは同じIPアドレスでアクセスでき，1つのサーバが常に動作しているように見えます。

索引

[Ａ][Ｃ][Ｅ][Ｈ][Ｉ][Ｊ][Ｌ][Ｍ][Ｎ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｗ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(英字)

(Ａ)

Action Handler

Agent Collector

Agent Collectorサービスのプロパティ一覧

Agent Store

Agent Storeサービスのプロパティ一覧

(Ｃ)

Correlator

(Ｅ)

EJB（PI_EJB）レコード

(Ｈ)

HAクラスタシステム

(Ｉ)

IPアドレスの設定〔UNIXの場合〕

IPアドレスの設定〔Windowsの場合〕

(Ｊ)

J2C Connection Pool（PI_J2C）レコード

J2C Connection Pool Use Rate（最近1時間の履歴レポート）

Java VM（PI_JVM）レコード

JavaVMのCPU使用率の監視

JavaVMのメモリー使用率の監視

JDBC Connection Pool（PI_JDBC）レコード

JDBC Connection Pool Use Rate（最近1か月間の履歴レポート）

JDBC Connection Pool Use Rate（最近1時間の履歴レポート）

JDBC Connection Pool Use Rate（最近24時間の履歴レポート）

JDBC Connection Pool Use Rate（リアルタイムレポート）

JDBC Connection Poolアラーム

JDBC接続プールの使用率の監視

JP1/ITSLM

jpcconf inst list (jpcinslist)コマンド ,[2]

jpcconf inst setup (jpcinssetup)コマンド ,[2]

jpcconf inst unsetup (jpcinsunsetup)コマンド ,[2]

jpchostsファイル ,[2]

jpcrasコマンド

jpctool service delete (jpcctrl delete)コマンド ,[2]

JVM Resource Use Rate（最近1か月の履歴レポート）

JVM Resource Use Rate（最近1時間の履歴レポート）

JVM Resource Use Rate（最近24時間の履歴レポート）

JVM Resource Use Rate（リアルタイムレポート）

JVM Use CPUアラーム

JVM Use Memoryアラーム

(Ｌ)

LANG環境変数を設定する

Lookup Time（最近1時間の履歴レポート）

(Ｍ)

Master Manager

Master Store

Method Response Time（最近1時間の履歴レポート）

(Ｎ)

Name Server

(Ｏ)

ODBCキーフィールド

ODBCキーフィールド一覧

ORB（PI_ORB）レコード

(Ｐ)

Password〔UNIXの場合〕

Password〔Windowsの場合〕

PD

PDレコードタイプ ,[2]

Performance Management

Performance Managementシステムの障害回復

Performance Managementの障害検知

PFM - Agent

PFM - Agent for WebSphere Application Serverのアンインストールとアンセットアップの流れ〔UNIXの場合〕

PFM - Agent for WebSphere Application Serverのアンインストールとアンセットアップの流れ〔Windowsの場合〕

PFM - Agent for WebSphere Application Serverの運用方式の変更〔UNIXの場合〕

PFM - Agent for WebSphere Application Serverの運用方式の変更〔Windowsの場合〕

PFM - Agent for WebSphere Application Serverの運用方式の変更〔クラスタ運用時〕

PFM - Agent for WebSphere Application Serverの概要

PFM - Agent for WebSphere Application Serverのシステム構成の変更〔UNIXの場合〕

PFM - Agent for WebSphere Application Serverのシステム構成の変更〔Windowsの場合〕

PFM - Agent for WebSphere Application Serverのシステム構成の変更〔クラスタ運用時〕

PFM - Agent for WebSphere Application Serverの接続先PFM - Managerの設定〔UNIXの場合〕

PFM - Agent for WebSphere Application Serverの接続先PFM - Managerの設定〔Windowsの場合〕

PFM - Agent for WebSphere Application Serverのセットアップ手順〔UNIXの場合〕

PFM - Agent for WebSphere Application Serverのセットアップ手順〔Windowsの場合〕

PFM - Agent for WebSphere Application Serverのセットアップファイル〔UNIXの場合〕

PFM - Agent for WebSphere Application Serverのセットアップファイル〔Windowsの場合〕

PFM - Agent for WebSphere Application Serverの登録〔UNIXの場合〕

PFM - Agent for WebSphere Application Serverの登録〔Windowsの場合〕

PFM - Agent for WebSphere Application Serverの特長

PFM - Agent for WebSphere Application Serverを使ったパフォーマンス監視の例

PFM - Agentの登録〔UNIXの場合〕

PFM - Agentの登録〔Windowsの場合〕

PFM - Agentの論理ホストのアンセットアップ〔UNIXの場合〕

PFM - Agentの論理ホストのアンセットアップ〔Windowsの場合〕

PFM - Agentの論理ホストのセットアップ〔UNIXの場合〕

PFM - Agentの論理ホストのセットアップ〔Windowsの場合〕

PFM - Agentホストに障害が発生した場合のフェールオーバー

PFM - Base

PFM - Manager

PFM - Managerが停止した場合の影響

PFM - Managerでの設定の削除〔UNIXの場合〕

PFM - Managerでの設定の削除〔Windowsの場合〕

PFM - Manager名

PFM - View名

PFM - Web Console

PI

PI_EJB

PI_J2C

PI_JDBC

PI_JVM

PI_ORB

PI_SVLT

PI_THRP

PI_TRNS

PI_WEBA

PI_WEBC

PI_WEBS

PIレコードタイプ ,[2]

Product Detailレコードタイプ

Product Intervalレコードタイプ

(Ｒ)

Response Time（最近1時間の履歴レポート）

(Ｓ)

Server Information（PI）レコード

Server State（PD）レコード

Server State（最近1時間の履歴レポート）

Server Stateアラーム

Service Time（最近1時間の履歴レポート）

Servlet（PI_SVLT）レコード

SOAP Connector Port Number〔UNIXの場合〕

SOAP Connector Port Number〔Windowsの場合〕

Store Version〔UNIXの場合〕

Store Version〔Windowsの場合〕

Storeデータベース ,[2]

Storeデータベースに格納されているデータをエクスポートすると出力されるフィールド

Storeデータベースに記録されるときだけ追加されるフィールド

syslogとWindowsイベントログの一覧

(Ｔ)

Thread Pool（PI_THRP）レコード

Thread Pool Use Rate（最近1か月間の履歴レポート）

Thread Pool Use Rate（最近1時間の履歴レポート）

Thread Pool Use Rate（最近24時間の履歴レポート）

Thread Pool Use Rate（リアルタイムレポート）

Thread Poolアラーム

Transaction（PI_TRNS）レコード

Trap Generator

TrustStore File Path〔UNIXの場合〕

TrustStore File Path〔Windowsの場合〕

TrustStore Password〔UNIXの場合〕

TrustStore Password〔Windowsの場合〕

(Ｕ)

User Name〔UNIXの場合〕

User Name〔Windowsの場合〕

(Ｗ)

Web Application（PI_WEBA）レコード

Web Container（PI_WEBC）レコード

Web Service（PI_WEBS）レコード

WebSphere Application Server Installation Directory〔UNIXの場合〕

WebSphere Application Server Installation Directory〔Windowsの場合〕

WebSphere Application Server Version〔UNIXの場合〕

WebSphere Application Server Version〔Windowsの場合〕

WebSphere Application Serverの稼働状態の監視

Webブラウザでマニュアルを参照するための設定 ,[2]

(ア行)

(あ)

アクション ,[2]

アラーム ,[2]

アラーム一覧

アラームテーブル ,[2]

アラームの記載形式

アンインストール手順〔UNIXの場合〕 ,[2]

アンインストール手順〔Windowsの場合〕 ,[2]

アンインストールとアンセットアップ〔UNIXの場合〕 ,[2]

アンインストールとアンセットアップ〔Windowsの場合〕 ,[2]

アンインストールに必要なOSユーザー権限に関する注意事項

アンセットアップ手順〔UNIXの場合〕 ,[2]

アンセットアップ手順〔Windowsの場合〕 ,[2]

(い)

インスタンス

インスタンス環境のアンセットアップ〔UNIXの場合〕

インスタンス環境のアンセットアップ〔Windowsの場合〕

インスタンス環境の更新の設定〔クラスタ運用時〕

インスタンス環境の設定〔UNIXの場合〕 ,[2]

インスタンス環境の設定〔Windowsの場合〕 ,[2]

インストール手順〔UNIXの場合〕 ,[2]

インストール手順〔Windowsの場合〕 ,[2]

インストールとセットアップ（UNIXの場合） ,[2]

インストールとセットアップ（Windowsの場合） ,[2]

インストールとセットアップ〔UNIXの場合〕

インストールとセットアップ〔Windowsの場合〕

インストールとセットアップの流れ〔UNIXの場合〕 ,[2]

インストールとセットアップの流れ〔Windowsの場合〕 ,[2]

インストールとセットアップの前に〔UNIXの場合〕 ,[2]

インストールとセットアップの前に〔Windowsの場合〕 ,[2]

(え)

エイリアス名 ,[2]

エージェント

(カ行)

(か)

カーネルパラメーター

稼働状況ログ

環境変数に関する注意事項 ,[2]

監視テンプレート ,[2] ,[3] ,[4]

監視テンプレートの概要

管理ツール

(き)

共通メッセージログ ,[2]

共有ディスクのアンマウント〔UNIXの場合〕 ,[2]

共有ディスクのマウント〔UNIXの場合〕 ,[2]

共有ディスクをオフラインにする〔Windowsの場合〕 ,[2]

共有ディスクをオンラインにする〔Windowsの場合〕 ,[2]

(く)

クラスタ運用時のディスク占有量

クラスタシステム

クラスタシステムでのインストールとセットアップについて〔UNIXの場合〕

クラスタシステムでのインストールとセットアップについて〔Windowsの場合〕

クラスタシステムでの運用

クラスタシステムでの環境設定〔UNIXの場合〕

クラスタシステムでの環境設定〔Windowsの場合〕

クラスタシステムの概要

クラスタソフトからのPFM - Agentの登録解除〔UNIXの場合〕

クラスタソフトからのPFM - Agentの登録解除〔Windowsの場合〕

クラスタソフトからの起動・停止の確認〔UNIXの場合〕

クラスタソフトからの起動・停止の確認〔Windowsの場合〕

クラスタソフトからの停止〔UNIXの場合〕

クラスタソフトからの停止〔Windowsの場合〕

クラスタソフトへのPFM - Agentの登録〔UNIXの場合〕

クラスタソフトへのPFM - Agentの登録〔Windowsの場合〕

(こ)

コマンドプロンプトの起動方法

(サ行)

(さ)

サービスID

サービスに関する注意事項

(し)

識別子一覧

システム見積もり

システムログ

実行系ノード

実ホスト名 ,[2]

資料の採取方法

(す)

スタンドアロンモード

ステータス管理機能 ,[2]

スレッドプール使用率の監視

(せ)

接続先PFM - Managerの設定〔UNIXの場合〕

接続先PFM - Managerの設定〔Windowsの場合〕

セットアップコマンドを実行する〔UNIXの場合〕

セットアップコマンドを実行する〔Windowsの場合〕

セットアップ手順〔UNIXの場合〕

セットアップ手順〔Windowsの場合〕

前提プログラム〔UNIXの場合〕

前提プログラム〔Windowsの場合〕

(そ)

その他の注意事項〔アンインストール・アンセットアップ：UNIXの場合〕

その他の注意事項〔アンインストール・アンセットアップ：Windowsの場合〕

(タ行)

(た)

他Performance Managementプログラムの論理ホストのアンセットアップ〔UNIXの場合〕

他Performance Managementプログラムの論理ホストのアンセットアップ〔Windowsの場合〕

他Performance Managementプログラムの論理ホストのセットアップ〔UNIXの場合〕

他Performance Managementプログラムの論理ホストのセットアップ〔Windowsの場合〕

待機系ノード

単数インスタンスレコード

(て)

ディスク占有量

データ型一覧

データベースID

データモデル ,[2] ,[3]

(と)

同一ホストにPerformance Managementプログラムを複数インストール，セットアップするときの注意事項〔UNIXの場合〕

同一ホストにPerformance Managementプログラムを複数インストール，セットアップするときの注意事項〔Windowsの場合〕

動作ログ出力の設定

動作ログの出力

トラブルシューティング

トラブル発生時に採取が必要な資料

トラブルへの対処方法

トレースログ ,[2]

(ナ行)

(ね)

ネットワークに関する注意事項

ネットワークの設定〔UNIXの場合〕 ,[2]

ネットワークの設定〔Windowsの場合〕 ,[2]

(ハ行)

(は)

バージョンアップの注意事項 ,[2]

バージョン互換

バインド ,[2]

バックアップ ,[2]

パフォーマンス監視の目的

パフォーマンスデータ

パフォーマンスデータの格納先の変更 ,[2] ,[3]

パフォーマンスデータの格納先の変更〔UNIXの場合〕

パフォーマンスデータの格納先の変更〔Windowsの場合〕 ,[2]

パフォーマンスデータの管理方法

パフォーマンスデータの収集と管理の概要

パフォーマンスデータの収集方法

(ふ)

ファイアウォールの通過方向

ファイルおよびディレクトリ一覧

フィールド ,[2] ,[3]

フィールドの値

フェールオーバー時の処理

複数インスタンスレコード

物理ホスト

プログラムに関する注意事項

プロセス一覧

プロダクトID

プロパティ

(へ)

ベースラインの選定

(ほ)

ポート番号

ポート番号一覧

ポート番号の設定〔UNIXの場合〕

ポート番号の設定〔Windowsの場合〕

ポート番号の設定の解除〔UNIXの場合〕

ポート番号の設定の解除〔Windowsの場合〕

(マ行)

(め)

メッセージ

メッセージ一覧

メッセージの記載形式

メッセージの形式

メッセージの出力形式

メッセージの出力先一覧

メモリー所要量

(ヤ行)

(よ)

要約ルール

(ラ行)

(ら)

ライフタイム

(り)

リアルタイムレポート ,[2]

リストア ,[2]

履歴レポート ,[2]

(れ)

レコード ,[2] ,[3] ,[4]

レコード一覧

レコードの記載形式

レポート ,[2]

レポート一覧

レポートの記載形式

レポートのフォルダ構成

(ろ)

ログ情報

ログのファイルサイズ変更 ,[2]

ログのファイルサイズ変更〔UNIXの場合〕

ログのファイルサイズ変更〔Windowsの場合〕

ログファイルおよびディレクトリ一覧

論理ホスト

論理ホスト環境定義ファイルのインポート〔UNIXの場合〕 ,[2]

論理ホスト環境定義ファイルのインポート〔Windowsの場合〕 ,[2]

論理ホスト環境定義ファイルのエクスポート・インポート〔クラスタ運用時〕

論理ホスト環境定義ファイルのエクスポート〔UNIXの場合〕 ,[2]

論理ホスト環境定義ファイルのエクスポート〔Windowsの場合〕 ,[2]

論理ホスト環境定義ファイルの待機系ノードへのコピー〔UNIXの場合〕 ,[2]

論理ホスト環境定義ファイルの待機系ノードへのコピー〔Windowsの場合〕 ,[2]

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
AMDは，Advanced Micro Devices, Inc.の商標です。
BEAは，BEA Systems, Inc.の登録商標です。
BEA JRockitは，BEA Systems, Inc.の商標です。
BEA WebLogic Serverは，BEA Systems, Inc.の登録商標です。
DB2は，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
DB2 Universal Databaseは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
HP-UXは，Hewlett-Packard Development Company, L.P.のオペレーティングシステムの名称です。
IBMは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。
Lotusは，IBM Corporationの登録商標です。
Lotus Dominoは，IBM Corporationの登録商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Exchange Serverは，米国Microsoft Corporationの商品名称です。
MicrosoftおよびHyper-Vは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Internet Information Serverは，米国Microsoft Corporationの商品名称です。
Microsoft Internet Information Servicesは，米国Microsoft Corporationの商品名称です。
MicrosoftおよびSQL Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
NetWareは，米国Novell, Inc.の登録商標です。
ODBCは，米国Microsoft Corporationが提唱するデータベースアクセス機構です。
OpenViewは，Hewlett-Packard Development Company, L.P.の商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
R/3は，SAP AGのドイツ及びその他の国における登録商標または商標です。
Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。
SAPは，SAP AGのドイツ及びその他の国における登録商標または商標です。
すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
VMware, Virtual SMP, VMotionは，VMware, Inc.の米国および各国での登録商標または商標です。
VMwareおよびESXは，VMware, Inc.の米国および各国での登録商標または商標です。
WebSphereは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Win32は，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows NTは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。
プログラムプロダクト「P-9D2C-AAA1，P-9D2C-ARA1」には，Oracle Corporationまたはその子会社，関連会社が著作権を有している部分が含まれています。
プログラムプロダクト「P-9D2C-AAA1，P-9D2C-ARA1」には，UNIX System Laboratories, Inc.が著作権を有している部分が含まれています。
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
This product includes software developed by IAIK of Graz University of Technology.
Oracle and Java are registered trademarks of Oracle and/or its affiliates.
Other company and product names mentioned in this document may be the trademarks of their respective owners.