ダウンロード：ジェニファーインストールガイド - e

JENNIFER 4
インストールガイド
JENNIFER 4 インストールガイド
2009 年 06 月 10 日初版リリース
著　者
JENNIFERSOFT,Inc
Copyright © 2009 by JENNIFERSOFT, Inc.
All Rights Reserved.
本文書は JENNIFERSOFT,Inc が発行した文書であり著作権法により保護された著作物であるため発行所の許可
なく無断転載や複製を禁じます。
著作権案内
本文書の著作権及び知的財産権はJENNIFERSOFT,Inc（以下当社）にあります。
本文書及び本文書の複写本全体或いは一部分に対してコピーライト(Copyright)など文書及び製品と
関連する登録商標や知的財産権などの標識を毀損、修正、分離、削除することはできません。本権利は
韓国の著作権関連法と国際著作権協約をはじめ知的財産権法律及び協約により保護されます。
本文書は韓国内での使用に関することに限り、アメリカ、日本などその他の国家においては本文書の
配布及び使用を制限します。
本文書には当社が所有している特許に関する内容が含まれてる可能性があります。当社は本文書で言
及した内容に関連して特許と関連するなんらの権利を提供するものではありません。
本文書は基本的に当社の承認なしで商業的な用途で使用、譲渡、販売、配布することを禁じます。但
し、本文書はJENNIFERSOFTのアプリケーション性能管理ソリューションであるJENNIFER™につ
いての製品説明および運用/管理についての情報を提供する目的で作成されているため、JENNIFER製
品ライセンスの範囲内で題名、表紙、日付、著者及び著作権表示などを含んだ文書全体を複写したり電
子文書でジェニファーユーザに伝えることは例外的に許容します。このような場合でも本文書に対する
著作権や知的財産権が移管さたり販売されることはなく、その使用だけを承諾します。
本文書は技術的誤謬や記述的誤謬を含んでいる可能性があります。当社は本文書の情報の正確性を維
持するために最大限の努力を尽くしておりますが、本文書の技術的誤謬、誤った情報が含まれてないこ
とを保証するものではありません。本文書は予告なしに持続的に修正・補完されますが、本文書に記述
されている情報によって発生し得る直接的あるいは間接的な損害、データ、プログラム、その他無形の
財産に関する損失、使用利益の損失などに関して、たとえ、これらの損害可能性について事前に承知の
ことであっても、損害賠償その他の責任を負うことはありません。
ユーザは本文書を購入するか、電子文書でダウンロードすることにより使用を始めることで本事項に
明記された内容を理解し、これに同意するものとみなします。また、本内容がこれ以前の説明やその他
告知に優先することを承認したとみなします。
JENNIFER™とJENNIFERSOFT®は当社の固有登録商標であり、特許法と著作権法などにより保
護されます。当社の許可なしで無断に該当商標を使用したり配布する者は法律により処罰されます。
JENNIFERSOFT® JENNIFER™
iii
Trademarks
商標について
Microsoft、Windows、Windows Server、Windows Vista、Internet Information Server、Internet
Explorer およびExcel は、米国あるいはその他の国における米国Microsoft Corporation の商標または
登録商標です。Windows の正式名称は、Microsoft Windows Operating System です。
Netscape Navigator、Netscape Communicator およびNetscape Enterprise Server は、Netscape
Communications Corporation の商標です。
UNIX は、X/Open カンパニーリミテッドが独占的にライセンスしている米国ならびに他の国におけ
る登録商標です。
Sun、Sun Microsystems、Sun One およびSun Java は、米国およびその他の国における米国Sun
Microsystems,Inc.の商標もしくは登録商標です。
JavaおよびすべてのJava 関連の商標は、米国およびその他の国における米国Sun Microsystems,Inc.
の商標または登録商標です。
Solaris は、米国Sun Microsystems,Inc.の登録商標です。
すべてのSPARC 商標は、米国SPARC International,Inc.のライセンスを受けて使用している同
社の米国およびその他の国における商標または登録商標です。
X/Open は、X/Open カンパニーがライセンスしている米国ならびに他の国における商標です。
Intel およびItanium は、米国Intel Corporation の商標または登録商標です。
Linux は、Linus Torvalds の米国およびその他の国における商標または登録商標です。
Red Hat は、米国およびその他の国におけるRed Hat,Inc.の商標または登録商標です。
Oracle は、米国ORACLE Corporation の登録商標です。
HP、HP-UX およびPA-RISC は、米国Hewlett-Packard Company の商標です。
IBM は、米国IBM Corporation の登録商標です。
DB2、DB2 Universal Database、Cloudscape は、IBM Corp.の米国またはその他の国における商標
です。
MQSeries は、IBM Corporation の商標もしくは登録商標です。
Sybase およびAdaptive Server、Adaptive Server Enterprise は、Sybase,Inc.の登録商標または商標
です。
DataDirect およびDataDirect Connect、SequeLink は、DataDirect Technologies,Incの商標または
登録商標です。
TUXEDO は、米国BEA Systems, Inc. の米国およびその他の地域における登録商標です。
iv
JENNIFER4.0 マニュアル
Adobe、Adobe ロゴ、Reader は、Adobe Systems Incorporated(アドビシステムズ社)の米国なら
びに他の国における商標または登録商標です。
Macromedia、JRun およびFlash は、米国Macromedia,Inc.の米国またはその他の国での商標
または登録商標です。
CORBA、IDL、IIOP、OMG は、米国Object Management Group, Inc.の米国またはその他の国に
おける商標または登録商標です。
JBuilder は、米国Borland Software Corporation の米国およびその他の国における商標または登録
商標です。
This product includes software developed by the Apache Software Foundation (http://
www.apache.org/).
各会社の製品名を含み以上に明示された商標は各開発会社の登録商標であり、特許法と著作権法など
により保護されます。従って、その他全ての製品と会社名は各該当所有主の商標として参照用としての
み使用されます。その他、記載されている会社名、製品名は、各社の登録商標または商標です。
v
vi
JENNIFER4.0 マニュアル
Table of Contents
Chapter 1 JENNIFER概要
1
JENNIFERパッケージング構成要素 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
JENNIFERディレクトリ構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
JENNIFERネットワーク構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Chapter 2 JENNIFERサーバインストール
7
JENNIFERサーバスペック . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
JENNIFERサーバインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
UNIX用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
クライアント設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 3 インストールガイド（WebSphere用）
21
UNIX 環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
WebSphere インストール環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
事前インストール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ポストインストール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
WebSphere の再起動及び確認事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
21
22
26
27
28
Windows 環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
WebSphere インストール環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
事前インストール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ポストインストール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
WebSphere の再起動及び確認事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 4 インストールガイド（WebLogic用）
28
29
34
35
36
37
UNIX 環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
WebLogic インストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
事前インストール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ポストインストール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
インストールの確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
37
38
42
43
44
Windows 環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
WebLogic インストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
事前インストール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
ポストインストール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Table of Contents
vii
インストールの確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Chapter 5 インストールガイド（Tomcat用）
51
UNIX環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Tomcatインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
事前インストール(Pre-Installation)作業. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Windows環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Tomcatインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
事前インストール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Chapter 6 インストールガイド（Resin用）
67
UNIX環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Resinインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
事前インストール(Pre-Installation)作業. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Windows環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Resinインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
事前インストール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Chapter 7 インストールガイド（JBoss用）
85
UNIX環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
JBossインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
事前インストール(Pre-Installation)作業. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Windows環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
JBossインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
事前インストール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
viii
JENNIFER4.0 マニュアル
Chapter 8 インストールガイド（Oracle AS用）
103
UNIX環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Oracle ASインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
事前インストール(Pre-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
103
104
108
109
110
Windows環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Oracle ASインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
事前インストール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 9 インストールガイド（GLASSFISH用）
110
111
114
115
116
119
UNIX環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
GlassFishインストール環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
事前インストール(Pre-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
119
120
124
125
126
Windows環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
GlassFishインストール環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
事前インストール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 10 インストールガイド（Sun AS用）
126
127
130
131
132
135
UNIX環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Sun ASインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
事前インストール(Pre-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
135
136
140
141
142
Windows環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Sun ASインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
事前インストール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 11 インストールガイド（Interstage用）
142
143
147
148
149
151
Table of Contents
ix
UNIX環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Interstageインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
事前インストール(Pre-Installation)作業. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Windows環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Interstageインストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
事前インストール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
ポストインストール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
インストール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
JENNIFERエージェント構成削除。 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Chapter 12 インストールガイド（Cosminexus用）
169
UNIX 環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Cosminexus インストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
事前インストール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
ポストインストール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Cosminexus の再起動及び確認事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
JENNIFERエージェント構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Windows 環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Cosminexus インストール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
事前インストール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
ポストインストール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Cosminexus の再起動及び確認事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
JENNIFERエージェント構成削除。 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Chapter 13 構成変更及びトラブルシューティング
187
JENNIFERサーバ構成変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
クライアントのための設定変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
JENNIFERエージェントのための設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
JENNIFER使用のためのファイアウォール設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
１つのサーバに複数のJENNIFERエージェントをインストール . . . . . . . . . . . . . . . . . . . 190
インストールのトラブルシューティング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
エージェントインストール後にWebアプリケーションサーバが稼働しない場合. . . . . . . . . . . . . . 191
JENNIFERエージェントがサーバに登録されない場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Invalid LicenseKey メッセージが出力される場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
License Keyを登録できない場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
CPU/ メモリ情報が表示されない場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
X-Viewに点が表示されない場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
X-ViewプロファイルでSQLが表示されない場合. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
X-ViewプロファイルでSQLパラメータが正常に表示されない場合 . . . . . . . . . . . . . . . . . . . . . . . . 195
JENNIFERエージェントインストール後、ネイティブメモリリークが発生した場合 . . . . . . . . . . 195
エージェントインストール後、アプリケーションクッキー情報が失われた場合. . . . . . . . . . . . . . 196
Oracle DB使用時、 ClassCastExceptionが発生する場合. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
x
JENNIFER4.0 マニュアル
同じ設定で多重プロセスにインストールする場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
オンラインインストールテクニカルサポートの問い合わせ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Table of Contents
xi
xii
JENNIFER4.0 マニュアル
文書構成
本文書は概念的理解を段階的に深めていけるように順次構成されています。しかし、関連主題別に必
要に応じて読めるようできる限り独立した構成となっています。本文書の構成は次の通りです。
1章、「JENNIFER概要」JENNIFERのモジュールの構成と概念に関して紹介します。
2章、
「JENNIFERサーバインストール」JENNIFERサーバのインストール方法について説明します。
3章、「インストールガイド（WebSphere用）」WebSphereにJENNIFERエージェントをインストー
ルする方法について説明します。
4章、「インストールガイド（WebLogic用）」WebSphereにJENNIFERエージェントをインストール
する方法について説明します。
5章、「インストールガイド（Tomcat用）」TomcatにJENNIFERエージェントをインストールする方
法について説明します。
6章、
「インストールガイド（Resin用）
」ResinにJENNIFERエージェントをインストールする方法に
ついて説明します。
7章、「インストールガイド（JBoss用）」JBossにJENNIFERエージェントをインストールする方法
について説明します。
8章、「インストールガイド（Oracle AS用）」Oracle Application ServerにJENNIFERエージェント
をインストールする方法について説明します。
9章、
「インストールガイド（GlassFish用）」GlassFishにJENNIFERエージェントをインストールす
る方法について説明します。
10章、
「インストールガイド（Sun AS用）」Sun Application ServerにJENNIFERエージェントをイ
ンストールする方法について説明します。
11章、
「構成変更及びトラブルシューティング」リアルタイムモニタリング、統計分析及びJENNIFER
レポートについて説明します。
xiii
xiv
JENNIFER4.0 マニュアル
xv
xvi
JENNIFER4.0 マニュアル
1
JENNIFER概要
この章ではJENNIFERサーバ及びエージェントのインストールについての理解のためJENNIFER
の構成要素及び構造について簡単に説明します。詳細についてはJENNIFERマニュアルをご参照くだ
さい。
1.1.
JENNIFERパッケージング構成要素
JENNIFERはサーバ、エージェント、REMON、クライアントで構成されています。
各構成要素が担う役割は以下の通りです。
• JENNIFERエージェント : モニタリングするJavaアプリケーションサーバにインストールされ、
様々な性能データをJENNIFERサーバへ送信する役割をします。
• JENNIFERサーバ : エージェントから送信された性能データを加工してファイルとデータベースに
保存し、ユーザや権限やメニューなどについての構成情報などを管理する役割をします。
• JENNIFERクライアント : SUN Javaプラグイン1.6.0_10以上がインストールされたWebブラウザ
(IE 7.0, IE 8.0,FireFox3.xなど)で収集された性能データを直感的に把握できるようにする役割をし
ます。
1
• REMON : JENNIFERエージェントがインストールされたJavaアプリケーションサーバ以外のITリ
ソースについての性能データやビジネスデータを収集してJENNIFERサーバで該当データを管理で
きるようにします。
1.2.
JENNIFERディレクトリ構造
JENNIFERディレクトリはserver, agent, remonにより構成されています。
• server : JENNIFERサーバ運用のためのファイルが存在します。
• agent : JENNIFERエージェント構成のためのファイルが存在します。
• remon : REMON構成のためのファイルが存在します。
JENNIFERエージェントディレクトリ(agent)をJENNIFERエージェントをインストールするJava
アプリケーションサーバが運用中のサーバ(server)に移し、エージェントインストールの方法に従って
JENNIFERモニタリングシステムを構成します。
JENNIFER独立エージェントディレクトリ(remon)は必要なITリソースを性能データやビジネス
データ収集が必要なサーバ(server)へ移し、remonインストール方法に従ってJENNIFERモニタリン
グシステムを構成します。
1.3.
JENNIFERネットワーク構造
JENNIFERは、サーバを中心に、ユーザ(ブラウザ)とは2つのTCP通信(デフォルトポート7900,
6701)を、エージェントとは3つのUDP通信(デフォルトポート6901、6902、6703)と1つのTCP通信(デ
フォルトポート7750)を行います。
下の図はユーザ(PC)、JENNIFERサーバ、JENNIFERエージェント間の基本ネットワークアーキ
テクチャを説明したものです。
ユーザ(ブラウザ)、JENNIFERサーバ、JENNIFERエージェントが運用中のネットワーク間にファ
イアウォールがある場合、事前に各ポートが許容されるように準備しておく必要があります。
2
JENNIFER4.0 インストールガイド
図 1-1:
JENNIFERネットワークアーキテクチャ
1. JENNIFER 概要
3
1.3.0.1. JENNIFERエージェントとJENNIFERサーバ通信
UDP 通信オプション指定
JENNIFERエージェントは、収集されたデータをUDP方式でJENNIFERサーバに送信します。
JENNIFERサーバは、JENNIFERエージェントが送ったデータを3つのUDPポートに分けて受取りま
す。
下記に紹介する3つのUDPポートは、JENNIFERエージェント構成ファイルとサーバ構成ファイル
全て同一です。JENNIFERサーバ/エージェントインストールシステム環境制限のためポート変更が必
要な場合、両側の構成ファイル全てを同一に変更しなければなりません。
Notice: JENNIFERサーバ/エージェント構築時に特別な制限事項がない場合、追加的な変更なしでデフォルト
値をそのまま使用します。
server_udp_runtime_port = 6901
server_udp_runtime_portオプションで設定したUDPポートを通じて全てのトランザクションの開
始と終了に関連するデータを送信します。
server_udp_listen_port = 6902
server_udp_listen_portオプションで設定したUDPポートを通じて1秒毎に反復的にサービス要求
率、平均応答時間などの性能データを送信します。
server_udp_lwst_call_stack_port = 6703
2秒毎に反復的にX-Viewトランザクションファイルデータを送信します。
TCP 通信オプション指定
agent_tcp_port = 7750
JENNIFERエージェントはJENNIFERサーバからリクエストされたリアルタイムデータの提供及
び構成変更のために固有なTCPポートを指定されます。1台のサーバで複数のエージェントを構成する
場合、ポートが固有に設定されるようにします。デフォルトポート番号は7750です。
4
JENNIFER4.0 インストールガイド
JENNIFER サーバ IP 指定
udp_server_host = localhost(JENNIFERサーバが運用されるIP記述)
JENNIFERサーバがJENNIFERエージェントと別途のサーバ(server)に構成されている場合、デー
タが伝達されるJENNIFERサーバのIPを指定します。
1.3.0.2. JENNIFERサーバとJENNIFERクライアント
管理コンソール接続ポート
JENNIFERクライアントはWeb基盤のユーザインターフェイスを提供します。JENNIFERクライア
ントは7900ポートを使用して接続します。
ポート変更が必要な場合、SARTUP_PORT環境変数値を他のポートに指定してからJENNIFER
サーバを起動します。(startup.sh, startup.bat)
UNIX
export STARTUP_PORT=7901
startup.sh
WINDOWS
set STARTUP_PORT=7901
startup.bat
アプレット通信ポート
server_tcp_port = 6701
JENNIFERダッシュボードのJavaアプレットはチャート構成に必要なデータをJENNIFERサーバ
からTCP通信を通じて獲得します。
1.3.0.3. ネットワーク構成に関する注意事項
ネットワーク構成に関する注意事項は次の通りです。
• 同じポートの重複使用防止 - 同じハードウェアに複数のJENNIFERエージェントをインストールし
た場合には、JENNIFERエージェントのagent_tcp_portオプションでインストールしたポート番号
が重複しないようにします。また同じハードウェアに複数のJENNIFERサーバをインストールした
場合には、JENNIFERサーバのserver_udp_runtime_port, server_udp_listen_port,
1. JENNIFER 概要
5
server_udp_lwst_call_stack_port, server_tcp_portなどのオプションで設定したポート番号が重複
しないようにします。
• ファイアウォールに対する点検 - JENNIFERを構成する主要モジュール間にファイアウォールがあ
る場合には、関連ポートが正常に開かれているか確認する必要があります。
6
JENNIFER4.0 インストールガイド
2
JENNIFERサーバインストール
この章ではJENNIFERサーバのインストールと構成方法について説明します。
2.1.
JENNIFERサーバスペック
モニタリング対象システムの規模及び収集するデータの量により異なりますが、一般的に平均
100TPS以下記のトランザクションをサービスするシステムでは次のようなスペックを必要とします。
表 2-1: JENNIFER サーバスペック
項目
推奨スペック
CPU
Pentium4以上(インテル基準)
Memory
2GB以上
ハードディスク
10GB以上 - システムメモリにより異なることがあります。
サポートOS
Windows, Linux, AIX, HP, Solaris
JAVA VERSION
1.5以上
サポートDB
Derby(基本)、Oracle, DB2
7
JENNIFERサーバはJAVAがインストールされている大半のシステムで運用が可能で、ハードディ
スク容量に関してはJENNIFERが構成されるシステム規模、データ収集程度により推奨スペックが異
なります。
2.2.
JENNIFERサーバインストール
2.2.1. UNIX用
JENNIFERサーバのインストールに伴うユーザの理解を深めるために、下記の表は JENNIFER
サーバインストールに必要なサーバの環境情報を表示しています。
本インストールガイドは下記の環境値を基準に説明します。そのため、実際の値はユーザサーバの
環境情報に合わせてインストール作業を行ってください。
表 2-2: JENNIFER サーバインストール例のためのシステム環境変数
環境変数
値
JENNIFERサーバホームディレクトリ
/home/jennifer/server
[JAVA_HOME]
/usr/java15
JENNIFERサーバIP Address
192.168.0.139
1. JENNIFERアカウントを新しく作成するとき、/home/jenniferホームディレクトリを確認して作
成します。
2. 作成されたディレクトリに圧縮ファイルを解凍します。
# gzip -d jennifer4.0.3.tar.gz
# tar -xvf jennifer4.0.3.tar
3. JAVA_HOME環境変数をインストールします。
# export JAVA_HOME=/usr/java5
4. /home/jennifer/server/binへ移動します。(cd /home/jennifer/server/bin)
8
JENNIFER4.0 インストールガイド
5. startup.shを実行後、ログを確認します。
Notice: JENNIFERサーバの最初の起動する時だけ、データベーステーブル生成作業が下記の通り進行されま
す。このためサーバのスペックにより時間が長くかかることがあります。
/home/jennifer/server/logsディレクトリのjennifer.log.yyyymmddファイルで下記のログを確認し
ます。
Checking database.....20081014/211023:S017:java.sql.SQLException: Schema
'JENNIFER' does not exist
Checking Adm database.....20081014/211024:S020:java.sql.SQLException: Schema
'JENNIFER' does not exist
20081014/211024:INF:
Creating new tables with:
20081014/211024:INF:The database URL is jdbc:derby:jennifer
20081014/211024:INF:Apache Derby Embedded JDBC Driver Version 10.4.1.3 - (648739)
20081014/211024:INF:Database: Apache Derby 10.4.1.3 - (648739)
20081014/211024:INF:Database table creating
.....
Notice: 2回目の起動時から下記の通りデータベースを確認後、JENNIFERを起動します。
Checking database.....20081014/220513:done
Checking Adm database.....20081014/220513:INF:done
20081014/220513:INF:XViewProfileManager ISAM index generated : 0
20081014/220513:INF:UdpRuntimeListener: udp listening on port 6901
20081014/220514:INF:UdpRuntimeWorkerPool started 10
20081014/220514:INF:UdpSummaryListener: udp listening on port 6902
20081014/220514:INF:XViewCProfileManager ISAM index generated : 0
20081014/220514:INF:UdpSummaryWorkerPool started : 10
20081014/220514:INF:UdpXViewProfileListener: udp listening on port 6703
20081014/220514:INF:DbWorkTxStatManager ISAM index generated : 0
20081014/220514:INF:UdpXViewProfileWorkerPool started 30
20081014/220515:INF:TcpSocketServer: listening port: 6701
20081014/220515:INF:Jennifer4.0.1(2008-10-13) started.
20081014/220515:INF:TcpServerWorkerPool started 80
6. ログイン
2. JENNIFER サーバインストール
9
Webブラウザのアドレス欄にJENNIFERサーバをインストールしたサーバのIP或いはドメインアド
レスとポート番号で構成されたURLを入力すると、ログイン画面が表示されます。JENNIFERの全て
の機能はログイン後に使用することが可能です。JENNIFER サーバのデフォルトポート番号は7900
です。
http://jennifer_server_ip:7900
ログインをするためにはIDとパスワードを入力して[Login]ボタンをクリックします。初期管理者ア
カウントのIDはadmin、パスワードもadminです。最初のログイン後にパスワードを変更することを
おすすめします。
JENNIFERクライアントの一部はFlashで実装されているためAdobeFlashプレイヤ9.0以上をイン
ストールする必要があります。
2.2.2. Windows
2.2.2.1. JENNIFERサーバインストール
JENNIFERサーバはTomcat5.5を基盤に運用されています。一般的なTomcatのように
JAHOM_HOME環境変数を指定後、JENNIFERサーバを起動させることが可能です。
表 2-1: JENNIFER サーバインストール例のためのシステム環境変数
環境変数
値
JEENIFERサーバホームディレクトリ
c:\jennifer\server
JAVA_HOME
C:\Java\jdk16u13
JENNIFERサーバ IP Address
192.168.0.139
1. ダウンロードしたJENNIFERパッケージングファイルを圧縮ユーティリティを使用して
JENNIFERインストールディレクトリ(例:c:\jennifer)に解凍します。
2. コマンドプロンプトを実行します。
3. Windowsシステム環境変数にJAVA_HOMEがインストールされているか確認します。
C:\Java>echo %JAVA_HOME%
C:\Java\jdk16u13
4. 環境変数がインストールされていない場合[マイコンピュータアイコンを右クリック｜プロパテイ
選択｜詳細タブ選択｜環境変数]にJAVA_HOME環境変数値を設定します。
10
JENNIFER4.0 インストールガイド
5. コマンドプロンプト上でJENNIFERサーバディレクトリ(例:c:\jennifer\server\bin)移動後、
startup.batを実行します。環境変数を新たに入力する場合、新しいコマンドプロンプトを生成し
てから進行します。エクスプローラ上で直接startup.batファイルをダブルクリックして実行する
ことも可能です。
JENNIFERサーバの最初の起動時のみデータベーステーブル生成作業が進行されます。サーバマシ
ンのスペックによりJENNIFERサーバの起動時間に差が生じることがあります。
6. ログイン
Webブラウザのアドレス欄にJENNIFERサーバをインストールしたサーバのIP或いはドメインアド
レスとポート番号で構成されたURLを入力するとログイン画面が表示されます。JENNIFERの全ての
機能はログイン後に使用することが可能です。JENNIFER サーバのデフォルト番号は7900です。
http://jennifer_server_ip:7900
ログインをするにはIDとパスワードを入力して[Login]ボタンをクリックします。初期管理者アカウ
ントのIDはadmin、パスワードもadminです。最初のログイン後パスワードを変更することをおすす
めします。
JENNIFERクライアントの一部はFlashで構成されているためAdobeFlashプレイヤ9.0以上をイン
ストールする必要があります。
クライアント設定
2.1.
JENNIFERクライアントはWebを基盤とします。その為、ユーザはWebブラウザを通じて
JENNIFERユーザインターフェイスにアクセスします。クライアントでのチャート表示のためにJava
プラグインが必要で、グリッド表示のためにFlashプレイヤが必要です。
OS
JENNIFERクライアントは、MS Windows XPとVistaをサポートします。但し、現在使用中の
Windowsテーマによりスタイルが正常に表示されないことがあります。現在Windows XPを使用して
いる場合、テーマでWindows固定を使用するとBLACK スタイルが正常に表示されません。現在使用
しているテーマはデスクトップ画面でマウスの右側をクリックすると表示されるコンテキストメ
ニューの[プロパティ ]メニューを選択すると確認することが可能です。
Notice: 公式的にはJENNIFERクライアントはLinuxとMac OSをサポートしていません。しかし、Firefox3.0
以上とJavaプラグイン1.6.0_10以上をインストール可能なOSであればJENNIFERを使用することが可能です。
Web ブラウザ
2. JENNIFER サーバインストール
11
MS IE7.0またはIE8.0及びMozilla Firefox3.0などのWebブラウザをサポートします。
Warning: IE6.0はCSSを含んだWeb標準サポートが不十分で透明なPNGイメージファイルを処理できないとい
う短所があります。その為、IE6.0はサポートしません。IE7.0かIE8.0にアップグレードできない環境では
Firefox3.0を使用することをおすすめします。
JENNIFERを使用するにはクッキーとJavaスクリプトを使用できるようにWebブラウザを設定する
必要があります。大半のWebブラウザはデフォルトでこの機能を使用できるように設定されています。
2.1.0.1. Javaプラグイン
JENNIFERクライアントの一部はJavaアプレットで構成されているためSUN Javaプラグイン
1.6.0_10以上をインストールする必要があります。
Warning: JENNIFER4.0からはMS Java VMをサポートしません。
インストールと削除
Javaプラグインのインストールと削除に対する内容はSUNのJavaサイト(http://java.sun.com/
javase/downloads/index.jsp)を参考にしてください。
メモリ設定
別途の設定がない場合、Javaアプレットが使用可能な最大Javaヒープメモリは96MBです。
JENNIFERクライアントを安定的に使用するためにはJavaヒープメモリ最大値を指定することをおす
すめします。特にエージェントの数が多い場合、スループットが多い場合にはJavaヒープメモリ最大
値を高く設定する必要があります。Windows OSでJavaプラグインのJavaヒープメモリサイズは次の
ように設定します。
1. コントロールパネルに移動します。
2. コントロールパネルでJavaをクリックしてJavaコントロールパネルを開きます。ここでJavaタブ
を選択します。
12
JENNIFER4.0 インストールガイド
図 2-1:
Javaコントロールパネル
3. Javaアプレットランタイム設定エリアの表示ボタンをクリックするとJavaランタイム設定画面が
表示されます。複数のJavaをインストールした場合には[有効]コラムを通じて使用するJavaを選択
します。
く
2. JENNIFER サーバインストール
13
図 2-2:
Javaランタイム設定
4. 例えば、Javaヒープメモリの最小値を100MB、最大値を150MBに設定するにはJREのJavaラン
タイムパラメータコラムに次のように入力します。
-Xms100m -Xmx150m
設定可能なJavaヒープメモリ最大値はマシンのスペックと環境に影響を受けます。設定可能な値よ
り大きい値を指定するとエラーが発生したり、Webブラウザが異常終了されることがあります。
設定可能なJavaヒープメモリ最大値についての明確な規定がないため、システムに合わせてJava
ヒープメモリ最大値を設定する必要があります。
Web ブラウザ設定 - Java アプレット
MS IE7.0またはIE8.0を使用する場合には[ツール｜インターネットオプション]メニューでJavaプラ
グイン有効区分を設定します。インターネットオプションで詳細設定タブを選択するとインストール
されたJavaプラグイン情報が表示されます。ここでSUN Javaプラグインを有効にするように設定し
ます。
14
JENNIFER4.0 インストールガイド
図 2-3:
IE Javaプラグイン設定
Mozilla Firefox3.0を使用する場合には[ツール｜インターネットオプション｜セキュリティ｜レベル
のカスタマイズ]メニューでアクティブスクリプト有効区分を確認します。
2. JENNIFER サーバインストール
15
図 2-4:
Firefox Javaプラグイン設定
Web ブラウザ設定 - Java スクリプト
MS IE7.0またはIE8.0を使用する場合には[ツール|インターネットオプション|セキュリティ |レベ
ルのカスタマイズ] メニューでスクリプト有効区分を設定します。デフォルトでは有効に設定されてい
ます。
16
JENNIFER4.0 インストールガイド
図 2-5:
IE Javaスクリプト設定
Mozilla Firefox3.0を使用する場合には[ツール|設定]メニューでJavaプラグイン有効区分を設定し
ます。設定画面でコンテンツタブを選択後、「Javaスクリプトを有効にする」を選択します。デフォル
トで選択されています。
2. JENNIFER サーバインストール
17
図 2-6:
Firefox Javaスクリプト設定
Flash プレイヤ
JENNIFERクライアントの一部はFlashで構成されています。正常な画面表示のためには
AdobeFlashプレイヤ9.0以上をインストールする必要があります。
18
JENNIFER4.0 インストールガイド
2.1.0.2. Windowsサービス登録
1. JENNIFERサーバをWindowsサービスに登録して管理する場合、service.batを使用します。
コマンドプロンプトを実行後JENNIFERサーバディレクトリ(c:\jennifer\server\bin)へ移動
例)
cd c:\jennifer\server\bin
service.bat install JenniferServer c:\jennifer\server\bin
C:\jennifer\server\bin>service install JenniferServer C:\Jennif
er\bin\jennifer4042\server\bin
Installing the service 'JenniferServer' ...
Using CATALINA_HOME:
C:\jennifer\server
Using CATALINA_BASE:
C:\jennifer\server
Using JAVA_HOME:
C:\Java\jdk16u13
Using JVM:
C:\Java\jdk16u13\jre\bin\server\jvm.dll
The service 'JenniferServer' has been installed.
Notice: 3番目のパラメータを[JENNIFER_SERVER_HOME]\binが選択されるようにします。
2. Windowsサービスに登録したら[コントロールパネル｜管理ツール｜サービス] メニューで
JENNIFERサーバを起動します。
2. JENNIFER サーバインストール
19
20
JENNIFER4.0 インストールガイド
3
インストールガイド（WebSphere用）
3.1.
UNIX 環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
3.1.1. WebSphere インストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをWebSphereが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明させています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行ってください。
表 3-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
WebSphere ホームディレクトリ
/was/WebSphere61/AppServer
21
表 3-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
JENNIFERエージェントディレクトリ
/home/jennifer/agent
Javaホームディレクトリ
/was/WebSphere61/AppServer/java
JENNIFERサーバIP Address
192.168.0.139
3.1.2. 事前インストール(Pre-Installation) 作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
WebSphere は“１”番を選択します。
########################################################
Step 1. Select Java Application Server
########################################################
Send me e-mail at [email protected], if you can't find Java Appication Server
you would like to install
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x
3. JEUS 4.x / 5.x
4. Oracle AS 10g
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin
8. Jboss 3
9. Jboss 4
10. Sun App Server
11. Glassfish
Select (Q:Quit)
22
===>> 1
JENNIFER4.0 インストールガイド
2. WebSphereのホームディレクトリを指定します。WebSphereの場合 jennifer.jarファイルをファイ
ルを特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパス
に設定する方法を提供します。
########################################################
Step 2. Type Java Application Server Home Directory
########################################################
This process is for configuring the jennifer.jar .
Type the exact path of directory for the selected
WebSphere Application Server.
Do you want to use the default Java Application Server HOME [ /usr/WebSphere/
AppServer ]? /was/WebSphere61/AppServer
WebSphere Application Server Home Directory : /was/WebSphere61/AppServer
Go admin console --> select Application server that you decided to install jennier
agent --> select process definition --> select java virtual machine --> specify the
path of jennifer.jar
3. WebSphereが使用するJAVA HOMEディレクトリを指定します。WebSphereが使用するJAVA
HOMEディレクトリの確認の上、lwst.jdk.jarファイルを生成する作業をします。一般的な場合は
WebSphereから提供する jdkを使用します。
########################################################
Step 3. Type JAVA Home Directory
########################################################
Specify the JAVA_HOME directory which is used by Java Application Server.
Do you want to use the default JAVA_HOME [/was/WebSphere61/AppServer/java] ?
[/was/WebSphere61/AppServer/java] is set as JAVA_HOME
Creating lwst.jdk.jar ....
lwst.jdk.jar is created successfully
3. インストールガイド（WebSphere 用）
23
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業を
します。WebSphereのJavaオプションに-d64オプションを使用する場合は“y”を入力し、Enter
を押します。使用しない場合はそのままEnterを押します。
########################################################
Step 4. Jennifer Native library setting
########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/was/WebSphere61/AppServer/bin/libjennifer20.so file is copied successfully
Notice: このステップではシステムに適合したJENNIFERネイティブライブラリ確認作業後、ネイティブライ
ブラリをローディング可能なディレクトリへコピーする作業を行います。全てのJENNIFERネイティブライブ
ラリが失敗した場合は、OSの種類及びバージョン、JDKの種類及びバージョンの情報を明記の上、
JENNIFERテクニカルサポートチーム([email protected])へEメールでご連絡ください。
24
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。エージェント名は必ず3文字にしてください。指定したエージェント名で設定ファ
イルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生成作業
を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
########################################################
Step 5. Jennifer Agent Configuration setting
########################################################
Do you want to customize an agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char]
ex) W11 ===>> W11
license_filename [ /home/jennifer/agent/license.txt ] ?
logfile [ /home/jennifer/agent/jennifer_W11.log ] ?
lwst_logfile [ /home/jennifer/agent/lwst_W11.log ] ?
agent_tcp_port [ 7750 ] ?
udp_server_host [ localhost ] ? 192.168.0.139
server_udp_runtime_port [ 6901 ] ?
server_udp_listen_port [ 6902 ] ?
server_udp_lwst_call_stack_port [ 6703 ] ?
The Agent configuration is completed...
Please, proceed with Post Installation tasks
表 3-2: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを指定し
ます。
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
3. インストールガイド（WebSphere 用）
25
6. 最後に設定された内容を確認します。
[Pre-Installation is finished]
[ Pre-Installation Summary ]
Java Application Server Type
: WebSphere Application Server
Java Application Server Home Directory
: /was/WebSphere61/AppServer
JDK Home Directory
: /was/WebSphere61/AppServer/java
Jennifer Agent Directory
: /home/jennifer/agent
Agent config file
: /home/jennifer/agent/W11.conf
Jennifer LWST file
: lwst.jdk.jar
Jennifer Native library file
libjennifer20.so(sl)
: /was/WebSphere61/AppServer/bin/
3.1.3. ポストインストール(Post-Installation) 作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェ
ント構成ファイルパスをWebSphere Javaオプションに設定する作業をします。
• WebSphere Javaオプション設定
1. WebSphereの「管理コンソール」で［サーバー｜アプリケーション・サーバ｜サーバー選択｜
サーバー・インフラストラクチャーのJavaおよびプロセス管理｜プロセス定義｜追加プロパ
ティーのJava仮想マシン］メニューを選択します。
2. 「一般プロパティー」の「Classpath」に「 jennifer.jar」ファイルのパスを入力します。
/home/jennifer/agent/jennifer.jar
3. 「一般プロパティー」の「Boot Classpath」に下記の値を入力します。
/home/jennifer/agent/lwst.jdk.jar
/home/jennifer/agent/lwst.boot.jar
4. 「追加プロパティー」の「カスタム・プロパティー」に下記の値を新規作成します。
-Djennifer.config=/home/jennifer/agent/W11.conf
26
JENNIFER4.0 インストールガイド
Warning: WebSphere が使っているJDKのバージョンが1.5以上の場合、-javaagent:/home/jennifer/agent/
lwst.javaagent.jar オプションを追加します。(WebSphere 6.1バージョンからJDK 1.5をサポートします。)
「一般プロパティー」の「汎用JVM引数」に次のように入力します。
例)-javaagent:/home/jennifer/agent/lwst.javaagent.jar
5. 該当のオプション値を保存します。
3.1.4. WebSphere の再起動及び確認事項
3.1.4.1. ライセンスキーの登録
WebSphereを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。ただ、WebSphereが開始するときに登録されるようにするにはエージェント設定ファイルで
agent_boot_classオプションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=W11
jennifer.config=/home/jennifer/agent/W11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omiitted ...
java.library.path=/was/WebSphere61/AppServer/java/jre/bin:/was/WebSphere61/
AppServer/java/jre/bin/j9vm:/was/WebSphere61/AppServer/java/jre/bin:/was/
WebSphere61/AppServer/bin
libjennifer20.so(sl) shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
2. ［構成管理 | ライセンスキー管理］メニューのライセンス入力フォームに発行されたライセンス
キーを登録します。
3. インストールガイド（WebSphere 用）
27
3.1.4.2. モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
3.1.5. JENNIFERエージェント構成削除
1. WebSphereの管理コンソールで [Application|サーバ選択|プロセス定義|JVM]メニューを選択し
ます。
2. 「Classpath」項目の「 jennifer.jar」設定値を削除します。
3. 「Boot Classpath」項目の「lwst.boot.jar, lwst.jdk.jar」設定値を削除します。
4. 一般JVMプロパティ項目の「 -Djennifer.config」関連設定値を削除します。
Notice: WebSphereが使用するJDKのバージョンが1.5以上の場合は一般JVMプロパティの「
-javaagent 」項目も削除します。
5. JENNIFERネイティブライブラリファイル(例の場合、/was/WebSphere61/AppServer/bin/
libjennifer20.so)を削除します。
6. WebSphereを再起動します。
3.2.
Windows 環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
3.2.1. WebSphere インストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
28
JENNIFER4.0 インストールガイド
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをWebSphereが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行ってください。
表 3-3: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
WebSphere ホームディレクトリ
c:\JavaApplicationServer\wbsphere60\appserver
JENNIFERエージェントディレクトリ
c:\jennifer\jenniferagent
Javaホームディレクトリ
c:\JavaApplicationServer\websphere60\appserver\java
JENNIFERサーバIP Address
192.168.0.139
3.2.2. 事前インストール(Pre-Installation) 作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
3. インストールガイド（WebSphere 用）
29
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
WebSphere は“１”番を選択します。
###################################################
######### Jennifer Agent Pre-Installation #########
###################################################
###################################################
Step 1. Select Java Application Server
###################################################
Send me e-mail at [email protected], if you can't find Java Application Serv
er you would like to install.
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x
3. JEUS 4.x / 5.x
4. OracleAS 10gR3
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin 2.x/3.0.x/3.1.x/ 4.0.x
8. Jboss 3.x
9. Jboss 4.x
10. Sun App Server 7.x/8.x/9.x
11. Glassfish 1.x/2.x
Select : 1
30
JENNIFER4.0 インストールガイド
2. WebSphereのホームディレクトリを指定します。WebSphereの場合 jennifer.jarファイルをファイ
ルを特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパス
に設定する方法を提供します。
####################################################
Step 2. Type Java Application Server Home Directory
#####################################################
"This process is for configuring jennifer.jar."
Example : c:\JavaApplicationServer\WebSphere60\AppServer\java
Type the exact path of directory for selected Java Application Server:
c:\JavaApplicationServer\websphere60\appserver
Java Application Server Home Directory :
c:\JavaApplicationServer\websphere60\appserver
"Java Application Server Home Directory Check Success"
3. WebSphereが使用するJAVA HOMEディレクトリを指定します。WebSphereが使用するJAVA
HOMEディレクトリの確認の上、lwst.jdk.jarファイルを生成する作業をします。一般的な場合は
WebSphereから提供する jdkを使用します。
#####################################################
Step 3. Type JAVA Home Directory
#####################################################
Input [JAVA_HOME] which is used for Java Application Server:
c:\JavaApplicationServer\websphere60\appserver\java
c:\JavaApplicationServer\websphere60\appserver\java is set as JAVA_HOME
"Creating lwst.jdk.jar..."
"LWST build success"
3. インストールガイド（WebSphere 用）
31
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを設定する必要があります。システムでのメモリが2GBを超える場合は“y”、2GB以下の場合は
“n”を選択します。
####################################################
Step 4. JENNIFER NATIVE LIBRARY SETTING
####################################################
Does your system have 2GB or more MEMORY? (Y/N) : n
jennifer20.dll has been copied to c:₩JavaApplicationServer₩websphere60₩appserver₩java₩bin
successfully.
32
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用するように
なります。生成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されませ
ん。この場合、JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせ
て修正後、使用することが可能です。
####################################################
Step 5 JENNIFER AGENT CONFIGURATION SETTING
####################################################
Do you want to customize agent configuration file ? (Y/N) : y
license_filename [ex: c:\jennifer\license.txt] :
c:\jennifer\jenniferagent\license.txt
agent_name - only 3 char [W11] : A11
logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log
lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :
c:\jennifer\jenniferagent\lwst_A11.log
agent_tcp_port [7750] :
udp_server_host [localhost] : 192.168.0.139
server_udp_runtime_port [6901] :
server_udp_listen_port [6902] :
server_udp_lwst_call_stack_port [6703] :
Will you have any option that you need to change? If "Don't", continue to make
configuration file.
(Y/N)n
"Creating A11.conf..."
Agent configuration is completed...
Please, proceed with Post - Installation tasks
[Pre-Installation is finished]
表 3-4: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
3. インストールガイド（WebSphere 用）
33
オプション
説明
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを指定し
ます。
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. 最後に設定された内容を確認します。
"Pre-Installation is finished"
[Pre-Installation Summary]
WAS TYPE : WebSphere5.x/6.x
WAS HOME DIRECTORY : c:\JavaApplicationServer\websphere60\appserver
JAVA HOME DIRECTORY : c:\JavaApplicationServer\websphere60\appserver\java
JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent
JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY :
C:\JavaApplicationServer\websphere60\appserver\java\bin\jennifer20.dll
3.2.3. ポストインストール(Post-Installation) 作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェ
ント構成ファイルパスをWebSphere Javaオプションに設定する作業をします。
• WebSphere Javaオプション設定
1. WebSphereの「管理コンソール」で［サーバー｜アプリケーション・サーバ｜サーバー選択｜
サーバー・インフラストラクチャーのJavaおよびプロセス管理｜プロセス定義｜追加プロパ
ティーのJava仮想マシン］メニューを選択します。
2. 「一般プロパティー」の「Classpath」に「 jennifer.jar」ファイルのパスを入力します。
c:\jennifer\jenniferagent\jennifer.jar
3. 「一般プロパティー」の「Boot Classpath」に下記の値を入力します。
c:\jennifer\jenniferagent\lwst.boot.jar
c:\jennifer\jenniferagent\lwst.jdk.jar
34
JENNIFER4.0 インストールガイド
4. 「追加プロパティー」の「カスタム・プロパティー」に下記の値を新規作成します。
-Djennifer.config=c:\jennifer\jenniferagent\A11.conf
-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar
Warning: WebSphereが使っているJDKのバージョンが1.4以下の場合、-javaagent:/home/jennifer/agent/
lwst.javaagent.jar を設定しない。「一般プロパティー」の「汎用JVM引数」に次のように設定します。
例)-javaagent:C:\jennifer\jenniferagent\lwst.javaagent.jar
5. 該当のオプション値を保存します。
3.2.4. WebSphere の再起動及び確認事項
3.2.4.1. ライセンスキーの登録
WebSphereを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。ただ、WebSphereが開始するときに登録されるようにするにはエージェント設定ファイルに
agent_boot_classオプションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=A11
jennifer.config=c:/jennifer/jenniferagent/A11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted ...
java.library.path=...
jennifer20.dll shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
3. インストールガイド（WebSphere 用）
35
2. ［構成管理 | ライセンスキー管理］メニューのライセンス入力フォームに発行されたライセンス
キーを登録します。
3.2.4.2. モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。.
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。.
3. ［障害診断 | ユーティリティ | ローディングクラスリスト］にローディングされたクラスなどが正
常に表示されるか確認します。
3.2.5. JENNIFERエージェント構成削除
1. WebSphereの管理コンソールで [Application|サーバ選択|プロセス定義|JVM]メニューを選択し
ます。
2. Classpath項目の「jennifer.jar」設定値を削除します。
3. Boot Classpath項目の「lwst.boot.jar, lwst.jdk.jar」設定値を削除します。
4. 一般JVMプロパティ項目の -Djennifer.config関連設定値を削除します。
5. JENNIFERネイティブライブラリファイル(例、
C:\JavaApplicationServer\websphere60\appserver\java\bin\jennifer20.dll)を削除します。
6. WebSphereを再起動します。
36
JENNIFER4.0 インストールガイド
4
インストールガイド（WebLogic用）
4.1.
UNIX 環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
4.1.1. WebLogic インストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをWebLogicが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明させています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行ってください。
表 4-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
WebLogic ホームディレクトリ
/was/bea/weblogic92
37
表 4-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
JENNIFERエージェントディレクト
/home/jennifer/agent
リ
Javaホームディレクトリ
/was/bea/jdk150_11
JENNIFERサーバIP Address
192.168.0.139
4.1.2. 事前インストール(Pre-Installation) 作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
WebLogic は“2”番を選択します。
########################################################
Step 1. Select Java Application Server
########################################################
Send me e-mail at [email protected], if you can't find Java Appication Server
you would like to install
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x
3. JEUS 4.x / 5.x
4. Oracle AS 10g
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin
8. Jboss 3
9. Jboss 4
10. Sun App Server
11. Glassfish
Select (Q:Quit)
38
===>> 2
JENNIFER4.0 インストールガイド
2. WebLogicのホームディレクトリを指定します。WebLogicの場合 jennifer.jarファイルをファイルを
特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパスに設
定する方法を提供します。
########################################################
Step 2. Type Java Application Server Home Directory
########################################################
This process is for configuring the jennifer.jar .
Type the exact path of directory for the selected
WebLogic Application Server.
Do you want to use the default Java Application Server HOME [ /usr/bea/weblogic ]?
/was/bea/weblogic92
WebLogic Application Server Home Directory : /was/bea/weblogic92
Add the /home/jennifer/agent/jennifer.jar classpath on the domain startup script
3. WebLogicが使用するJAVA HOMEディレクトリを指定します。WebLogicが使用するJAVA HOME
ディレクトリの確認の上、lwst.jdk.jarファイルを生成する作業をします。
########################################################
Step 3. Type JAVA Home Directory
########################################################
Specify the JAVA_HOME directory which is used by Java Application Server.
There is no default JAVA_HOME directory. Input the JAVA_HOME of the Java
Application Server. ===>> /was/bea/jdk150_11
[/was/bea/jdk150_11] is set as JAVA_HOME
Creating lwst.jdk.jar ....
lwst.jdk.jar is created successfully
4. インストールガイド（WebLogic 用）
39
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業を
します。WebLogicのJavaオプションに-d64オプションを使用する場合は“y”を入力し、Enterを
押します。使用しない場合はそのままEnterを押します。
########################################################
Step 4. Jennifer Native library setting
########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/was/bea/jdk150_11/jre/lib/i386/server/libjennifer20.so file is copied
successfully
Notice: このステップではシステムに適合したJENNIFERネイティブライブラリ確認作業後、ネイティブライ
ブラリをローディング可能なディレクトリへコピーする作業を行います。全てのJENNIFERネイティブライブ
ラリが失敗した場合は、OSの種類及びバージョン、JDKの種類及びバージョンの情報を明記の上、
JENNIFERテクニカルサポートチーム([email protected])へEメールでご連絡ください。
40
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生
成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
########################################################
Step 5. Jennifer Agent Configuration setting
########################################################
Do you want to customize an agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char]
ex) W11 ===>> W11
license_filename [ /home/jennifer/agent/license.txt ] ?
logfile [ /home/jennifer/agent/jennifer_W11.log ] ?
lwst_logfile [ /home/jennifer/agent/lwst_W11.log ] ?
agent_tcp_port [ 7750 ] ?
udp_server_host [ localhost ] ? 192.168.0.139
server_udp_runtime_port [ 6901 ] ?
server_udp_listen_port [ 6902 ] ?
server_udp_lwst_call_stack_port [ 6703 ] ?
The Agent configuration is completed...
Please, proceed with Post Installation tasks
表 4-2: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを指定し
ます。
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
4. インストールガイド（WebLogic 用）
41
6. 最後に設定された内容を確認します。
[Pre-Installation is finished]
[ Pre-Installation Summary ]
Java Application Server Type
: WebLogic Application Server
Java Application Server Home Directory
: /was/bea/weblogic92
JDK Home Directory
: /was/bea/jdk150_11
Jennifer Agent Directory
: /home/jennifer/agent
Agent config file
: /home/jennifer/agent/WL1.conf
Jennifer LWST file
: lwst.jdk.jar
Jennifer Native library file
server/libjennifer20.so(sl)
: /was/bea/jdk150_11/jre/lib/i386/
4.1.3. ポストインストール(Post-Installation) 作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェ
ント構成ファイルパスをWebLogic Javaオプションに設定する作業をします。
• WebLogic Javaオプション設定
1. WebLogicの環境設定ファイルは基本的には$DOMAIN_HOME/bin/startWebLogic.shファイルで
す。
2. WebLogicの環境設定ファイルの「CLASSPATH」の先頭に「 jennifer.jar」ファイルのパスを追加
します。
CLASSPATH=/home/jennifer/agent/jennifer.jar :"${CLASSPATH}${CLASSPATHSEP}
3. WebLogicの環境設定ファイルの「JAVA_OPTIONS」に下記の項目を追加します。
JAVA_OPTIONS="-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/
agent/lwst.boot.jar -Djennifer.config=/home/jennifer/agent/WL1.conf -javaagent:/
home/jennifer/agent/lwst.javaagent.jar"$JAVA_OPTIONS
Warning: jdk1.5バージョン以上の場合は、-javaagent:/home/jennifer/agent/lwst.javaagent.jar オプションを追
加しますが、jdk 1.4バージョン以下は該当のオプションを設定しません。.
4. 該当のオプション値を保存して、WebLogicを再起動します。
42
JENNIFER4.0 インストールガイド
4.1.4. インストールの確認
4.1.4.1. ライセンスキーの登録
WebLogicを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
--------------------------------------Jennifer4.0.5.0(2009-06-05) started.
agent_name=W11
jennifer.config=/home/jennifer/agent/W11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omiitted ...
java.library.path=/was/WebSphere61/AppServer/java/jre/bin:/was/WebSphere61/
AppServer/java/jre/bin/j9vm:/was/WebSphere61/AppServer/java/jre/bin:/was/
WebSphere61/AppServer/bin
libjennifer20.so(sl) shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
4.1.4.2. モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
4. インストールガイド（WebLogic 用）
43
4.1.5. JENNIFERエージェント構成削除
1. WebLogicを停止します。
2. WebLogicの$DOMAIN_HOME/bin/startWebLogic.shファイルでJENNIFERエージェント関連設
定値を削除します。
JAVA_OPTIONS="-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/
agent/lwst.boot.jar -Djennifer.config=/home/jennifer/agent/WL1.conf -javaagent:/
home/jennifer/agent/lwst.javaagent.jar"$JAVA_OPTIONS
CLASSPATH=/home/jennifer/agent/jennifer.jar :"${CLASSPATH}${CLASSPATHSEP}
3. JENNIFERネイティブライブラリファイルを削除します。
4. WebLogicを再起動します。
4.2.
Windows 環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
4.2.1. WebLogic インストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをWebLogicが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明させています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行ってください。
表 4-3: JENNIFER エージェント構成例（説明のための環境）
44
区分
ディレクトリ
WebLogic ホームディレクトリ
c:\JavaApplicationServer\weblogic
JENNIFERエージェントディレクトリ
c:\jennifer\jenniferagent
Javaホームディレクトリ
C:\Java\jdk16u13
JENNIFERサーバIP Address
192.168.0.139
JENNIFER4.0 インストールガイド
4.2.2. 事前インストール(Pre-Installation) 作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
WebLogic は“2”番を選択します。
###################################################
######### Jennifer Agent Pre-Installation #########
###################################################
###################################################
Step 1. Select Java Application Server
###################################################
Send me e-mail at [email protected], if you can't find Java Application Serv
er you would like to install.
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x
3. JEUS 4.x / 5.x
4. OracleAS 10gR3
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin 2.x/3.0.x/3.1.x/ 4.0.x
8. Jboss 3.x
9. Jboss 4.x
10. Sun App Server 7.x/8.x/9.x
11. Glassfish 1.x/2.x
Select : 2
4. インストールガイド（WebLogic 用）
45
2. WebLogicのホームディレクトリを指定します。WebLogicの場合 jennifer.jarファイルをファイルを
特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパスに設
定する方法を提供します。
###################################################
Step 2. Type Java Applicatiion Server Home Directory
###################################################
"This process is for configuring jennifer.jar."
Example : c:\bea\WebLogic
Type the exact path of directory for selected JAS :
c:\JavaApplicationServer\weblogic
Java Application Server Home Directory : c:\JavaApplicationServer\weblogic
"Add classpath $DIR_HOME/jennifer.jar in start script"
3. WebLogicが使用するJAVA HOMEディレクトリを指定します。WebLogicが使用するJAVA HOME
ディレクトリの確認の上、lwst.jdk.jarファイルを生成する作業をします。
###################################################
Step 3. Type JAVA Home Directory
###################################################
Input [JAVA_HOME] which is used for Java Application Server: C:\Java\jdk16u13
C:\Java\jdk16u13 is set as JAVA_HOME
"Creating lwst.jdk.jar..."
"LWST build success"
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを設定する必要があります。システムでのメモリが2GBを超過する場合は“y”、2GB以下の場合
は“n”を選択します。
###################################################
Step 4. JENNIFER NATIVE LIBRARY SETTING
###################################################
Does your system have 2GB or more MEMORY? (Y/N) : n
jennifer20.dll has been copied to C:\Java\jdk16u13\bin successfully.
46
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生
成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
###################################################
Step 5 JENNIFER AGENT CONFIGURATION SETTING
###################################################
Do you want to customize agent configuration file ? (Y/N) : y
license_filename [ex: c:\jennifer\license.txt] :
c:\jennifer\jenniferagent\license.txt
agent_name - only 3 char [W11] : A11
logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log
lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :
c:\jennifer\jenniferagent\lwst_A11.log
agent_tcp_port [7750] :
udp_server_host [localhost] : 192.168.0.139
server_udp_runtime_port [6901] :
server_udp_listen_port [6902] :
server_udp_lwst_call_stack_port [6703] :
Will you have any option that you need to change? If "Don't", continue to make
configuration file.
(Y/N)n
"Creating A11.conf..."
Agent configuration is completed...
Please, proceed with Post - Installation tasks
[Pre-Installation is finished]
表 4-4: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
4. インストールガイド（WebLogic 用）
47
オプション
説明
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを指
定します。
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. 最後に設定された内容を確認します。.
"Pre-Installation is finished"
[Pre-Installation Summary]
WAS TYPE : WebLogic 7.x/8.x/9.x/10.x
WAS HOME DIRECTORY : c:\JavaApplicationServer\weblogic
JAVA HOME DIRECTORY : C:\Java\jdk16u13
JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent
JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY :
C:\Java\jdk16u13\bin\jennifer20.dll
4.2.3. ポストインストール(Post-Installation) 作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェ
ント構成ファイルパスをWebLogic Javaオプションに設定する作業をします。
• WebLogic Javaオプション設定
1. WebLogicの環境設定ファイルは基本的には%WEBLOGIC_HOME%\bin\startWebLogic.cmd
ファイルです。
2. WebLogicの環境設定ファイルの「CLASSPATH」の先頭に「 jennifer.jar」ファイルのパスを追加
します。
CLASSPATH=c:\jennifer\jenniferagent\jennifer.jar;%JAVA_HOME%\lib\tools.jar%WL_HOME
%\server\lib\weblogic._sp.jar;%WL_HOME%\server\lib\weblogic.jar;%CLASSPATH%
48
JENNIFER4.0 インストールガイド
3. WebLogicの環境設定ファイルの「JAVA_OPTIONS」に下記の項目を追加します。
set JAVA_OPTIONS=-Xbootclasspath/
p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lwst.jdk.jar
-Djennifer.config=c:\jennifer\jenniferagent\A11.conf
-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar;%JAVA_OPTIONS%
Warning: jdk1.5バージョン以上の場合は、-javaagent:/home/jennifer/agent/lwst.javaagent.jar オプションを追
加しますが、jdk 1.4バージョン以下は該当のオプションを設定しません。.
4. 該当のオプション値を保存して、WebLogicを再起動します。
4.2.4. インストールの確認
4.2.4.1. ライセンスキーの登録
WebLogicを再起動してENNIFERエージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
--------------------------------------Jennifer4.0.5.0(2009-06-05) started.
agent_name=A11
jennifer.config=c:/jennifer/jenniferagent/A11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted...
java.library.path=...
jennifer20.dll shared library loaded successfully.
--------------------------------------Notice: 上記のような“jennifer20.dll shared library loaded successfully”というメッセージではない場合は、
インストールガイドのトラブルシューティングの部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
4. インストールガイド（WebLogic 用）
49
4.2.4.2. モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。.
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
4.2.5. JENNIFERエージェント構成削除
1. WebLogicを停止します。
2. WebLogicのスタートコマンドファイル（例、startWebLogic.cmd）に設定されたJENNIFERエー
ジェント関連設定値を削除します（jennifer.jar、lwst.boot.jar、lwst.jdk.jar、A11.conf、
lwst.javaaget.jar）。
3. JENNIFERネイティブライブラリファイル（例、C:\Java\jdk16u13\bin\jennifer20.dll）を削除
します。
4. WebLogicを再起動します。
50
JENNIFER4.0 インストールガイド
5
インストールガイド（Tomcat用）
5.1.
UNIX環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
5.1.1. Tomcatインストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをTomcatが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明します。実際の作業ではユーザのサーバ環境
情報に合わせてインストール作業を行ってください。
表 5-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
Tomcat5ホームディレクトリ
/was/tomcat5
51
表 5-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
JENNIFERエージェントディレクトリ
/home/jennifer/agent
Javaホームディレクトリ
/jdk/sun/java15
JENNIFERサーバIP Address
192.168.0.139
5.1.2. 事前インストール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Tomcat4.x / Tomcat5.xは“5”番を選択します。
Notice: Tomcat6の場合は“6”番を選択します。
52
JENNIFER4.0 インストールガイド
########################################################
########
Jennifer Agent Pre-Installation
########
########################################################
########################################################
Step 1. Select Java Application Server
########################################################
Send me e-mail at [email protected], if you can't find Java Appication Server
you would like to install
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x
3. JEUS 4.x / 5.x
4. Oracle AS 10g
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin
8. Jboss 3
9. Jboss 4
10. Sun App Server
11. Glassfish
Select (Q:Quit)
===>> 5
5. インストールガイド（Tomcat 用）
53
2. Tomcatのホームディレクトリを指定します。jennifer.jarファイルをTomcatホームディレクトリの
common/libディレクトリへコピーする作業が行われます。/was/tomcat5と入力してEnterを押し
ます。
########################################################
Step 2. Type Java Application Server Home Directory
########################################################
This process is for configuring the jennifer.jar .
Type the exact path of directory for the selected
Jakarta Tomcat.
Do you want to use the default ava Application Server HOME [ /usr/local/apache/
tomcat ]? /was/tomcat5
Tomcat Home Directory : /was/tomcat5
/was/tomcat5/common/lib/jennifer.jar is copied successful
Notice: Tomcat6の場合、/was/tomcat6/libディレクトリにjennifer.jarファイルがコピーされます。
3. Tomcatが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ
ルが生成されます。/jdk/sun/java15と入力してEnterを入力します。
########################################################
Step 3. Type JAVA Home Directory
########################################################
Specify the JAVA_HOME directory which is used by Java Application Server.
There is no default JAVA_HOME directory. Input the JAVA_HOME of the Java
Application Server. ===>> /jdk/sun/java15
[/jdk/sun/java15] is set as JAVA_HOME
Creating lwst.jdk.jar ....
lwst.jdk.jar is created successfully
54
JENNIFER4.0 インストールガイド
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業
をします。TomcatのJavaオプションに-d64オプションを使用する場合は“y”を入力し、Enterを
押します。使用しない場合はそのままEnterを押します。
########################################################
Step 4. Jennifer Native library setting
########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail
libjennifer20_linux_32_32.so test success
/jdk/sun/java15/jre/lib/i386/server/libjennifer20.so file is copied successfully
Notice: このステップではシステムに適合したJENNIFERネイティブライブラリ確認作業後、ネイティブライ
ブラリをローディング可能なディレクトリへコピーする作業を行います。全てのJENNIFERネイティブライブ
ラリが失敗した場合は、OSの種類及びバージョン、JDKの種類及びバージョンの情報を明記の上、
JENNIFERテクニカルサポートチーム([email protected])へEメールでご連絡ください。
5. インストールガイド（Tomcat 用）
55
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。エージェント名は必ず3文字にしてください。指定したエージェント名で設定ファ
イルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生成作業
を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
########################################################
Step 5. Jennifer Agent Configuration setting
########################################################
Do you want to customize an agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char]
ex) W11 ===>> T11
license_filename [ /home/jennifer/agent/license.txt ] ?
logfile [ /home/jennifer/agent/jennifer_T11.log ] ?
lwst_logfile [ /home/jennifer/agent/lwst_T11.log ] ?
agent_tcp_port [ 7750 ] ?
udp_server_host [ localhost ] ? 192.168.0.139
server_udp_runtime_port [ 6901 ] ?
server_udp_listen_port [ 6902 ] ?
server_udp_lwst_call_stack_port [ 6703 ] ?
The Agent configuration is completed...
Please, proceed with Post Installation tasks
表 5-2: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを
指定します。
56
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
JENNIFER4.0 インストールガイド
6. 最後に設定された内容を確認します。
[Pre-Installation is finished]
[ Pre-Installation Summary ]
Java Application Server Type
: Jakarta Tomcat
Java Application Server Home Directory
: /was/tomcat5
JDK Home Directory
: /jdk/sun/java15
Jennifer Agent Directory
: /home/jennifer/agent
Agent config file
: /home/jennifer/agent/T11.conf
Jennifer LWST file
: lwst.jdk.jar
Jennifer Native library file
server/libjennifer20.so(sl)
: /jdk/sun/java15/jre/lib/i386/
5.1.3. ポストインストール(Post-Installation)作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェ
ント構成ファイルパスをTomcat Javaオプションに設定する作業をします。
• Tomcat Javaオプション設定
1. Tomcatの設定ファイルは基本的には${TOMCAT_HOME}/bin/catalina.shです。例では/was/
tomcat5/bin/catalina.shファイルです。
2. Tomcatの設定ファイルJAVA_OPTS環境変数に下記のように事前作業を通じて作られたライブラ
リ及びエージェント構成ファイルの設定作業をします。JAVA_OPTSがない場合は追加で記述しま
す。
JAVA_OPTS="-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/
agent/lwst.boot.jar -javaagent:/home/jennifer/agent/lwst.javaagent.jar
-Djennifer.config=/home/jennifer/agent/T11.conf $JAVA_OPTS "
Warning: Tomcatが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを追
加しなければならず、jdk1.4未満は該当オプションを設定しません。
Notice: catalina.shファイルを修正する前にオリジナルをバックアップしておくことをおすすめします。
5. インストールガイド（Tomcat 用）
57
5.1.4. インストール確認作業
5.1.4.1. ライセンスキー登録
Tomcatを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Tomcatが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認し
ます。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=T11
jennifer.config=/home/jennifer/agent/T11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omiitted ...
sun.boot.library.path=/jdk/sun/java15/jre/lib/i386
java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/jre/lib/
i386:/jdk/sun/java15/jre/../lib/i386
libjennifer20.so(sl) shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
5.1.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
58
JENNIFER4.0 インストールガイド
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
5.1.5. JENNIFERエージェント構成削除
1. Tomcatを中止します。
2. /was/tomcat5/common/libディレクトリのjennifer.jarを削除します。
Notice: Tomcat6の場合、/was/tomcat6/libディレクトリのjennifer.jarを削除します。
3. Tomcat設定ファイルのcatalina.shでJENNIFERエージェント関連オプションを削除します。
4. JENNIFERネイティブライブラリファイル(例の場合/jdk/sun/java15/jre/lib/i386/server/
libjennifer20.so)を削除します。
5. Tomcatを再起動します。
5.2.
Windows環境
JENNIFERエージェントインストールは、事前インストール(pre-installation)、ポストインストー
ル(post-installation)そして、インストール確認作業で構成されています。
5.2.1. Tomcatインストール環境
下記の表はJENNIFERエージェントインストールについての理解を助けるためにJENNIFERエー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをTomcatが運用中のサーバの
ディレクトリにコピーします。
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザ
サーバの環境情報に合わせてインストール作業を行ってください。
表 5-3: JENNIFER エージェント構成例説明のための環境
区分
説明
Tomcatホームディレクトリ
c\JavaApplicationServer\tomcat4
JENNIFERエージェントホームディレクトリ
c:\jennifer\jenniferagent
Javaホームディレクトリ
C:\Java\jdk16u13
5. インストールガイド（Tomcat 用）
59
表 5-3: JENNIFER エージェント構成例説明のための環境
区分
説明
JENNIFER サーバIP Address
192.168.0.139
5.2.2. 事前インストール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Tomcat4.x / Tomcat 5.x は“5”番を選択します。
Notice: Tomcat6の場合、“6”番を選択します。
###################################################
######### Jennifer Agent Pre-Installation #########
###################################################
###################################################
Step 1. Select Java Application Server
###################################################
Send me e-mail at [email protected], if you can't find Java Application Serv
er you would like to install.
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x
3. JEUS 4.x / 5.x
4. OracleAS 10gR3
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin 2.x/3.0.x/3.1.x/ 4.0.x
8. Jboss 3.x
9. Jboss 4.x
10. Sun App Server 7.x/8.x/9.x
11. Glassfish 1.x/2.x
Select : 5
60
JENNIFER4.0 インストールガイド
2. Tomcatのホームディレクトリを指定します。jennifer.jarファイルをTomcatホームディレクトリの
common/libディレクトリにコピーする作業が行われます。c:\JavaApplicationServer\tomcat4と
入力してEnterを入力します。
###################################################
Step 2. Type Java Application Server Home Directory
###################################################
"This process is for configuring jennifer.jar."
Example : c:\JavaApplicationServer\tomcat4
Type the exact path of directory for selected Java Application Server:
c:\JavaApplicationServer\tomcat4
Java Application Server Home Directory : c:\JavaApplicationServer\tomcat4
"c:\JavaApplicationServer\tomcat4"\common\lib\jennifer.jar copy successful"
Notice: Tomcat6の場合、libディレクトリにjennifer.jarファイルがコピーされます。
3. Tomcatが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ
ルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。
###################################################
Step 3. Type JAVA Home Directory
###################################################
Input [JAVA_HOME] which is used for JAS : C:\Java\jdk16u13
C:\Java\jdk16u13 is set as JAVA_HOME
"Creating lwst.jdk.jar..."
"LWST build success"
5. インストールガイド（Tomcat 用）
61
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
Step 4. JENNIFER NATIVE LIBRARY SETTING
###################################################
Does your system have 2GB or more MEMORY? (Y/N) : n
jennifer20.dll has been copied to C:\Java\jdk16u13\bin successfully.
62
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。エージェント名は必ず3文字にしてください。指定したエージェント名で設定ファ
イルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生成作業
を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
###################################################
Step 5. JENNIFER AGENT CONFIGURATION SETTING
###################################################
Do you want to customize agent configuration file ? (Y/N) : y
license_filename [ex: c:\jennifer\license.txt] :
c:\jennifer\jenniferagent\license.txt
agent_name - only 3 char [W11] : A11
logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log
lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :
c:\jennifer\jenniferagent\lwst_A11.log
agent_tcp_port [7750] :
udp_server_host [localhost] : 192.168.0.139
server_udp_runtime_port [6901] :
server_udp_listen_port [6902] :
server_udp_lwst_call_stack_port [6703] :
Will you have any option that you need to change? If "Don't", continue to make
configuration file.
(Y/N)n
"Creating A11.conf..."
Agent configuration is completed...
Please, proceed with Post - Installation tasks
[Pre-Installation is finished]
表 5-4: オプション紹介
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
5. インストールガイド（Tomcat 用）
63
オプション
説明
license_filename
ライセンスキーを保存するライセンスファイルパスを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. 最後に設定された情報を確認します。
"Pre-Installation is finished"
[Pre-Installation Summary]
WAS TYPE : TOMCAT 4.X/5.5.x
WAS HOME DIRECTORY : c:\JavaApplicationServer\tomca4
JAVA HOME DIRECTORY : C:\Java\jdk16u13
JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent
JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY :
C:\Java\jdk16u13\bin\jennifer20.dll
5.2.3. ポストインストール(Post-Installation)作業
ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェン
ト構成ファイルパスをTomcat Javaオプションに設定する作業をします。
1. Tomcatの設定ファイルは基本的には、%TOMCAT_HOME%\bin\catalina.batです。例では
c:\JavaApplicationServer\tomcat4\bin\catalina.batです。
2. Tomcatの設定ファイルJAVA_OPTS環境変数に下記のように事前作業を通じて作られたライブラ
リ及びエージェント構成ファイルの設定作業をします。JAVA_OPTSがない場合、追加で記述しま
す。
set JAVA_OPTS=-Xbootclasspath/
p:c:\jennifer\jenniferagent\lwst.jdk.jar;c:\jennifer\jenniferagent\lwst.boot.jar
-Djennifer.config=c:\jennifer\jenniferagent\A11.conf
-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar
Warning: Tomcatが使用するJDKバージョンが1.4以下記の場合、
-javaagent:C:\jennifer\jenniferagent\lwst.javaagent.jarを使用しません。
Notice: catalina.shファイルを修正する前にオリジナルをバックアップしておくことをおすすめします。
64
JENNIFER4.0 インストールガイド
5.2.4. インストール確認作業
5.2.4.1. ライセンスキー登録
Tomcatを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Tomcatが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認
します。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=A11
jennifer.config=c:/jennifer/jenniferagent/A11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted ...
java.library.path=
jennifer20.dll shared library loaded successfully.
--------------------------------------Notice: 上記のような“jennifer20.dll shared library loaded successfully.”というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
5.2.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
5. インストールガイド（Tomcat 用）
65
5.2.5. JENNIFERエージェント構成削除
1. Tomcatを中止します。
2. Tomcat環境設定ファイルの%TOMCAT_HOME%\bin\catalina.bat
(c:\JavaApplicationServer\tomcat4\bin\catalina.bat)で JENNIFERエージェント設定オプショ
ンを削除します。( lwst.boot.jar、lwst.jdk.jar、A11.conf、lwst.javaaget.jar)
3. %TOMCAT_HOME%\common\lib(c:\JavaApplicationServer\tomcat4\common\lib)ディレク
トリのjennifer.jarを削除します。
Notice: Tomcat6は%TOMCAT_HOME%\lib\jennifer.jarを削除します。
4. JENNIFERネイティブライブラリを削除します。(%JAVA_HOME%\bin\jennifer20.dll C:\Java\jdk16u13\bin\jennifer20.dll)
5. Tomcatを再起動します。
66
JENNIFER4.0 インストールガイド
6
インストールガイド（Resin用）
6.1.
UNIX環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
6.1.1. Resinインストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをResinが運用中であるサー
バのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明させています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行ってください。
表 6-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
Resinホームディレクトリ
/was/resin315
67
表 6-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
JENNIFERエージェントディレクトリ
/home/jennifer/agent
Javaホームディレクトリ
/jdk/sun/java15
JENNIFERサーバIP Address
192.168.0.139
6.1.2. 事前インストール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Resinは“7”番を選択します。
########################################################
########
Jennifer Agent Pre-Installation
########
########################################################
########################################################
Step 1. Select Java Application Server
########################################################
Send me e-mail at [email protected], if you can't find Java Appication Server
you would like to install
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x
3. JEUS 4.x / 5.x
4. Oracle AS 10g
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin
8. Jboss 3
9. Jboss 4
10. Sun App Server
11. Glassfish
Select (Q:Quit)
68
===>> 7
JENNIFER4.0 インストールガイド
2. Resinのホームディレクトリを指定します。jennifer.jarファイルをResinホームディレクトリの/lib
ディレクトリへコピーする作業が行われます。/was/resin315と入力してEnterを押します。
########################################################
Step 2. Type Java Application Server Home Directory
########################################################
This process is for configuring the jennifer.jar .
Type the exact path of directory for the selected
Resin.
Do you want to use the default Java Application Server HOME [ /usr/local/resin ]?
/was/resin315
Resin Home Directory : /was/resin315
/was/resin315/lib/jennifer.jar is copid successfully
3. Resinが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイル
が生成されます。/jdk/sun/java15と入力してEnterを入力します。
########################################################
Step 3. Type JAVA Home Directory
########################################################
Specify the JAVA_HOME directory which is used by Java Application Server.
There is no default JAVA_HOME directory. Input the JAVA_HOME of the Java
Application Server. ===>> /jdk/sun/java15
[/jdk/sun/java15] is set as JAVA_HOME
Creating lwst.jdk.jar ....
lwst.jdk.jar is created successfully
6. インストールガイド（Resin 用）
69
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業
をします。TomcatのJavaオプションに-d64オプションを使用する場合は“y”を入力してEnterを
押します。使用しない場合はそのままEnterを押します。
########################################################
Step 4. Jennifer Native library setting
########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/jdk/sun/java15/jre/lib/i386/server/libjennifer20.so file is copied successfully
Notice: このステップではシステムに適合したJENNIFERネイティブライブラリ確認作業後、ネイティブライ
ブラリをローディング可能なディレクトリへコピーする作業を行います。全てのJENNIFERネイティブライブ
ラリが失敗した場合は、OSの種類及びバージョン、JDKの種類及びバージョンの情報を明記の上、
JENNIFERテクニカルサポートチーム([email protected])へEメールでご連絡ください。
70
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生
成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
########################################################
Step 5. Jennifer Agent Configuration setting
########################################################
Do you want to customize an agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char]
ex) W11 ===>> W13
license_filename [ /home/jennifer/agent/license.txt ] ?
logfile [ /home/jennifer/agent/jennifer_W13.log ] ?
lwst_logfile [ /home/jennifer/agent/lwst_W13.log ] ?
agent_tcp_port [ 7750 ] ?
udp_server_host [ localhost ] ? 192.168.0.139
server_udp_runtime_port [ 6901 ] ?
server_udp_listen_port [ 6902 ] ?
server_udp_lwst_call_stack_port [ 6703 ] ?
The Agent configuration is completed...
Please, proceed with Post Installation tasks
表 6-2: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを
指定します。
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. インストールガイド（Resin 用）
71
6. 最後に設定された内容を確認します。
[ Pre-Installation Summary ]
Java Application Server Type
: Resin
Java Application Server Home Directory
: /was/resin315
JDK Home Directory
: /jdk/sun/java15
Jennifer Agent Directory
: /home/jennifer/agent
Agent config file
: /home/jennifer/agent/W13.conf
Jennifer LWST file
: lwst.jdk.jar
Jennifer Native library file
server/libjennifer20.so(sl)
: /jdk/sun/java15/jre/lib/i386/
6.1.3. ポストインストール(Post-Installation)作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェ
ント構成ファイルパスをResinのJavaオプションに設定する作業をします。
6.1.3.1. Resin 3.1.xのJavaオプション設定
1. Resinの設定ファイルは基本的には${RESIN_HOME}/conf/resin.confです。例では/was/resin315/
conf/resin.confファイルです。
2. Resinの設定ファイルに下記のように事前作業を通じて作られたライブラリ及びエージェント構成
ファイルの設定作業をします。
<jvm-arg>-Xbootclasspat/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/
lwst.boot.jar</jvm-arg>
<jvm-arg>-javaagent:/home/jennifer/agnet/lwst.javaagent.jar</jvm-arg>
<jvm-arg>-Djennifer.config=/home/jennifer/agent/W13.conf</jvm-arg>
Warning: Resinが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを追加
しなければならず、jdk1.4未満は該当オプションを設定しません。
6.1.3.2. Resin 2.x/3.0.xのJavaオプション設定
1. 該当バージョンは${RESIN_HOME}/bin/httpd.shファイルに設定を追加します。
72
JENNIFER4.0 インストールガイド
2. 実行スクリプトに下記のように事前作業を通じて作られたライブラリ及びエージェント構成ファ
イルの設定作業をします。
-Xbootclasspat/p:/home/jennifer/agent/lwst.jdk.jar:home/jennifer/agent/
lwst.boot.jar -Djennifer.config=/home/jennifer/agent/W13.conf -javaagent:/home/
jennifer/agent/lwst.javaagent.jar
Warning: Resinが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを追加
しなければならず、jdk1.4未満は該当オプションを設定しません。
6.1.4. インストール確認作業
6.1.4.1. ライセンスキー登録
Resinを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Resinが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプショ
ンを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることえを確認
します。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=W13
jennifer.config=/home/jennifer/agent/W13.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
Omiitted
sun.boot.library.path=/jdk/sun/java15/jre/lib/i386
java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/jre/lib/
i386:/jdk/sun/java15/jre/../lib/i386
libjennifer20.so(sl) shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
6. インストールガイド（Resin 用）
73
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
6.1.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
6.1.5. JENNIFERエージェント構成削除
1. Resinを中止します。
2. ${RESIN_HOME}/libディレクトリのjennifer.jarを削除します。
3. ${RESIN_HOME}/conf/resin.confファイルでJENNIFERエージェント関連オプションを削除しま
す。
Notice: Resin 2.1.x、3.0.xの場合は、起動スクリプトに設定したJENNIFERエージェント関連オプションを削
除します。
4. JENNIFERネイティブライブラリファイル(${JAVA_HOME}/jre/lib/i386/server/libjennifer20.so(sl))
を削除します。
5. Resinを再起動します。
6.2.
Windows環境
JENNIFERエージェントインストールは、事前インストール(pre-installation)、ポストインストー
ル(post-installation)そして、インストール確認作業で構成されています。
6.2.1. Resinインストール環境
下記の表はJENNIFERエージェントインストールについての理解を助けるためにJENNIFERエー
ジェントがインストールされたサーバの環境情報を表示します。
74
JENNIFER4.0 インストールガイド
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをResinが運用中のサーバの
ディレクトリにコピーします。
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザ
サーバの環境情報に合わせてインストール作業を行ってください。
表 6-3: JENNIFER エージェント構成例説明のための環境
区分
説明
Resinホームディレクトリ
c\JavaApplicationServer\resin3
JENNIFERエージェントホームディレクトリ
c:\jennifer\jenniferagent
Javaホームディレクトリ
c:\Java\jdk16u13
JENNIFER サーバIP Address
192.168.0.139
6.2.2. 事前インストール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
6. インストールガイド（Resin 用）
75
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Resinは“7”番を選択します。
###################################################
######### Jennifer Agent Pre-Installation #########
###################################################
###################################################
Step 1. Select Java Application Server
###################################################
Send me e-mail at [email protected], if you can't find Java Application Serv
er you would like to install.
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x
3. JEUS 4.x / 5.x
4. OracleAS 10gR3
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin 2.x/3.0.x/3.1.x/ 4.0.x
8. Jboss 3.x
9. Jboss 4.x
10. Sun App Server 7.x/8.x/9.x
11. Glassfish 1.x/2.x
Select : 7
76
JENNIFER4.0 インストールガイド
2. Resinのホームディレクトリを指定します。jennifer.jarファイルをResinホームディレクトリの
\libディレクトリにコピーする作業が行われます。c:\JavaApplicationServer\resin3と入力して
Enterを入力します。
###################################################
Step 2. Type Java Application Server Home Directory
###################################################
"This process is for configuring jennifer.jar."
Example : c:\JavaApplicationServer\resin3
Type the exact path of directory for selected Java Application Server:
c:\JavaApplicationServer\resin3
Java Application Server Home Directory : c:\JavaApplicationServer\resin3
"c:\JavaApplicationServer\resin3"\lib\jennifer.jar copy successful"
3. Resinが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイル
が生成されます。c:\Java\jdk16u13と入力してEnterを入力します。
###################################################
Step 3. Type JAVA Home Directory
###################################################
Input [JAVA_HOME] which is used for Java Application Server : C:\Java\jdk16u13
C:\Java\jdk16u13 is set as JAVA_HOME
"Creating lwst.jdk.jar..."
"LWST build success"
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
Step 4. JENNIFER NATIVE LIBRARY SETTING
###################################################
Does your system have 2GB or more MEMORY? (Y/N) : n
jennifer20.dll has been copied to C:\Java\jdk16u13\bin successfully.
6. インストールガイド（Resin 用）
77
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字でなければなりません。指定したエージェント
名で設定ファイルが生成されます。値を記入せずにEnterを入力した場合、デフォルト値が使用さ
れます。生成作業を望まない場合(‘n’を選択した場合)は新しい設定ファイルは生成されません。
この場合、JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正
したあとで使用することが可能です。
###################################################
Step 5 JENNIFER AGENT CONFIGURATION SETTING
###################################################
Do you want to customize agent configuration file ? (Y/N) : y
license_filename [ex: c:\jennifer\license.txt] :
c:\jennifer\jenniferagent\license.txt
agent_name - only 3 char [W11] : A11
logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log
lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :
c:\jennifer\jenniferagent\lwst_A11.log
agent_tcp_port [7750] :
udp_server_host [localhost] : 192.168.0.139
server_udp_runtime_port [6901] :
server_udp_listen_port [6902] :
server_udp_lwst_call_stack_port [6703] :
Will you have any option that you need to change? If "Don't", continue to make
configuration file.
(Y/N)n
"Creating A11.conf..."
Agent configuration is completed...
Please, proceed with Post - Installation tasks
[Pre-Installation is finished]
表 6-4: オプション紹介
78
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
JENNIFER4.0 インストールガイド
オプション
説明
license_filename
ライセンスキーを保存するライセンスファイルパスを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. 最後に設定された情報を確認します。
"Pre-Installation is finished"
[Pre-Installation Summary]
WAS TYPE : Resin 2.x/3.0.x/3.1.x/ 4.0.x
WAS HOME DIRECTORY : c:\JavaApplicationServer\resin3
JAVA HOME DIRECTORY : C:\Java\jdk16u13
JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent
JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY :
C:\Java\jdk16u13\bin\jennifer20.dll
6.2.3. ポストインストール(Post-Installation)作業
ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェン
ト構成ファイルパスをResinのJavaオプションに設定する作業をします。
6.2.3.1. Resin 4.xのJavaオプション設定
Resin 4.xの設定ファイルは基本的に%RESIN_HOME%\conf\resin.xmlファイルです。
Resinの設定ファイルの<jvm-arg>タグに下記のようにJENNIFERエージェントの構成設定を記述し
ます。
<jvm-arg>-Xbootclasspath/
p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lwst.jdk.jar</
jvm-arg>
<jvm-arg>-Djennifer.config=c:\jennifer\jenniferagent\A11.conf</jvm-arg>
<jvm-arg>.-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar</jvm-arg>
Warning: Resinが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを追加
しなければならず、jdk1.4未満は該当オプションを設定しません。
6. インストールガイド（Resin 用）
79
6.2.3.2. Resin 3.1.xのJavaオプション設定
1. Resinの設定ファイルは基本的には${RESIN_HOME}\conf\resin.confです。例では
C:\JavaApplicationServer\resin3\conf\resin.confファイルです。
2. Resinの設定ファイルに下記のように事前作業を通じて作られたライブラリ及びエージェント構成
ファイルの設定作業をします。
<jvm-arg>-Xbootclasspath/
p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lwst.jdk.jar</
jvm-arg>
<jvm-arg>-Djennifer.config=c:\jennifer\jenniferagent\A11.conf</jvm-arg>
<jvm-arg>.-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar</jvm-arg>
Warning: Resinが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを追加
しなければならず、jdk1.4未満は該当オプションを設定しません。
6.2.3.3. Resin 2.x/3.0.xのJavaオプション設定
1. Resinの起動コマンドに「-J」オプションに付けてJENNIFERエージェントの構成設定を入力して
Resinを起動します。
2. Resinの起動コマンドは基本的に%RESIN_HOME%\httpd.exeです。
httpd -J-Xbootclasspath/
p:C:\jennifer\jenniferagent\lwst.boot.jar;C:\jennifer\jenniferagent\lwst.jdk.jar
-Djennifer.config=C:\jennifer\jenniferagent\w11.conf
Warning: Resinが使用するJDKが1.5以上の場合、-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jarを
追加しなければならず、jdk1.4未満は該当オプションを設定しません。
6.2.4. インストール確認作業
6.2.4.1. ライセンスキー登録
Resinを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Resinが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプショ
ンを活性化させます。
80
JENNIFER4.0 インストールガイド
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認
します。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=A11
jennifer.config=c:/jennifer/jenniferagent/A11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted...
java.library.path=
jennifer20.dll shared library loaded successfully.
--------------------------------------Notice: 上記のような“jennifer20.dll shared library loaded successfully.”というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
6.2.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
6.2.5. JENNIFERエージェント構成削除
1. Resinを中止します。
2. %RESIN_HOME%\lib(C:\JavaApplicationServer\resin3\lib)ディレクトリからjennifer.jarファ
イルを削除します。
6. インストールガイド（Resin 用）
81
3. %RESIN_HOME%\confディレクトリ(C:\JavaApplicationServer\resin3\conf)の
resin.conf(resin.xml)ファイルでJENNIFERエージェントの設定をを削除します。
Notice: Resin 2.x/3.0.xの場合は、起動コマンドの実行時の追加オプションを削除します。
4. JENNIFERネイティブライブラリを削除します。(%JAVA_HOME%\bin\jennifer20.dll)
5. Resinを再起動します。
82
JENNIFER4.0 インストールガイド
6. インストールガイド（Resin 用）
83
84
JENNIFER4.0 インストールガイド
7
インストールガイド（JBoss用）
7.1.
UNIX環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
7.1.1. JBossインストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをJBossが運用中であるサー
バのディレクトリへコピーします。
85
本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行う必要があります。
表 7-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
JBossホームディレクトリ
/was/jboss3
/was/jboss4
JENNIFERエージェントディレクトリ
/home/jennifer/agent
Javaホームディレクトリ
/jdk/sun/java15
JENNIFERサーバIP Address
192.168.0.139
7.1.2. 事前インストール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
JBoss3.xは“8”番を選択します。
Notice: JBoss4.xの場合は、”9”番を選択します。
86
JENNIFER4.0 インストールガイド
########################################################
########
Jennifer Agent Pre-Installation
########
########################################################
########################################################
Step 1. Select Java Application Server
########################################################
Send me e-mail at [email protected], if you can't find Java Appication Server
you would like to install
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x
3. JEUS 4.x / 5.x
4. Oracle AS 10g
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin
8. Jboss 3
9. Jboss 4
10. Sun App Server
11. Glassfish
Select (Q:Quit)
===>> 8
7. インストールガイド（JBoss 用）
87
2. JBossのホームディレクトリを指定します。jennifer.jarファイルをJBossホームディレクトリの/
server/default/deploy/jbossweb-tomcat50.sarディレクトリへコピーする作業が行われます。/was/
jboss3と入力してEnterを入力します。
########################################################
Step 2. Type Java Application Server Home Directory
########################################################
This process is for configuring the jennifer.jar .
Type the exact path of directory for the selected
JBoss.
Do you want to use the default Java Application Server HOME [ /usr/local/jboss ]?
/was/jboss3
JBoss Home Directory : /was/jboss3
/was/jboss3/server/default/deploy/jbossweb-tomcat50.sar/jennifer.jar is copid
successfully
Notice: JBoss4.xの場合は、/was/jboss4/server/defalut/libディレクトリにコピーします。
3. JBossが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイル
が生成されます。/jdk/sun/java15と入力してEnterを入力します。
########################################################
Step 3. Type JAVA Home Directory
########################################################
Specify the JAVA_HOME directory which is used by Java Application Server.
There is no default JAVA_HOME directory. Input the JAVA_HOME of the Java
Application Server. ===>> /jdk/sun/java15
[/jdk/sun/java15] is set as JAVA_HOME
Creating lwst.jdk.jar ....
lwst.jdk.jar is created successfully
88
JENNIFER4.0 インストールガイド
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業
をします。JBossのJavaオプションに-d64オプションを使用する場合は“y”を入力してEnterを
押します。使用しない場合はそのままEnterを押します。
########################################################
Step 4. Jennifer Native library setting
########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/jdk/sun/java15/jre/lib/i386/server/libjennifer20.so file is copied successfully
Notice: このステップではシステムに適合したJENNIFERネイティブライブラリ確認作業後、ネイティブライ
ブラリをローディング可能なディレクトリへコピーする作業を行います。全てのJENNIFERネイティブライブ
ラリが失敗した場合は、OSの種類及びバージョン、JDKの種類及びバージョンの情報を明記の上、
JENNIFERテクニカルサポートチーム([email protected])へEメールでご連絡ください。
7. インストールガイド（JBoss 用）
89
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用するように
なります。生成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されませ
ん。この場合、JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせ
て修正後、使用することが可能です。
########################################################
Step 5. Jennifer Agent Configuration setting
########################################################
Do you want to customize an agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char]
ex) W11 ===>> JB3
license_filename [ /home/jennifer/agent/license.txt ] ?
logfile [ /home/jennifer/agent/jennifer_JB3.log ] ?
lwst_logfile [ /home/jennifer/agent/lwst_JB3.log ] ?
agent_tcp_port [ 7750 ] ?
udp_server_host [ localhost ] ? 192.168.0.139
server_udp_runtime_port [ 6901 ] ?
server_udp_listen_port [ 6902 ] ?
server_udp_lwst_call_stack_port [ 6703 ] ?
The Agent configuration is completed...
Please, proceed with Post Installation tasks
表 7-2: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを
指定します。
90
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
JENNIFER4.0 インストールガイド
6. 最後に設定された内容を確認します。
[ Pre-Installation Summary ]
Java Application Server Type
: JBoss
Java Application Server Home Directory
: /was/jboss3
JDK Home Directory
: /jdk/sun/java15
Jennifer Agent Directory
: /home/jennifer/agent
Agent config file
: /home/jennifer/agent/JB3.conf
Jennifer LWST file
: lwst.jdk.jar
Jennifer Native library file
server/libjennifer20.so(sl)
: /jdk/sun/java15/jre/lib/i386/
7.1.3. ポストインストール(Post-Installation)作業
ポストインストール作業では、事前インストール作業を通じて作成されたライブラリ及びエージェ
ント構成ファイルパスをJBossのJavaオプションに設定する作業をします。
• JBossのJavaオプション設定
1. JBossの設定ファイルは基本的には${JBOSS_HOME}/bin/run.shです。例では/was/jboss3/bin/
run.shファイルです。
2. JBossの設定ファイルのJAVA_OPTSオプションに下記のように事前作業を通じて作られたライブ
ラリ及びエージェント構成ファイルの設定作業をします。
JAVA_OPTS="-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/
agent/lwst.boot.jar -Djennifer.config=/home/jennifer/agent/JB3.conf -javaagent:/
home/jennifer/agent/lwst.javaagent.jar"
Warning: JBossが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを追加
しなければならず、jdk1.4未満は該当オプションを設定しません。
7. インストールガイド（JBoss 用）
91
7.1.4. インストール確認作業
7.1.4.1. ライセンスキー登録
JBossを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。JBossが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認し
ます。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=JB3
jennifer.config=/home/jennifer/agent/JB3.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
Omitted
sun.boot.library.path=/jdk/sun/java15/jre/lib/i386
java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/jre/lib/
i386:/jdk/sun/java15/jre/../lib/i386
libjennifer20.so(sl) shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
7.1.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
92
JENNIFER4.0 インストールガイド
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
7.1.5. JENNIFERエージェント構成削除
1. JBossを中止します。
2. ${JBOSS_HOME}/server/default/deploy/jbossweb-tomcat50.sarディレクトリのjennifer.jarを削
除します。
Notice: JBoss4.xの場合は、${JBOSS_HOME}/server/default/libディレクトリのjennifer.jarファイルを削除し
ます。
3. ${JBOSS_HOME}/bin/run.shファイルでJENNIFERエージェント関連オプションを削除します。
4. JENNIFERネイティブライブラリファイル(/jdk/sun/java15/jre/lib/i386/server/libjennifer20.so(sl))を削
除します。
5. JBossを再起動します。
7.2.
Windows環境
JENNIFERエージェントインストールは、事前インストール(pre-installation)、ポストインストー
ル(post-installation)そして、インストール確認作業で構成されています。
7.2.1. JBossインストール環境
下記の表はJENNIFERエージェントインストールについての理解を助けるためにJENNIFERエー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをJBossが運用中のサーバの
ディレクトリにコピーします。
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザ
サーバの環境情報に合わせてインストール作業を行う必要があります。
表 7-3: JENNIFER エージェント構成例説明のための環境
区分
説明
JBossホームディレクトリ
c\JavaApplicationServer\jboss3
JENNIFERエージェントホームディレクトリ
c:\jennifer\jenniferagent
7. インストールガイド（JBoss 用）
93
表 7-3: JENNIFER エージェント構成例説明のための環境
区分
説明
Javaホームディレクトリ
c:\Java\jdk16u13
JENNIFER サーバIP Address
192.168.0.139
7.2.2. 事前インストール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
JBossは“8”番を選択します。
Notice: JBoss4.xの場合は、“9”番を選択します。
94
JENNIFER4.0 インストールガイド
###################################################
######### Jennifer Agent Pre-Installation #########
###################################################
###################################################
Step 1. Select Java Application Server
###################################################
Send me e-mail at [email protected], if you can't find Java Application Serv
er you would like to install.
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x
3. JEUS 4.x / 5.x
4. OracleAS 10gR3
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin 2.x/3.0.x/3.1.x/ 4.0.x
8. Jboss 3.x
9. Jboss 4.x
10. Sun App Server 7.x/8.x/9.x
11. Glassfish 1.x/2.x
Select : 8
7. インストールガイド（JBoss 用）
95
2. JBossのホームディレクトリを指定します。jennifer.jarファイルをJBossホームディレクトリの
\server\default\deploy\jbossweb-tomcat50.sarディレクトリにコピーする作業が行われます。
c:\JavaApplicationServer\jboss3と入力してEnterを入力します。
###################################################
Step 2. Type Java Application Server Home Directory
###################################################
"This process is for configuring jennifer.jar."
Example : c:\JavaApplicationServer\jboss3
Type the exact path of directory for selected Java Application Server:
c:\JavaApplicationServer\jboss3
Java Application Server Home Directory : c:\JavaApplicationServer\jboss3
“/JavaApplicationServer/jboss3”/server/default/deploy/
jbossweb-tomcat50.sar jennifer.jar copy successful"
3. JBossが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイル
が生成されます。c:\Java\jdk16u13と入力してEnterを入力します。
###################################################
Step 3. Type JAVA Home Directory
###################################################
Input [JAVA_HOME] which is used for Java Application Server : C:\Java\jdk16u13
C:\Java\jdk16u13 is set as JAVA_HOME
"Creating lwst.jdk.jar..."
"LWST build success"
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
Step 4. JENNIFER NATIVE LIBRARY SETTING
###################################################
Does your system have 2GB or more MEMORY? (Y/N) : n
jennifer20.dll has been copied to C:\Java\jdk16u13\bin successfully.
96
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字でなければなりません。指定したエージェント
名で設定ファイルが生成されます。値を記入せずにEnterを入力した場合、デフォルト値が使用さ
れます。生成作業を望まない場合(‘n’を選択した場合)は新しい設定ファイルは生成されません。
この場合、JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正
したあとで使用することが可能です。
###################################################
Step 5 JENNIFER AGENT CONFIGURATION SETTING
###################################################
Do you want to customize agent configuration file ? (Y/N) : y
license_filename [ex: c:\jennifer\license.txt] :
c:\jennifer\jenniferagent\license.txt
agent_name - only 3 char [W11] : A11
logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log
lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :
c:\jennifer\jenniferagent\lwst_A11.log
agent_tcp_port [7750] :
udp_server_host [localhost] : 192.168.0.139
server_udp_runtime_port [6901] :
server_udp_listen_port [6902] :
server_udp_lwst_call_stack_port [6703] :
Will you have any option that you need to change? If "Don't", continue to make
configuration file.
(Y/N)n
"Creating A11.conf..."
Agent configuration is completed...
Please, proceed with Post - Installation tasks
[Pre-Installation is finished]
表 7-4: オプション紹介
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
7. インストールガイド（JBoss 用）
97
オプション
説明
license_filename
ライセンスキーを保存するライセンスファイルパスを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. 最後に設定された情報を確認します。
"Pre-Installation is finished"
[Pre-Installation Summary]
WAS TYPE : JBOSS 3.X
WAS HOME DIRECTORY : c:\JavaApplicationServer\jboss3
JAVA HOME DIRECTORY : C:\Java\jdk16u13
JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent
JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY :
C:\Java\jdk16u13\bin\jennifer20.dll
7.2.3. ポストインストール(Post-Installation)作業
ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェン
ト構成ファイルパスをJBossのJavaオプションに設定する作業をします。
1. JBossの設定ファイルは基本的には、%JBOSS_HOME%\bin\run.batです。例では
c:\JavaApplicationServer\jboss3\bin\run.batです。
2. JBossの設定ファイルのJAVA_OPTSに下記のように事前作業を通じて作られたライブラリ及び
エージェント構成ファイルの設定作業をします。
JAVA_OPTS=-Xbootclasspath/
p:c:\jennifer\jenniferagent\lwst.jdk.jar;c:\jennifer\jenniferagent\lwst.boot.jar
-Djennifer.config=c:\jennifer\jenniferagent\A11.conf
-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar
Warning: JBossが使用するJDKバージョンが1.4以下記の場合、-javaagent:/home/jennifer/agent/
lwst.javaagent.jarを使用しません。
98
JENNIFER4.0 インストールガイド
7.2.4. インストール確認作業
7.2.4.1. ライセンスキー登録
JBossを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。JBossが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプショ
ンを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認
します。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=A11
jennifer.config=c:/jennifer/jenniferagent/A11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted...
java.library.path=
jennifer20.dll shared library loaded successfully.
--------------------------------------Notice: 上記のような“jennifer20.dll shared library loaded successfully.”というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
7.2.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
7. インストールガイド（JBoss 用）
99
7.2.5. JENNIFERエージェント構成削除
1. JBossを中止します。
2. %JBOSS_HOME%\server\default\deploy\jbossweb-tomcat50.sarディレクトリからjennifer.jar
ファイルを削除します。
Notice: JBoss4.xの場合は、%JBOSS_HOME%\server\default\libディレクトリから削除します。
3. %JBOSS_HOME%\bin\run.batファイルでJENNIFERエージェントの設定をを削除します。
4. JENNIFERネイティブライブラリを削除します。(%JAVA_HOME%\bin\jennifer20.dll)
5. JBossを再起動します。
100
JENNIFER4.0 インストールガイド
7. インストールガイド（JBoss 用）
101
102
JENNIFER4.0 インストールガイド
8
インストールガイド（Oracle AS用）
8.1.
UNIX環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
8.1.1. Oracle ASインストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをOracle ASが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行う必要があります。
表 8-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
Oracle ASホームディレクトリ
/was/OracleAS
103
表 8-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
JENNIFERエージェントディレクトリ
/home/jennifer/agent
Javaホームディレクトリ
/was/OracleAS/jdk
JENNIFERサーバIP Address
192.168.0.139
8.1.2. 事前インストール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Oracle ASは“4”番を選択します。
########################################################
########
Jennifer Agent Pre-Installation
########
########################################################
########################################################
Step 1. Select Java Application Server
########################################################
Send me e-mail at [email protected], if you can't find Java Appication Server
you would like to install
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x
3. JEUS 4.x / 5.x
4. Oracle AS 10g
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin
8. Jboss 3
9. Jboss 4
10. Sun App Server
11. Glassfish
Select (Q:Quit)
104
===>> 4
JENNIFER4.0 インストールガイド
2. Oracle ASのホームディレクトリを指定します。jennifer.jarファイルをOracle ASホームディレク
トリの/j2ee/home/lib/api-extディレクトリへコピーする作業が行われます。/was/OracleASと入力
してEnterを入力します。
########################################################
Step 2. Type Java Application Server Home Directory
########################################################
This process is for configuring the jennifer.jar .
Type the exact path of directory for the selected
Oracle AS.
Do you want to use the default ava Application Server HOME [ /usr/OracleAS ]? /
was/OracleAS
Oracle Application Server Home Directory : /was/OracleAS
/was/OracleAS/j2ee/home/lib/api-ext/jennifer.jar is copied successfully
3. Oracle ASが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファ
イルが生成されます。/was/OracleAS/jdkと入力してEnterを入力します。
########################################################
Step 3. Type JAVA Home Directory
########################################################
Specify the JAVA_HOME directory which is used by Java Application Server.
Do you want to use the default JAVA_HOME [/was/OracleAS/jdk] ?
[/was/OracleAS/jdk] is set as JAVA_HOME
Creating lwst.jdk.jar ....
lwst.jdk.jar is created successfully
8. インストールガイド（Oracle AS 用）
105
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業
をします。Oracle ASのJavaオプションに-d64オプションを使用する場合は“y”を入力して
Enterを押します。使用しない場合はそのままEnterを押します。
########################################################
Step 4. Jennifer Native library setting
########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail
libjennifer20_linux_32_32.so test success
/was/OracleAS/jdk/jre/lib/i386/server/libjennifer20.so file is copied
successfully
Notice: このステップではシステムに適合したJENNIFERネイティブライブラリ確認作業後、ネイティブライ
ブラリをローディング可能なディレクトリへコピーする作業を行います。全てのJENNIFERネイティブライブ
ラリが失敗した場合は、OSの種類及びバージョン、JDKの種類及びバージョンの情報を明記の上、
JENNIFERテクニカルサポートチーム([email protected])へEメールでご連絡ください。
106
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生
成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
########################################################
Step 5. Jennifer Agent Configuration setting
########################################################
Do you want to customize an agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char]
ex) W11 ===>> OR1
license_filename [ /home/jennifer/agent/license.txt ] ?
logfile [ /home/jennifer/agent/jennifer_T11.log ] ?
lwst_logfile [ /home/jennifer/agent/lwst_T11.log ] ?
agent_tcp_port [ 7750 ] ?
udp_server_host [ localhost ] ? 192.168.0.139
server_udp_runtime_port [ 6901 ] ?
server_udp_listen_port [ 6902 ] ?
server_udp_lwst_call_stack_port [ 6703 ] ?
The Agent configuration is completed...
Please, proceed with Post Installation tasks
表 8-2: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを
指定します。
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
8. インストールガイド（Oracle AS 用）
107
6. 最後に設定された内容を確認します。
[Pre-Installation is finished]
[ Pre-Installation Summary ]
Java Application Server Type
: Oracle Application Server
Java Application Server Home Directory
: /was/OracleAS
JDK Home Directory
: /was/OracleAS/jdk
Jennifer Agent Directory
: /home/jennifer/agent
Agent config file
: /home/jennifer/agent/OR1.conf
Jennifer LWST file
: lwst.jdk.jar
Jennifer Native library file
server/libjennifer20.so(sl)
: /was/OracleAS/jdk/jre/lib/i386/
8.1.3. ポストインストール(Post-Installation)作業
ポストインストール作業では、事前インストール作業を通じて作成されたライブラリ及びエージェ
ント構成ファイルパスをOracle ASのJavaオプションに設定する作業をします。
• Oracle ASのJavaオプション設定
1. Oracle ASの設定ファイルは基本的には${ORACLE_HOME}/opmn/conf/opmn.xmlです。例では/
was/OracleAS/opmn/conf/opmn.xmlファイルです。
2. Oracle ASの設定ファイルに下記のように事前作業を通じて作られたライブラリ及びエージェント
構成ファイルの設定作業をします。
<category id="start-parameters">
<data id="java-options" value=" -Xmx1024M -Xms512M -Djennifer.config=/home/
jennifer/agent/OR1.conf -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/
jennifer/agent/lwst.boot.jar -javaagent:/home/jennifer/agent/lwst.javaagent.jar"/>
</category>
Warning: Oracle ASが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを
追加しなければならず、jdk1.4未満は該当オプションを設定しません。
108
JENNIFER4.0 インストールガイド
8.1.4. インストール確認作業
8.1.4.1. ライセンスキー登録
Oracle ASを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Oracle ASが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認し
ます。
--------------------------------------Jennifer4.0.5.0(2008-06-09) started.
agent_name=OR1
jennifer.config=/home/jennifer/agent/OR1.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted...
sun.boot.library.path=/was/OracleAS/jdk/jre/lib/i386
java.library.path=/was/OracleAS/jdk/jre/lib/i386/client:/was/OracleAS/jdk/jre/lib/
i386
libjennifer20.so(sl) shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
8.1.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
8. インストールガイド（Oracle AS 用）
109
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
8.1.5. JENNIFERエージェント構成削除
1. Oracle ASを中止します。
2. ${ORACLE_HOME}/j2ee/home/lib/api-extディレクトリのjennifer.jarを削除します。
3. ${ORACLE_HOME}/opmn/conf/opmn.xmlファイルでJENNIFERエージェント関連オプションを
削除します。
4. JENNIFERネイティブライブラリファイル(例の場合/was/OracleAS/jdk/jre/lib/i386/server/
libjennifer20.so)を削除します。
5. Oracle ASを再起動します。
8.2.
Windows環境
JENNIFERエージェントインストールは、事前インストール(pre-installation)、ポストインストー
ル(post-installation)そして、インストール確認作業で構成されています。
8.2.1. Oracle ASインストール環境
下記の表はJENNIFERエージェントインストールについての理解を助けるためにJENNIFERエー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをOracle ASが運用中のサー
バのディレクトリにコピーします。
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザ
サーバの環境情報に合わせてインストール作業を行う必要があります。
表 8-3: JENNIFER エージェント構成例説明のための環境
110
区分
説明
Oracle ASホームディレクトリ
c\JavaApplicationServer\oraas
JENNIFERエージェントホームディレクトリ
c:\jennifer\jenniferagent
Javaホームディレクトリ
c:\JavaApplicationServer\oraas\jdk
JENNIFER サーバIP Address
192.168.0.139
JENNIFER4.0 インストールガイド
8.2.2. 事前インストール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Oracle ASは“4”番を選択します。
###################################################
######### Jennifer Agent Pre-Installation #########
###################################################
###################################################
Step 1. Select Java Application Server
###################################################
Send me e-mail at [email protected], if you can't find Java Application Serv
er you would like to install.
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x
3. JEUS 4.x / 5.x
4. OracleAS 10gR3
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin 2.x/3.0.x/3.1.x/ 4.0.x
8. Jboss 3.x
9. Jboss 4.x
10. Sun App Server 7.x/8.x/9.x
11. Glassfish 1.x/2.x
Select : 4
8. インストールガイド（Oracle AS 用）
111
2. Oracle ASのホームディレクトリを指定します。jennifer.jarファイルをOracle ASホームディレク
トリの\j2ee\home\lib\api-extディレクトリにコピーする作業が行われます。
c:\JavaApplicationServer\oraasと入力してEnterを入力します。
###################################################
Step 2. Type Java Application Server Home Directory
###################################################
"This process is for configuring jennifer.jar."
Example : c:\JavaApplicationServer\oraas
Type the exact path of directory for selected Java Application Server:
c:\JavaApplicationServer\oraas
Java Application Server Home Directory : c:\JavaApplicationServer\oraas
“c:\JavaApplicationServer\oraas”\oraas\j2ee\home\lib\api-ext jennifer.jar
copy successful"
3. Oracle ASが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファ
イルが生成されます。c:\JavaApplicationServer\oraas\jdkと入力してEnterを入力します。
###################################################
Step 3. Type JAVA Home Directory
###################################################
Input [JAVA_HOME] which is used for JavaApplicationServer :
C:\JavaApplicationServer\oraas\jdk
C:\JavaApplicationServer\oraas\jdk is set as JAVA_HOME
"Creating lwst.jdk.jar..."
"LWST build success"
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
Step 4. JENNIFER NATIVE LIBRARY SETTING
###################################################
Does your system have 2GB or more MEMORY? (Y/N) : n
jennifer20.dll has been copied to C:\JavaApplicationServer\oraas\jdk\bin
successfully.
112
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字でなければなりません。指定したエージェント
名で設定ファイルが生成されます。値を記入せずにEnterを入力した場合、デフォルト値が使用さ
れます。生成作業を望まない場合(‘n’を選択した場合)は新しい設定ファイルは生成されません。
この場合、JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正
したあとで使用することが可能です。
###################################################
Step 5. JENNIFER AGENT CONFIGURATION SETTING
###################################################
Do you want to customize agent configuration file ? (Y/N) : y
license_filename [ex: c:\jennifer\license.txt] :
c:\jennifer\jenniferagent\license.txt
agent_name - only 3 char [W11] : A11
logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log
lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :
c:\jennifer\jenniferagent\lwst_A11.log
agent_tcp_port [7750] :
udp_server_host [localhost] : 192.168.0.139
server_udp_runtime_port [6901] :
server_udp_listen_port [6902] :
server_udp_lwst_call_stack_port [6703] :
Will you have any option that you need to change? If "Don't", continue to make
configuration file.
(Y/N)n
"Creating A11.conf..."
Agent configuration is completed...
Please, proceed with Post - Installation tasks
[Pre-Installation is finished]
表 8-4: オプション紹介
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
8. インストールガイド（Oracle AS 用）
113
オプション
説明
license_filename
ライセンスキーを保存するライセンスファイルパスを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. 最後に設定された情報を確認します。
"Pre-Installation is finished"
[Pre-Installation Summary]
WAS TYPE : OracleAS 10gR3
WAS HOME DIRECTORY : c:\JavaApplicationServer\oraas
JAVA HOME DIRECTORY : C:\JavaApplicationServer\oraas\jdk
JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent
JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY :
C:\JavaApplicationServer\oraas\jdk\bin\jennifer20.dll
8.2.3. ポストインストール(Post-Installation)作業
ポストインストール作業では事前インストール作業を通じて作成されたライブラリ及びエージェン
ト構成ファイルパスをOracle ASのJavaオプションに設定する作業をします。
1. Oracle ASの設定ファイルは基本的には、%ORACLE_HOME%\opmn\conf\opmn.xmlです。例
ではc:\JavaApplicationServer\oraas\opmn\conf\opmn.xmlです。
2. Oracle ASの設定ファイルに下記のように事前作業を通じて作られたライブラリ及びエージェント
構成ファイルの設定作業をします。
<category id="start-parameters"> <data id="java-options" value=" -mx1024M -ms512M
-Djennifer.config=c:/jennifer/jenniferagent/A11.conf -Xbootclasspath^/p:c:/
jennifer/jenniferagent/lwst.jdk.jar;c:/jennifer/jenniferagent/lwst.boot.jar
-javaagent:c:/jennifer/jenniferagent/lwst.javaagent.jar"/> </category>
Warning: Oracle ASが使用するJDKバージョンが1.4以下記の場合、-javaagent:/home/jennifer/agent/
lwst.javaagent.jarを使用しません。
Notice: Windowsの場合必ず-Xbootclasspath/pの代わりに-Xbootclasspath^/pとして設定します。
114
JENNIFER4.0 インストールガイド
8.2.4. インストール確認作業
8.2.4.1. ライセンスキー登録
Oracle ASを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Oracle ASが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認
します。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=A11
jennifer.config=c:/jennifer/jenniferagent/A11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted...
java.library.path=
jennifer20.dll shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.dll shared library loaded successfully.”というメッセージがない場合、
インストールガイドのトラブルシューティング部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
8.2.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
8. インストールガイド（Oracle AS 用）
115
8.2.5. JENNIFERエージェント構成削除
1. Oracle ASを中止します。
2. %ORACLE_HOME%\j2ee\home\lib\api-extディレクトリからjennifer.jarファイルを削除しま
す。
3. %ORACLE_HOME%\opmn\conf\opmn.xmlファイルでJENNIFERエージェントの設定をを削
除します。
4. JENNIFERネイティブライブラリを削除します。(%ORACLE_HOME%\jdk\bin\jennifer20.dll)
5. Oracle ASを再起動します。
116
JENNIFER4.0 インストールガイド
8. インストールガイド（Oracle AS 用）
117
118
JENNIFER4.0 インストールガイド
9
インストールガイド（GLASSFISH用）
9.1.
UNIX環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
9.1.1. GlassFishインストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをGlassFishが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明します。実際の作業ではユーザのサーバ環境
情報に合わせてインストール作業を行ってください。
表 9-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
GlassFish5ホームディレクトリ
/was/glassfish
119
表 9-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
JENNIFERエージェントディレクトリ
/home/jennifer/agent
Javaホームディレクトリ
/jdk/sun/java15
JENNIFERサーバIP Address
192.168.0.139
9.1.2. 事前インストール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
GlassFishは“11”番を選択します。
########################################################
########
Jennifer Agent Pre-Installation
########
########################################################
########################################################
Step 1. Select Java Application Server
########################################################
Send me e-mail at [email protected], if you can't find Java Appication Server
you would like to install
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x
3. JEUS 4.x / 5.x
4. Oracle AS 10g
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin
8. Jboss 3
9. Jboss 4
10. Sun App Server
11. Glassfish
Select (Q:Quit)
120
===>> 11
JENNIFER4.0 インストールガイド
2. GlassFishのホームディレクトリを指定します。jennifer.jarファイルをGlassFishホームディレク
トリのlibディレクトリへコピーする作業が行われます。/was/glassfishと入力してEnterを押しま
す。
########################################################
Step 2. Type Java Application Server Home Directory
########################################################
This process is for configuring the jennifer.jar .
Type the exact path of directory for the selected
Sun Glassfish.
Do you want to use the default Java Application Server HOME [ /usr/local/
glassfish ]? /was/glassfish
Sun Glassfish Home Directory : /was/glassfish
/was/glassfish/lib/jennifer.jar is copied successfully
3. GlassFishが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファ
イルが生成されます。/jdk/sun/java15と入力してEnterを入力します。
########################################################
Step 3. Type JAVA Home Directory
########################################################
Specify the JAVA_HOME directory which is used by Java Application Server.
There is no default JAVA_HOME directory. Input the JAVA_HOME of the Java
Application Server. ===>> /jdk/sun/java15
[/jdk/sun/java15] is set as JAVA_HOME
Creating lwst.jdk.jar ....
lwst.jdk.jar is created successfully
9. インストールガイド（GLASSFISH 用）
121
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業
をします。GlassFishのJavaオプションに-d64オプションを使用する場合は“y”を入力し、
Enterを押します。使用しない場合はそのままEnterを押します。
########################################################
Step 4. Jennifer Native library setting
########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail
libjennifer20_linux_32_32.so test success
/jdk/sun/java15/jre/lib/i386/server/libjennifer20.so file is copied successfully
Notice: このステップではシステムに適合したJENNIFERネイティブライブラリ確認作業後、ネイティブライ
ブラリをローディング可能なディレクトリへコピーする作業を行います。全てのJENNIFERネイティブライブ
ラリが失敗した場合は、OSの種類及びバージョン、JDKの種類及びバージョンの情報を明記の上、
JENNIFERテクニカルサポートチーム([email protected])へEメールでご連絡ください。
122
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生
成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
########################################################
Step 5. Jennifer Agent Configuration setting
########################################################
Do you want to customize an agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char]
ex) W11 ===>> G01
license_filename [ /home/jennifer/agent/license.txt ] ?
logfile [ /home/jennifer/agent/jennifer_G01.log ] ?
lwst_logfile [ /home/jennifer/agent/lwst_G01.log ] ?
agent_tcp_port [ 7750 ] ?
udp_server_host [ localhost ] ? 192.168.0.139
server_udp_runtime_port [ 6901 ] ?
server_udp_listen_port [ 6902 ] ?
server_udp_lwst_call_stack_port [ 6703 ] ?
The Agent configuration is completed...
Please, proceed with Post Installation tasks
表 9-2: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを
指定します。
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
9. インストールガイド（GLASSFISH 用）
123
6. 最後に設定された内容を確認します。
[ Pre-Installation Summary ]
Java Application Server Type
: Sun Glassfish
Java Application Server Home Directory
: /was/glassfish
JDK Home Directory
: /jdk/sun/java15
Jennifer Agent Directory
: /home/jennifer/agent
Agent config file
: /home/jennifer/agent/G01.conf
Jennifer LWST file
: lwst.jdk.jar
Jennifer Native library file
libjennifer20.so(sl)
: /was/glassfish/lib/
9.1.3. ポストインストール(Post-Installation)作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェ
ント構成ファイルパスをGlassFish Javaオプションに設定する作業をします。
• GlassFish Javaオプション設定
1. GlassFishの管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メ
ニューを選択します。
2. 管理コンソールで下記のような設定を追加後、設定を保存します。
-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/
lwst.boot.jar
-javaagent:/home/jennifer/agent/lwst.javaagent.jar
-Djennifer.config=/home/jennifer/agent/G01.conf
Warning: GlassFishが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを
追加しなければならず、jdk1.4未満は該当オプションを設定しません。
124
JENNIFER4.0 インストールガイド
9.1.4. インストール確認作業
9.1.4.1. ライセンスキー登録
GlassFishを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。GlassFishが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認し
ます。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=G01
jennifer.config=/home/jennifer/agent/G01.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
Omitted
sun.boot.library.path=/jdk/sun/java15/jre/lib/i386
java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/jre/lib/
i386:/jdk/sun/java15/jre/../lib/i386
libjennifer20.so(sl) shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
9.1.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
9. インストールガイド（GLASSFISH 用）
125
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
9.1.5. JENNIFERエージェント構成削除
1. GlassFishを中止します。
2. GlassFish管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メ
ニューから追加したJENNIFERエージェント設定を削除後、設定を保存します。
3. ${GLASSFISH_HOME}/lib(/was/glassfish/lib)ディレクトリのjennifer.jarを削除します。
4. JENNIFERネイティブライブラリファイル(/jdk/sun/java15/jre/lib/i386/server/libjennifer20.so)を削除
します。
5. GlassFishを再起動します。
9.2.
Windows環境
JENNIFERエージェントインストールは、事前インストール(pre-installation)、ポストインストー
ル(post-installation)そして、インストール確認作業で構成されています。
9.2.1. GlassFishインストール環境
下記の表はJENNIFERエージェントインストールについての理解を助けるためにJENNIFERエー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをGlassFishが運用中のサー
バのディレクトリにコピーします。
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザ
サーバの環境情報に合わせてインストール作業を行ってください。
表 9-3: JENNIFER エージェント構成例説明のための環境
126
区分
説明
GlassFishホームディレクトリ
c\JavaApplicationServer\glassfish
JENNIFERエージェントホームディレクトリ
c:\jennifer\jenniferagent
Javaホームディレクトリ
C:\Java\jdk16u13
JENNIFER サーバIP Address
192.168.0.139
JENNIFER4.0 インストールガイド
9.2.2. 事前インストール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
GlassFishは“11”番を選択します。
###################################################
######### Jennifer Agent Pre-Installation #########
###################################################
###################################################
Step 1. Select Java Application Server
###################################################
Send me e-mail at [email protected], if you can't find Java Application Serv
er you would like to install.
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x
3. JEUS 4.x / 5.x
4. OracleAS 10gR3
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin 2.x/3.0.x/3.1.x/ 4.0.x
8. Jboss 3.x
9. Jboss 4.x
10. Sun App Server 7.x/8.x/9.x
11. Glassfish 1.x/2.x
Select : 11
9. インストールガイド（GLASSFISH 用）
127
2. GlassFishのホームディレクトリを指定します。jennifer.jarファイルをGlassFishホームディレク
トリのlibディレクトリにコピーする作業が行われます。c:\JavaApplicationServer\glassfishと入
力してEnterを押します。
###################################################
Step 2. Type Java Application Server Home Directory
###################################################
"This process is for configuring jennifer.jar."
Example : c:\JavaApplicationServer\glassfish
Type the exact path of directory for selected Java Application Server:
c:\JavaApplicationServer\glassfish
Java Application Server Home Directory : c:\JavaApplicationServer\glassfish
“c:\JavaApplicationServer\glassfish”\lib jennifer.jar copy successful"
3. GlassFishが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファ
イルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。
###################################################
Step 3. Type JAVA Home Directory
###################################################
Input [JAVA_HOME] which is used for JAS : C:\Java\jdk16u13
C:\Java\jdk16u13 is set as JAVA_HOME
"Creating lwst.jdk.jar..."
"LWST build success"
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
Step 4. JENNIFER NATIVE LIBRARY SETTING
###################################################
Does your system have 2GB or more MEMORY? (Y/N) : n
jennifer20.dll has been copied to C:\Java\jdk16u13\bin successfully.
128
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生
成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
###################################################
Step 5. JENNIFER AGENT CONFIGURATION SETTING
###################################################
Do you want to customize agent configuration file ? (Y/N) : y
license_filename [ex: c:\jennifer\license.txt] :
c:\jennifer\jenniferagent\license.txt
agent_name - only 3 char [W11] : A11
logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log
lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :
c:\jennifer\jenniferagent\lwst_A11.log
agent_tcp_port [7750] :
udp_server_host [localhost] : 192.168.0.139
server_udp_runtime_port [6901] :
server_udp_listen_port [6902] :
server_udp_lwst_call_stack_port [6703] :
Will you have any option that you need to change? If "Don't", continue to make
configuration file.
(Y/N)n
"Creating A11.conf..."
Agent configuration is completed...
Please, proceed with Post - Installation tasks
[Pre-Installation is finished]
表 9-4: オプション紹介
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
9. インストールガイド（GLASSFISH 用）
129
オプション
説明
license_filename
ライセンスキーを保存するライセンスファイルパスを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. 最後に設定された情報を確認します。
"Pre-Installation is finished"
[Pre-Installation Summary]
WAS TYPE : GlassFish 1.x/2.x
WAS HOME DIRECTORY : c:\JavaApplicationServer\glassfish
JAVA HOME DIRECTORY : C:\Java\jdk16u13
JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent
JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Java\jdk16u13\jennifer20.dll
9.2.3. ポストインストール(Post-Installation)作業
ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェン
ト構成ファイルパスをGlassFish Javaオプションに設定する作業をします。
1. GlassFishの管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メ
ニューを選択します。
2. 管理コンソールで下記のような設定を追加後、設定を保存します。
-Xbootclasspath/
p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lwst.jdk.jar
-Djennifer.config=c:\jennifer\jenniferagent\A11.conf
-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar
Warning: GlassFishが使用するJDKが1.5以上の場合、
-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jarを追加しなければならず、jdk1.4未満は該当オプ
ションを設定しません。
130
JENNIFER4.0 インストールガイド
9.2.4. インストール確認作業
9.2.4.1. ライセンスキー登録
GlassFishを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。GlassFishが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認
します。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=A11
jennifer.config=c:/jennifer/jenniferagent/A11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted ...
java.library.path=
jennifer20.dll shared library loaded successfully.
--------------------------------------Notice: 上記のような“jennifer20.dll shared library loaded successfully.”というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
9.2.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
9. インストールガイド（GLASSFISH 用）
131
9.2.5. JENNIFERエージェント構成削除
1. GlassFishを中止します。
2. GlassFish管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メ
ニューから追加したJENNIFERエージェント設定を削除後、設定を保存します。
3. /was/glassfish/libディレクトリのjennifer.jarを削除します。
4. JENNIFERネイティブライブラリファイル(%JAVA_HOME%\bin\jennifer20.dll)を削除します。
5. GlassFishを再起動します。
132
JENNIFER4.0 インストールガイド
9. インストールガイド（GLASSFISH 用）
133
134
JENNIFER4.0 インストールガイド
10
インストールガイド（Sun AS用）
10.1. UNIX環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
10.1.1.Sun ASインストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをSun ASが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行ってください。
表 10-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
Sun ASホームディレクトリ
/was/SUNWappserver9
135
表 10-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
JENNIFERエージェントディレクトリ
/home/jennifer/agent
Javaホームディレクトリ
/jdk/sun/java15
JENNIFERサーバIP Address
192.168.0.139
10.1.2.事前インストール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Sun ASは“10”番を選択します。
########################################################
########
Jennifer Agent Pre-Installation
########
########################################################
########################################################
Step 1. Select Java Application Server
########################################################
Send me e-mail at [email protected], if you can't find Java Appication Server
you would like to install
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x
3. JEUS 4.x / 5.x
4. Oracle AS 10g
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin
8. Jboss 3
9. Jboss 4
10. Sun App Server
11. Glassfish
Select (Q:Quit)
136
===>> 10
JENNIFER4.0 インストールガイド
2. Sun ASのホームディレクトリを指定します。jennifer.jarファイルをSun ASホームディレクトリ
のlibディレクトリへコピーする作業が行われます。/was/SUNWappserverと入力してEnterを押し
ます。
########################################################
Step 2. Type Java Application Server Home Directory
########################################################
This process is for configuring the jennifer.jar .
Type the exact path of directory for the selected
Sun Application Server.
Do you want to use the default Java Application Server HOME [ /usr/local/
SunAppServer ]? /was/SUNWappserver9
Sun Application Server Home Directory : /was/SUNWappserver9
/was/SUNWappserver9/lib/jennifer.jar is copied successfully
3. Sun ASが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ
ルが生成されます。/jdk/sun/java15と入力してEnterを入力します。
########################################################
Step 3. Type JAVA Home Directory
########################################################
Specify the JAVA_HOME directory which is used by Java Application Server.
There is no default JAVA_HOME directory. Input the JAVA_HOME of the Java
Application Server. ===>> /jdk/sun/java15
[/jdk/sun/java15] is set as JAVA_HOME
Creating lwst.jdk.jar ....
lwst.jdk.jar is created successfully
10. インストールガイド（Sun AS 用）
137
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業
をします。Sun ASのJavaオプションに-d64オプションを使用する場合は“y”を入力し、Enterを
押します。使用しない場合はそのままEnterを押します。
########################################################
Step 4. Jennifer Native library setting
########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail
libjennifer20_linux_32_32.so test success
/jdk/sun/java15/jre/lib/i386/server/libjennifer20.so file is copied successfully
Notice: このステップではシステムに適合したJENNIFERネイティブライブラリ確認作業後、ネイティブライ
ブラリをローディング可能なディレクトリへコピーする作業を行います。全てのJENNIFERネイティブライブ
ラリが失敗した場合は、OSの種類及びバージョン、JDKの種類及びバージョンの情報を明記の上、
JENNIFERテクニカルサポートチーム([email protected])へEメールでご連絡ください。
138
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生
成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
########################################################
Step 5. Jennifer Agent Configuration setting
########################################################
Do you want to customize an agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char]
ex) W11 ===>> SW1
license_filename [ /home/jennifer/agent/license.txt ] ?
logfile [ /home/jennifer/agent/jennifer_SW1.log ] ?
lwst_logfile [ /home/jennifer/agent/lwst_SW1.log ] ?
agent_tcp_port [ 7750 ] ?
udp_server_host [ localhost ] ? 192.168.0.139
server_udp_runtime_port [ 6901 ] ?
server_udp_listen_port [ 6902 ] ?
server_udp_lwst_call_stack_port [ 6703 ] ?
The Agent configuration is completed...
Please, proceed with Post Installation tasks
表 10-2: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを
指定します。
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
10. インストールガイド（Sun AS 用）
139
6. 最後に設定された内容を確認します。
[ Pre-Installation Summary ]
Java Application Server Type
: Sun Application Server
Java Application Server Home Directory
: /was/SUNWappserver9
JDK Home Directory
: /jdk/sun/java15
Jennifer Agent Directory
: /home/jennifer/agent
Agent config file
: /home/jennifer/agent/SW1.conf
Jennifer LWST file
: lwst.jdk.jar
Jennifer Native library file
libjennifer20.so(sl)
: /was/SUNWappserver9/lib/
10.1.3.ポストインストール(Post-Installation)作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェ
ント構成ファイルパスをSun AS Javaオプションに設定する作業をします。
• Sun AS 8.x/9.xのJavaオプション設定
1. Sun ASの管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メ
ニューを選択します。
2. 管理コンソールで下記のような設定を追加後、設定を保存します。
-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/
lwst.boot.jar
-javaagent:/home/jennifer/agent/lwst.javaagent.jar
-Djennifer.config=/home/jennifer/agent/G01.conf
Warning: Sun ASが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを追
加しなければならず、jdk1.4未満は該当オプションを設定しません。
• SUN AS 7のJavaオプション設定
1. Javaオプションの設定ファイルは基本的に${SUNAS_HOME}/domains/domain1/server1/config/
serverxmlです。
140
JENNIFER4.0 インストールガイド
2. 設定ファイルに下記のJENNIFERエージェント設定を追加します。
<jvm-options>-Djennifer.config=/home/jennifer/agent/SW1.conf</jvm-options>
<jvm-options>-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/
agent/lwst.boot.jar</jvm-options>
<jvm-options>-javaagent:/home/jennifer/agent/lwst.javaagent.jar</options>
Warning: Sun ASが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを追
加しなければならず、jdk1.4未満は該当オプションを設定しません。
10.1.4.インストール確認作業
10.1.4.1.ライセンスキー登録
Sun ASを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Sun ASが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認し
ます。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=SW1
jennifer.config=/home/jennifer/agent/SW1.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
Omitted
sun.boot.library.path=/jdk/sun/java15/jre/lib/i386
java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/jre/lib/
i386:/jdk/sun/java15/jre/../lib/i386
libjennifer20.so(sl) shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
10. インストールガイド（Sun AS 用）
141
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
10.1.4.2.モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
10.1.5.JENNIFERエージェント構成削除
1. Sun ASを中止します。
2. Sun AS管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メ
ニューから追加したJENNIFERエージェント設定を削除後、設定を保存します。
3. ${SUNAS_HOME}/lib(/was/SUNWappserver/lib)ディレクトリのjennifer.jarを削除します。
4. JENNIFERネイティブライブラリファイル(/jdk/sun/java15/jre/lib/i386/server/libjennifer20.so)を削除
します。
5. Sun ASを再起動します。
10.2. Windows環境
JENNIFERエージェントインストールは、事前インストール(pre-installation)、ポストインストー
ル(post-installation)そして、インストール確認作業で構成されています。
10.2.1.Sun ASインストール環境
下記の表はJENNIFERエージェントインストールについての理解を助けるためにJENNIFERエー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをSun ASが運用中のサーバ
のディレクトリにコピーします。
142
JENNIFER4.0 インストールガイド
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザ
サーバの環境情報に合わせてインストール作業を行ってください。
表 10-3: JENNIFER エージェント構成例説明のための環境
区分
説明
Sun ASホームディレクトリ
c\JavaApplicationServer\sunas8
JENNIFERエージェントホームディレクトリ
c:\jennifer\jenniferagent
Javaホームディレクトリ
C:\Java\jdk16u13
JENNIFER サーバIP Address
192.168.0.139
10.2.2.事前インストール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
10. インストールガイド（Sun AS 用）
143
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Sun ASは“10”番を選択します。
###################################################
######### Jennifer Agent Pre-Installation #########
###################################################
###################################################
Step 1. Select Java Application Server
###################################################
Send me e-mail at [email protected], if you can't find Java Application Serv
er you would like to install.
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x
3. JEUS 4.x / 5.x
4. OracleAS 10gR3
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin 2.x/3.0.x/3.1.x/ 4.0.x
8. Jboss 3.x
9. Jboss 4.x
10. Sun App Server 7.x/8.x/9.x
11. Glassfish 1.x/2.x
Select : 10
144
JENNIFER4.0 インストールガイド
2. Sun ASのホームディレクトリを指定します。jennifer.jarファイルをSun ASホームディレクトリ
のlibディレクトリにコピーする作業が行われます。c:\JavaApplicationServer\sunas8と入力して
Enterを押します。
###################################################
Step 2. Type Java Application Server Home Directory
###################################################
"This process is for configuring jennifer.jar."
Example : c:\JavaApplicationServer\sunas
Type the exact path of directory for selected Java Application Server:
c:\JavaApplicationServer\sunas8
Java Application Server Home Directory : c:\JavaApplication Server\sunas8
“c:\JavaApplicationServer\sunas8”\lib jennifer.jar copy successful"
3. Sun ASが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ
ルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。
###################################################
Step 3. Type JAVA Home Directory
###################################################
Input [JAVA_HOME] which is used for JAS : C:\Java\jdk16u13
C:\Java\jdk16u13 is set as JAVA_HOME
"Creating lwst.jdk.jar..."
"LWST build success"
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
Step 4. JENNIFER NATIVE LIBRARY SETTING
###################################################
Does your system have 2GB or more MEMORY? (Y/N) : n
jennifer20.dll has been copied to C:\Java\jdk16u13\bin successfully.
10. インストールガイド（Sun AS 用）
145
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生
成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
###################################################
Step 5. JENNIFER AGENT CONFIGURATION SETTING
###################################################
Do you want to customize agent configuration file ? (Y/N) : y
license_filename [ex: c:\jennifer\license.txt] :
c:\jennifer\jenniferagent\license.txt
agent_name - only 3 char [W11] : A11
logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log
lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :
c:\jennifer\jenniferagent\lwst_A11.log
agent_tcp_port [7750] :
udp_server_host [localhost] : 192.168.0.139
server_udp_runtime_port [6901] :
server_udp_listen_port [6902] :
server_udp_lwst_call_stack_port [6703] :
Will you have any option that you need to change? If "Don't", continue to make
configuration file.
(Y/N)n
"Creating A11.conf..."
Agent configuration is completed...
Please, proceed with Post - Installation tasks
[Pre-Installation is finished]
表 10-4: オプション紹介
146
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
JENNIFER4.0 インストールガイド
オプション
説明
license_filename
ライセンスキーを保存するライセンスファイルパスを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. 最後に設定された情報を確認します。
"Pre-Installation is finished"
[Pre-Installation Summary]
WAS TYPE : Sun App Server 7.x/8.x/9.x.10.x
WAS HOME DIRECTORY : c:\JavaApplicationServer\sunas8
JAVA HOME DIRECTORY : C:\Java\jdk16u13
JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent
JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Java\jdk16u13\jennifer20.dll
10.2.3.ポストインストール(Post-Installation)作業
ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェン
ト構成ファイルパスをSun AS Javaオプションに設定する作業をします。
• Sun AS 8.x/9.xのJavaオプション設定
1. Sun ASの管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メ
ニューを選択します。
2. 管理コンソールで下記のような設定を追加後、設定を保存します。
-Xbootclasspath/
p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lwst.jdk.jar
-Djennifer.config=c:\jennifer\jenniferagent\A11.conf
-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar
Warning: Sun ASが使用するJDKが1.5以上の場合、-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar
を追加しなければならず、jdk1.4未満は該当オプションを設定しません。
• Sun AS 7のJavaオプション設定
10. インストールガイド（Sun AS 用）
147
1. Javaオプションの設定ファイルは基本的に
${SUNAS_HOME}\domains\domain1\server1\config\serverxmlです。
2. 設定ファイルに下記のJENNIFERエージェント設定を追加します。
<jvm-options>-Xms128m -Xmx256m</jvm-options>
<jvm-options>-Xbootclasspath/
p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lwst.jdk.jar</
jvm-options><jvm-options>-Djennifer.config=c:\jennifer\jenniferagent\A11.conf</
jvm-options>
<jvm-options>-javaagent:c:\jennifer\jenniferagent\\lwst.javaagent.jar</
jvm-options>
Warning: Sun ASが使用するJDKが1.5以上の場合、-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar
を追加しなければならず、jdk1.4未満は該当オプションを設定しません。
10.2.4.インストール確認作業
10.2.4.1.ライセンスキー登録
Sun ASを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Sun ASが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
148
JENNIFER4.0 インストールガイド
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認
します。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=A11
jennifer.config=c:/jennifer/jenniferagent/A11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted ...
java.library.path=
jennifer20.dll shared library loaded successfully.
--------------------------------------Notice: 上記のような“jennifer20.dll shared library loaded successfully.”というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
10.2.4.2.モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
10.2.5.JENNIFERエージェント構成削除
1. Sun ASを中止します。
2. Sun AS管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メ
ニューから追加したJENNIFERエージェント設定を削除後、設定を保存します。
3. %SUNAS_HOME%\lib(c:\JavaApplicationServer\sunas8\lib)ディレクトリのjennifer.jarを削
除します。
4. JENNIFERネイティブライブラリファイル(%JAVA_HOME%\bin\jennifer20.dll)を削除します。
10. インストールガイド（Sun AS 用）
149
5. Sun ASを再起動します。
150
JENNIFER4.0 インストールガイド
11
インストールガイド（Interstage用）
11.1. UNIX環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
11.1.1.Interstageインストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをInterstageが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行ってください。
表 11-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
Interstageホームディレクトリ
/opt/Interstage
151
表 11-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
JENNIFERエージェントディレクトリ
/home/jennifer/agent
Javaホームディレクトリ
/opt/Interstage/FJSVawjbk/jdk5
JENNIFERサーバIP Address
192.168.0.139
11.1.2.事前インストール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
152
JENNIFER4.0 インストールガイド
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Interstageは“13”番を選択します。
########################################################
########
Jennifer Agent Pre-Installation
########
########################################################
########################################################
Step 1. Select Java Application Server
########################################################
Send me e-mail at [email protected], if you can't find Java Appication
Server you would like to install
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x
3. JEUS 4.x / 5.x
4. Oracle AS 10g
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin
8. Jboss 3
9. Jboss 4
10. Sun App Server
11. Glassfish
12. Hitachi Cosminexus
13. Fujitsu Interstage
Select (Q:Quit)
===>> 13
11. インストールガイド（Interstage 用）
153
2. Interstageのホームディレクトリを指定します。/opt/Interstageと入力してEnterを押します。
########################################################
Step 2. Type Java Application Server Home Directory
########################################################
This process is for configuring the jennifer.jar .
Type the exact path of directory for the selected
Fujitsu Interstage.
Do you want to use the default Java Application Server HOME [ /opt/FJSVj2ee ]? /
opt/Interstage/FJSVj2ee
Fujitsu Interstage Home Directory : /opt/Interstage
3. Interstageが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jar
ファイルが生成されます。/jdk/sun/java15と入力してEnterを入力します。
########################################################
Step 3. Type JAVA Home Directory
########################################################
Specify the JAVA_HOME directory which is used by Java Application Server.
There is no default JAVA_HOME directory. Input the JAVA_HOME of the Java
Application Server. ===>> /opt/Interstage/FJSVawjbk/jdk5
[/opt/Interstage/FJSVawjbk/jdk5] is set as JAVA_HOME
Creating lwst.jdk.jar ....
lwst.jdk.jar is created successfully
154
JENNIFER4.0 インストールガイド
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業
をします。InterstageのJavaオプションに-d64オプションを使用する場合は“y”を入力し、
Enterを押します。使用しない場合はそのままEnterを押します。
########################################################
Step 4. Jennifer Native library setting
########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail
libjennifer20_linux_32_32.so test success
/opt/Interstage/FJSVawjbk/jdk5/jre/lib/i386/server/libjennifer20.so file is copied
successfully
Notice: このステップではシステムに適合したJENNIFERネイティブライブラリ確認作業後、ネイティブライ
ブラリをローディング可能なディレクトリへコピーする作業を行います。全てのJENNIFERネイティブライブ
ラリが失敗した場合は、OSの種類及びバージョン、JDKの種類及びバージョンの情報を明記の上、
JENNIFERテクニカルサポートチーム([email protected])へEメールでご連絡ください。
11. インストールガイド（Interstage 用）
155
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生
成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
########################################################
Step 5. Jennifer Agent Configuration setting
########################################################
Do you want to customize an agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char]
ex) W11 ===>> SW1
license_filename [ /home/jennifer/agent/license.txt ] ?
logfile [ /home/jennifer/agent/jennifer_SW1.log ] ?
lwst_logfile [ /home/jennifer/agent/lwst_SW1.log ] ?
agent_tcp_port [ 7750 ] ?
udp_server_host [ localhost ] ? 192.168.0.139
server_udp_runtime_port [ 6901 ] ?
server_udp_listen_port [ 6902 ] ?
server_udp_lwst_call_stack_port [ 6703 ] ?
The Agent configuration is completed...
Please, proceed with Post Installation tasks
表 11-2: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを
指定します。
156
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
JENNIFER4.0 インストールガイド
6. 最後に設定された内容を確認します。
[ Pre-Installation Summary ]
Java Application Server Type
: Fujitsu Interstage
Java Application Server Home Directory
: /opt/Interstage
JDK Home Directory
: /opt/Interstage/FJSVawjbk/jdk5
Jennifer Agent Directory
: /home/jennifer/agent
Agent config file
: /home/jennifer/agent/SW1.conf
Jennifer LWST file
: lwst.jdk.jar
Jennifer Native library file
jre/lib/i386/server/libjennifer20.so(sl)
: /opt/Interstage/FJSVawjbk/jdk5/
11.1.3.ポストインストール(Post-Installation)作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェ
ント構成ファイルパスをInterstage Javaオプションに設定する作業をします。
• jennifer.jarファイルのコピー
JENNIFERの「jennifer.jar」ファイルをInterstageにコピーします。コピー先は[Interstageホーム
ディレクトリ/J2EEホームディレクトリ/var/deployment/ijserver/APサーバ名/ext]です。
cp /home/jennifer/agent/jennifer.jar /opt/Interstage/FJSVj2ee/var/deployment/
ijserver/IJServer/ext/
• Interstage 8.x/9.xのJavaオプション設定
1. Interstageの管理コンソールの[Interstage Application Server|System|WorkUnit|サービス名
|Settings|WorkUnit Settings|Java VM Options]メニューを選択します。
2. 管理コンソールで下記のような設定を追加後、設定を保存します。
-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/
lwst.boot.jar
-javaagent:/home/jennifer/agent/lwst.javaagent.jar
-Djennifer.config=/home/jennifer/agent/G01.conf
Warning: Interstageが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを
追加しなければならず、jdk1.4未満は該当オプションを設定しません。
11. インストールガイド（Interstage 用）
157
11.1.4. インストール確認作業
11.1.4.1.ライセンスキー登録
Interstageを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Interstageが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオ
プションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認し
ます。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=SW1
jennifer.config=/home/jennifer/agent/SW1.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
Omitted
sun.boot.library.path=/opt/Interstage/FJSVawjbk/jdk5/jre/lib/i386/
java.library.path=/opt/Interstage/FJSVawjbk/jdk5jre/lib/i386/client:/opt/
Interstage/FJSVawjbk/jdk5/jre/lib/i386:/opt/Interstage/FJSVawjbk/jdk5/jre/../lib/
i386
libjennifer20.so(sl) shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
11.1.4.2.モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
158
JENNIFER4.0 インストールガイド
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
11.1.5.JENNIFERエージェント構成削除
1. Interstageを中止します。
2. Interstageの管理コンソールの[Interstage Application Server|System|WorkUnit|サービス名
|Settings|WorkUnit Settings|Java VM Options]メニューから追加したJENNIFERエージェン
ト設定を削除後、設定を保存します。
3. /opt/Interstage/FJSVj2ee/var/deployment/ijserver/IJServer/ext/ディレクトリの
jennifer.jarを削除します。
4. JENNIFERネイティブライブラリファイル(/opt/Interstage/FJSVawjbk/jdk5/bin/libjennifer20.so)
を削除します。
5. Interstageを再起動します。
11.2. Windows環境
JENNIFERエージェントインストールは、事前インストール(pre-installation)、ポストインストー
ル(post-installation)そして、インストール確認作業で構成されています。
11.2.1.Interstageインストール環境
下記の表はJENNIFERエージェントインストールについての理解を助けるためにJENNIFERエー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをInterstageが運用中のサー
バのディレクトリにコピーします。
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザ
サーバの環境情報に合わせてインストール作業を行ってください。
表 11-3: JENNIFER エージェント構成例説明のための環境
区分
説明
Interstageホームディレクトリ
c\Interstage\
JENNIFERエージェントホームディレクトリ
c:\jennifer\agent
Javaホームディレクトリ
C:\Interstage\jdk5
11. インストールガイド（Interstage 用）
159
表 11-3: JENNIFER エージェント構成例説明のための環境
区分
説明
JENNIFER サーバIP Address
192.168.0.139
11.2.2.事前インストール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Interstageは“13”番を選択します。
###################################################
######### Jennifer Agent Pre-Installation #########
###################################################
###################################################
Step 1. Select Java Application Server
###################################################
Send me e-mail at [email protected], if you can't find Java Application Serv
er you would like to install.
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x
3. JEUS 4.x / 5.x
4. OracleAS 10gR3
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin 2.x/3.0.x/3.1.x/ 4.0.x
8. Jboss 3.x
9. Jboss 4.x
10. Sun App Server 7.x/8.x/9.x
11. Glassfish 1.x/2.x
12. Hitachi Cosminexus
13. Fujitsu Interstage
Select : 13
160
JENNIFER4.0 インストールガイド
2. Interstageのホームディレクトリを指定します。c:\Interstageと入力してEnterを押します。
###################################################
Step 2. Type Java Application Server Home Directory
###################################################
"This process is for configuring jennifer.jar."
Example : c:\JavaApplicationServer\Interstage
Type the exact path of directory for selected Java Application Server:
c:\Interstage
Java Application Server Home Directory : c:\Interstage
3. Interstageが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jar
ファイルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。
###################################################
Step 3. Type JAVA Home Directory
###################################################
Input [JAVA_HOME] which is used for JAS : C:\Interstage\jdk5
C:\Interstage\jdk5 is set as JAVA_HOME
"Creating lwst.jdk.jar..."
"LWST build success"
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
Step 4. JENNIFER NATIVE LIBRARY SETTING
###################################################
Does your system have 2GB or more MEMORY? (Y/N) : n
jennifer20.dll has been copied to C:\Interstage\jdk5\bin successfully.
11. インストールガイド（Interstage 用）
161
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生
成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
###################################################
Step 5. JENNIFER AGENT CONFIGURATION SETTING
###################################################
Do you want to customize agent configuration file ? (Y/N) : y
license_filename [ex: c:\jennifer\license.txt] :
c:\jennifer\jenniferagent\license.txt
agent_name - only 3 char [W11] : A11
logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log
lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :
c:\jennifer\jenniferagent\lwst_A11.log
agent_tcp_port [7750] :
udp_server_host [localhost] : 192.168.0.139
server_udp_runtime_port [6901] :
server_udp_listen_port [6902] :
server_udp_lwst_call_stack_port [6703] :
Will you have any option that you need to change? If "Don't", continue to make
configuration file.
(Y/N)n
"Creating A11.conf..."
Agent configuration is completed...
Please, proceed with Post - Installation tasks
[Pre-Installation is finished]
表 11-4: オプション紹介
162
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
JENNIFER4.0 インストールガイド
オプション
説明
license_filename
ライセンスキーを保存するライセンスファイルパスを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. 最後に設定された情報を確認します。
"Pre-Installation is finished"
[Pre-Installation Summary]
WAS TYPE : Fujitsu Interstage
WAS HOME DIRECTORY : C:\Interstage
JAVA HOME DIRECTORY : C:\Interstage\jdk5
JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent
JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY :
C:\Interstage\jdk5\bin\jennifer20.dll
11.2.3.ポストインストール(Post-Installation)作業
ポストインストール作業では「jennifer.jar」ファイルのコピーと事前インストール作業によって作
成されたライブラリ及びエージェント構成ファイルパスをInterstage Javaオプションに設定する作業
をします。
• jennifer.jarファイルのコピー
JENNIFERの「jennifer.jar」ファイルをInterstageにコピーします。コピー先は[Interstageホーム
ディレクトリ/J2EEホームディレクトリ/var/deployment/ijserver/APサーバ名/ext]です。
cp C:\jennifer\agent\jennifer.jar
c:\Interstage\J2EE\var\deployment\ijserver\IJServer\ext\
• Interstage 8.x/9.xのJavaオプション設定
1. Interstageの管理コンソールの[Interstage Application Server|System|WorkUnit|サービス名
|Settings|WorkUnit Settings|Java VM Options]メニューを選択します。
11. インストールガイド（Interstage 用）
163
2. 管理コンソールで下記のような設定を追加後、設定を保存します。
-Xbootclasspath/p:C:\jennifer\agent\lwst.jdk.jar;C:\jennifer\agent\lwst.boot.jar
-javaagent:C:\jennifer\agent\lwst.javaagent.jar
-Djennifer.config=C:\jennifer\agent\w11.conf
Warning: Interstageが使用するJDKが1.5以上の場合、
-javaagent:C:\jennifer\agent\lwst.javaagent.jarを追加しなければならず、jdk1.4未満は該当オ
プションを設定しません。
11.2.4. インストール確認作業
11.2.4.1.ライセンスキー登録
Interstageを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Interstageが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認
します。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=A11
jennifer.config=c:/jennifer/jenniferagent/w11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted ...
java.library.path=
jennifer20.dll shared library loaded successfully.
--------------------------------------Notice: 上記のような“jennifer20.dll shared library loaded successfully.”というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
164
JENNIFER4.0 インストールガイド
11.2.4.2.モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
11.2.5.JENNIFERエージェント構成削除。
1. Interstageを中止します。
2. Interstageの管理コンソールの[Interstage Application Server|System|WorkUnit|サービス名
|Settings|WorkUnit Settings|Java VM Options]メニューから追加したJENNIFERエージェン
ト設定を削除後、設定を保存します。
3. C:\Interstage\J2EE\var\deployment\ijserver\IJServer\ext\ディレクトリのjennifer.jarを
削除します。
4. JENNIFERネイティブライブラリファイル(C:\Interstage\jdk5\bin\jennifer20.dll)を削除します。
5. Interstageを再起動します。
11. インストールガイド（Interstage 用）
165
166
JENNIFER4.0 インストールガイド
11. インストールガイド（Interstage 用）
167
168
JENNIFER4.0 インストールガイド
12
インストールガイド（Cosminexus用）
12.1. UNIX 環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
12.1.1.Cosminexus インストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをCosminexusが運用中であ
るサーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明させています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行ってください。
表 12-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
Cosminexus ホームディレクトリ
/opt/Hitachi/Cosminexus
169
表 12-1: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
JENNIFERエージェントディレクトリ
/home/jennifer/agent
Javaホームディレクトリ
/opt/Hitachi/Cosminexus/jdk
JENNIFERサーバIP Address
192.168.0.139
12.1.2.事前インストール(Pre-Installation) 作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Cosminexus は“１2”番を選択します。
########################################################
Step 1. Select Java Application Server
########################################################
Send me e-mail at [email protected], if you can't find Java Appication Server
you would like to install
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x
3. JEUS 4.x / 5.x
4. Oracle AS 10g
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin
8. Jboss 3
9. Jboss 4
10. Sun App Server
11. Glassfish
12. Hitachi Cosminexus
13. Fujitsu Interstage
Select (Q:Quit)
170
===>> 12
JENNIFER4.0 インストールガイド
2. Cosminexusのホームディレクトリを指定します。Cosminexusの場合 jennifer.jarファイルを
Cosminexusの「hitj2ee.jar」ファイルにアップロードします。このステップではクラスパスに設
定する方法を提供します。
########################################################
Step 2. Type Java Application Server Home Directory
########################################################
This process is for configuring the jennifer.jar .
Type the exact path of directory for the selected
WebSphere Application Server.
Do you want to use the default Java Application Server HOME [ /usr/Cosminexus/
AppServer ]? /opt/Hitachi/Cosminexuswas
Cosminexus Application Server Home Directory : /opt/Hitachi/Cosminexus
3. Cosminexusが使用するJAVA HOMEディレクトリを指定します。Cosminexusが使用するJAVA
HOMEディレクトリの確認の上、lwst.jdk.jarファイルを生成する作業をします。一般的な場合は
Cosminexusから提供する jdkを使用します。
########################################################
Step 3. Type JAVA Home Directory
########################################################
Specify the JAVA_HOME directory which is used by Java Application Server.
Do you want to use the default JAVA_HOME [/opt/Hitachi/Cosminexus/jdk] ?
[/opt/Hitachi/Cosminexus/jdk] is set as JAVA_HOME
Creating lwst.jdk.jar ....
lwst.jdk.jar is created successfully
12. インストールガイド（Cosminexus 用）
171
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業を
します。CosminexusのJavaオプションに-d64オプションを使用する場合は“y”を入力し、Enter
を押します。使用しない場合はそのままEnterを押します。
########################################################
Step 4. Jennifer Native library setting
########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/opt/Hitachi/Cosminexus/jdk/bin/libjennifer20.so file is copied successfully
Notice: このステップではシステムに適合したJENNIFERネイティブライブラリ確認作業後、ネイティブライ
ブラリをローディング可能なディレクトリへコピーする作業を行います。全てのJENNIFERネイティブライブ
ラリが失敗した場合は、OSの種類及びバージョン、JDKの種類及びバージョンの情報を明記の上、
JENNIFERテクニカルサポートチーム([email protected])へEメールでご連絡ください。
172
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。エージェント名は必ず3文字にしてください。指定したエージェント名で設定ファ
イルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生成作業
を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、
JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正後、使用
することが可能です。
########################################################
Step 5. Jennifer Agent Configuration setting
########################################################
Do you want to customize an agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char]
ex) W11 ===>> W11
license_filename [ /home/jennifer/agent/license.txt ] ?
logfile [ /home/jennifer/agent/jennifer_W11.log ] ?
lwst_logfile [ /home/jennifer/agent/lwst_W11.log ] ?
agent_tcp_port [ 7750 ] ?
udp_server_host [ localhost ] ? 192.168.0.139
server_udp_runtime_port [ 6901 ] ?
server_udp_listen_port [ 6902 ] ?
server_udp_lwst_call_stack_port [ 6703 ] ?
The Agent configuration is completed...
Please, proceed with Post Installation tasks
表 12-2: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを指定し
ます。
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
12. インストールガイド（Cosminexus 用）
173
6. 最後に設定された内容を確認します。
[Pre-Installation is finished]
[ Pre-Installation Summary ]
Java Application Server Type
: Cosminexus Application Server
Java Application Server Home Directory
: /opt/Hitachi/Cosminexus
JDK Home Directory
: /opt/Hitachi/Cosminexus/jdk
Jennifer Agent Directory
: /home/jennifer/agent
Agent config file
: /home/jennifer/agent/W11.conf
Jennifer LWST file
: lwst.jdk.jar
Jennifer Native library file
libjennifer20.so(sl)
: /opt/Hitachi/Cosminexus/jdk/bin/
12.1.3.ポストインストール(Post-Installation) 作業
ポストインストール作業では、JENNIFERの核心モジュール「jennifer.jar」ファイルをCosminexusの「hitj2ee.jar」ファイルにアップロードします。また、事前インストール作業によって作成され
たライブラリ及びエージェント構成ファイルパスをCosminexus JVMオプションに設定する作業をし
ます。
• jennifer.jarファイルのアップロード
Cosminexusの「hitj2ee.jar」ファイルにjennifer.jarファイルのorg、javax、comパッケージをアッ
プデートします。
1. /opt/Hitachi/Cosminexus/CC/lib/hitj2ee.jarファイルをバックアップします。
cp /opt/Hitachi/Cosminexus/CC/lib/hitj2ee.jar /opt/Hitachi/Cosminexus/CC/lib/hitj2ee.jar.backup
2. 任意のフォルダでjennifer.jarファイルの三つのパッケージ(com, org, javax)を抽出します。
/]# cd /tmp
tmp]# jar –xvf /home/jennifer/agent/jennifer.jar com org javax
3. hitj2ee.jarファイルに抽出したパッケージをアップデートします。
tmp]# jar –uvf /opt/Hitachi/Cosminexus/CC/lib/hitj2ee.jar com org javax
174
JENNIFER4.0 インストールガイド
• Cosminexus JVMオプション設定
1. Cosminexus Management Serverのコンソールで[論理サーバの環境設定|論理J2EEサーバ|J2EE
サーバ|設定するサーバ選択|JVM]メニューを選択します。
2. 「拡張起動パラメタ」に下記の値を各々入力します。
-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/
lwst.boot.jar
-Djennifer.config=/home/jennifer/agent/w11.conf
3. Cosminexusが使っているJDKのバージョンが1.5以上の場合、下記の値も「拡張起動パラメタ」
に入力します。
-javaagent:/home/jennifer/agent/lwst.javaagent.jar
4. 適用ボタンをクリックしてパラメタを適用します。
5. 「設定情報の配布」ボタンをクリックして配布します。
12.1.4.Cosminexus の再起動及び確認事項
12.1.4.1.ライセンスキーの登録
Cosminexusを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。
12. インストールガイド（Cosminexus 用）
175
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=W11
jennifer.config=/home/jennifer/agent/W11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omiitted ...
java.library.path=/opt/Hitachi/Cosminexus/CC/server/bin:/opt/Hitachi/Cosminexus/
DB/CLIENT/UTL:/opt/Hitachi/Cosminexus/jdk/jre/bin:/opt/Hitachi/Cosminexus/jdk/jre/
bin/server... Omiitted ...
libjennifer20.so(sl) shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
12.1.4.2.モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
12.1.5.JENNIFERエージェント構成削除
1. バックアップした「hitj2ee.jar.backup」ファイルを修復します。。
/]#cp /opt/Hitachi/Cosminexus/CC/lib/hitj2ee.jar.backup /opt/Hitachi/Cosminexus/CC/
lib/hitj2ee.jar
176
JENNIFER4.0 インストールガイド
2. Cosminexus Management Serverのコンソールで[論理サーバの環境設定|論理J2EEサーバ|J2EE
サーバ|設定するサーバ選択|JVM]メニューを選択します。
3. 設定した「拡張起動パラメタ」項目の「lwst.boot.jar, lwst.jdk.jar」
、「w11.conf」設定値を削除し
ます。
。
Notice: Cosminexusが使用するJDKのバージョンが1.5以上の場合は「lwst.javaagent.jar」項目も削
除します。
4. JENNIFERネイティブライブラリファイル(例の場合、/opt/Hitachi/Cosminexus/jdk/bin/
libjennifer20.so)を削除します。
5. Cosminexusを再起動します。
12.2. Windows 環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
12.2.1.Cosminexus インストール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをCosminexusが運用中であ
るサーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサー
バ環境情報に合わせてインストール作業を行ってください。
表 12-3: JENNIFER エージェント構成例（説明のための環境）
区分
ディレクトリ
Cosminexus ホームディレクトリ
C:\Program Files\Hitachi\Cosminexus
JENNIFERエージェントディレクトリ
C:\jennifer\jenniferagent
Javaホームディレクトリ
C:\Program Files\Hitachi\Cosminexus\jdk
JENNIFERサーバIP Address
192.168.0.139
12. インストールガイド（Cosminexus 用）
177
12.2.2.事前インストール(Pre-Installation) 作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
WebSphere は“１2”番を選択します。
###################################################
######### Jennifer Agent Pre-Installation #########
###################################################
###################################################
Step 1. Select Java Application Server
###################################################
Send me e-mail at [email protected], if you can't find Java Application Serv
er you would like to install.
1. WebSphere 5.x / 6.x
2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x
3. JEUS 4.x / 5.x
4. OracleAS 10gR3
5. Tomcat 4.x / 5.x
6. Tomcat 6.x
7. Resin 2.x/3.0.x/3.1.x/ 4.0.x
8. Jboss 3.x
9. Jboss 4.x
10. Sun App Server 7.x/8.x/9.x
11. Glassfish 1.x/2.x
12. Hitachi Cosminexus
13. Fujitsu Interstage
Select : 12
178
JENNIFER4.0 インストールガイド
2. Cosminexusのホームディレクトリを指定します。Cosminexusの場合 jennifer.jarファイルを
Cosminexusの「hitj2ee.jar」ファイルにアップロードします。このステップではクラスパスに設
定する方法を提供します。
####################################################
Step 2. Type Java Application Server Home Directory
#####################################################
"This process is for configuring jennifer.jar."
Example : c:\JavaApplicationServer\Cosminexus
Type the exact path of directory for selected Java Application Server: C:\Program
Files\Hitachi\Cosminexus
Java Application Server Home Directory : C:\Program Files\Hitachi\Cosminexus
"Java Application Server Home Directory Check Success"
3. Cosminexusが使用するJAVA HOMEディレクトリを指定します。Cosminexusが使用するJAVA
HOMEディレクトリの確認の上、lwst.jdk.jarファイルを生成する作業をします。一般的な場合は
Cosminexusから提供する jdkを使用します。
#####################################################
Step 3. Type JAVA Home Directory
#####################################################
Input [JAVA_HOME] which is used for Java Application Server: C:\Program
Files\Hitachi\Cosminexus\jdk
C:\Program Files\Hitachi\Cosminexus\jdk is set as JAVA_HOME
"Creating lwst.jdk.jar..."
"LWST build success"
12. インストールガイド（Cosminexus 用）
179
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを設定する必要があります。システムでのメモリが2GBを超える場合は“y”、2GB以下の場合は
“n”を選択します。
####################################################
Step 4. JENNIFER NATIVE LIBRARY SETTING
####################################################
Does your system have 2GB or more MEMORY? (Y/N) : n
jennifer20.dll has been copied to C:\Program Files\Hitachi\Cosminexus\jdk\bin successfully.
180
JENNIFER4.0 インストールガイド
5. JENNIFERエージェントの設定ファイルを構成する作業をします。エージェント名を指定する必
要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設
定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用するように
なります。生成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されませ
ん。この場合、JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせ
て修正後、使用することが可能です。
####################################################
Step 5 JENNIFER AGENT CONFIGURATION SETTING
####################################################
Do you want to customize agent configuration file ? (Y/N) : y
license_filename [ex: c:\jennifer\license.txt] :
c:\jennifer\jennifer\agent\license.txt
agent_name - only 3 char [W11] : A11
logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jennifer\agent\A11.log
lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :
c:\jennifer\jennifer\agent\lwst_A11.log
agent_tcp_port [7750] :
udp_server_host [localhost] : 192.168.0.139
server_udp_runtime_port [6901] :
server_udp_listen_port [6902] :
server_udp_lwst_call_stack_port [6703] :
Will you have any option that you need to change? If "Don't", continue to make
configuration file.
(Y/N)n
"Creating A11.conf..."
Agent configuration is completed...
Please, proceed with Post - Installation tasks
[Pre-Installation is finished]
表 12-4: 設定時に必要なオプション
オプション
説明
agent_name
必ず3文字のエージェント区切り文字を指定します。
12. インストールガイド（Cosminexus 用）
181
オプション
説明
license_filename
ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile
JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile
JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを指定し
ます。
agent_tcp_port
JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host
JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
6. 最後に設定された内容を確認します。
"Pre-Installation is finished"
[Pre-Installation Summary]
WAS TYPE : Cosminexus
WAS HOME DIRECTORY : C:\Program Files\Hitachi\Cosminexus
JAVA HOME DIRECTORY : C:\Program Files\Hitachi\Cosminexus\jdk
JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent
JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Program
Files\Hitachi\Cosminexus\jdk\bin\jennifer20.dll
12.2.3.ポストインストール(Post-Installation) 作業
ポストインストール作業では、JENNIFERの核心モジュール「jennifer.jar」ファイルをCosminexusの「hitj2ee.jar」ファイルにアップロードします。また、事前インストール作業によって作成され
たライブラリ及びエージェント構成ファイルパスをCosminexus JVMオプションに設定する作業をし
ます。
• jennifer.jarファイルのアップロード
Windowsのコマンドプロンプトで、Cosminexusの「hitj2ee.jar」ファイルにjennifer.jarファイルの
org、javax、comパッケージをアップデートします。
1. C:\Program Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jarファイルをバックアップします。
cp C:\Program Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jar C:\Program
Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jar.backup
182
JENNIFER4.0 インストールガイド
2. 任意のフォルダでjennifer.jarファイルの三つのパッケージ(com, org, javax)を抽出します。
C:\>mkdir tmp
C:\>cd tmp
C:\tmp> jar –xvf c:\jennifer\jennifer\agent\jennifer.jar com org javax
3. hitj2ee.jarファイルに抽出したパッケージをアップデートします。
C:\tmp> jar –uvf C:\Program Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jar com org javax
• Cosminexus JVMオプション設定
1. Cosminexus Management Serverのコンソールで[論理サーバの環境設定|論理J2EEサーバ|J2EE
サーバ|設定するサーバ選択|JVM]メニューを選択します。
2. 「拡張起動パラメタ」に下記の値を各々入力します。
-Xbootclasspath/
p:c:\jennifer\jennifer\agent\lwst.jdk.jar;c:\jennifer\jennifer\agent\lwst.boot.jar
-Djennifer.config=c:\jennifer\jennifer\agent\w11.conf
3. Cosminexusが使っているJDKのバージョンが1.5以上の場合、下記の値も「拡張起動パラメタ」
に入力します。
-javaagent:c:\jennifer\jennifer\agent\lwst.javaagent.jar
4. 適用ボタンをクリックしてパラメタを適用します。
5. 「設定情報の配布」ボタンをクリックして配布します。
12.2.4.Cosminexus の再起動及び確認事項
12.2.4.1.ライセンスキーの登録
WebSphereを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。
12. インストールガイド（Cosminexus 用）
183
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
--------------------------------------Jennifer4.0.5.0(2009-06-09) started.
agent_name=A11
jennifer.config=c:/jennifer/jenniferagent/A11.conf
agent_tcp_port=7750
udp_server_host=192.168.0.139
... Omitted ...
java.library.path=...
jennifer20.dll shared library loaded successfully.
--------------------------------------Notice: 上記のような“libjennifer20.so(sl) shared library loaded successfully.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
12.2.4.2.モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。.
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。.
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
12.2.5.JENNIFERエージェント構成削除。
1. バックアップした「hitj2ee.jar.backup」ファイルを修復します。。
C:\tmp>cp C:\Program Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jar.backup C:\Program
Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jar
2. Cosminexus Management Serverのコンソールで[論理サーバの環境設定|論理J2EEサーバ|J2EE
サーバ|設定するサーバ選択|JVM]メニューを選択します。
184
JENNIFER4.0 インストールガイド
3. 設定した「拡張起動パラメタ」項目の「lwst.boot.jar, lwst.jdk.jar」、
「w11.conf」設定値を削除し
ます。
。
Notice: Cosminexusが使用するJDKのバージョンが1.5以上の場合は「lwst.javaagent.jar」項目も削
除します。
4. JENNIFERネイティブライブラリファイル(例の場合、C:\Program
Files\Hitachi\Cosminexus\jdk\bin\jennifer20.dll)を削除します。
5. Cosminexusを再起動します。
12. インストールガイド（Cosminexus 用）
185
186
JENNIFER4.0 インストールガイド
13
構成変更及びトラブルシューティング
13.1. JENNIFERサーバ構成変更
この節ではJENNIFERサーバ及びエージェントが使用しているネットワーク通信ポート構成を変更
する方法について説明します。
13.1.1. クライアントのための設定変更
JENNIFERサーバとJENNIFERクライアントはWeb基盤ユーザインターフェイス提供のために
HTTPプロトコルを使用します。このとき使用するデフォルトHTTPポート番号は7900です。また、
JENNIFERサーバ停止のためのデフォルトポート番号は7999です。このポート番号を変更するには
$JENNIFER_HOME/server/bin/catalina.sh(bat)ファイルを修正します。
187
UNIXまたはLinuxの場合には、catalina.shファイルの次の部分でポート番号を設定します。
JAVA_HOME="$JAVA_HOME"
if [ -z "${STARTUP_PORT}" ]
then
export STARTUP_PORT="7900"
fi
if [ -z "${SHUTDOWN_PORT}" ]
then
export SHUTDOWN_PORT="7999"
fi
Windowsの場合には、catalina.batファイルの次の部分でポート番号を設定します。
set JAVA_HOME=%JAVA_HOME%
if "%STARTUP_PORT%" == "" SET STARTUP_PORT=7900
if "%SHUTDOWN_PORT%" == "" SET SHUTDOWN_PORT=7999
Javaアプレットはチャート構成に必要なデータをJENNIFERサーバからTCP通信を通じて獲得しま
す。このとき使用されるJENNIFERサーバのデフォルトTCPポート番号はJENNIFERサーバの
server_tcp_portオプションで設定します。デフォルトポート番号は6701です。
server_tcp_port = 6701
13.1.2.JENNIFERエージェントのための設定
JENNIFERエージェントは性能データをUDP方式でJENNIFERサーバへ送信します。JENNIFER
サーバはJENNIFERエージェントが送った性能データを3つのUDPポートに分けて受け取ります。
JENNIFERエージェントはJENNIFERサーバのserver_udp_runtime_portオプションで設定した
UDPポートを通じて全てのトランザクションの開始と終了と関連するデータを送信します。このデー
タのサイズは非常に小さく、主にX-Viewチャートを表すために使用します。デフォルトポート番号は
6901です。
server_udp_runtime_port = 6901
188
JENNIFER4.0 インストールガイド
JENNIFERエージェントはJENNIFERサーバのserver_udp_listen_portオプションで設定したUDP
ポートを通じて1秒毎に反復的にサービス要求率、平均応答時間などの性能データを送信します。デ
フォルトポート番号は6902です。
server_udp_listen_port = 6902
JENNIFERエージェントはJENNIFERサーバのserver_udp_lwst_call_stack_portオプションで設
定したUDPポートを通じて2秒毎に反復的にX-Viewトランザクションプロファイルデータを送信しま
す。デフォルトポート番号は6703です。
server_udp_lwst_call_stack_port = 6703
Notice: 前に説明したUDPポート番号を修正するときはJENNIFERサーバだけでなくJENNIFERエージェン
トの同一オプションも共に修正する必要があります。
JENNIFERエージェントがUDP方式で送った性能データをJENNIFERサーバが受けるとき使用す
るIPバインディングアドレスを指定する必要があります。これはJava TCPソケットプログラミングで
new java.net.DatagramSocket(port, ip)クリエーターの２番目のパラメータIPに該当する値です。
ハードウェアに２つ以上のネットワークカードがある場合、特定ネットワークカードに届いたリクエ
ストのみバインディングするときに設定します。udp_server_host属性を"0.0.0.0"に指定すると全ての
ネットワークカードに届いたパケットを受信することが可能です。
udp_server_host = 0.0.0.0
• エージェントTCPコネクションオプション
JENNIFERサーバにJENNIFERエージェントのTCPコネクションのためのTIME OUTオプション
が存在します。下記の設定値がデフォルト値(ms)です。
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
Notice: ネットワーク連結が遅延する現象が発生すると、JENNIFERサーバでエラーが保存されます。この場
合、オプション値を変える前にまずJENNIFERエージェントのサーバ間のネットワーク環境をチューニングす
ることをおすすめします。
13.1.3.JENNIFER使用のためのファイアウォール設定
JENNIFERサーバとJENNIFERエージェントまたはJENNIFERクライアント間にファイアウォー
ルが存在する場合、先に設定したポート番号がファイアウォールを正常に通過するように設定する必
要があります。
13. 構成変更及びトラブルシューティング
189
• ユーザコンピュータからJENNIFERサーバへHTTP7900ポートとTCP6701ポートを通じてアクセ
スするようにします。
• JENNIFERエージェントからJENNIFERサーバへUDP6901、6902、6703ポートを通じてアクセ
スするようにします。
• JENNIFERサーバからJENNIFERエージェントへTCP7750ポートを通じてアクセスするようにし
ます。
Reference: UDPネットワークに対するファイアウォールテストについてマニュアル（ネットワークテスト）
をご参照ください。
13.2. １つのサーバに複数のJENNIFERエージェント
をインストール
JENNIFERエージェントをインストールすると物理的に1つのサーバに複数のインスタンスが存在
する場合が多くあります。このような場合に、JENNIFERエージェントを構成する方法について説明
します。ここでは、同じJENNIFERサーバへ性能データを送信すると仮定します。
同じJavaアプリケーションサーバで動作している複数のインスタスにJENNIFERエージェントをイ
ンストールする場合、基本的に事前インストール作業 (pre-installation)は最初の１回のみ実行します。
２回目からのインストールは既に構成されたエージェント構成ファイル(例、w11.conf)のコピー及び修
正や該当インスタンスへの設定作業になります。
JENNIFERエージェントをインストールして構成されたエージェント構成ファイル(例、w11.conf)
を適切なファイル(例、w12.conf)にコピーし、該当ファイルの内容の中で下記のオプション部分を変更
します。
表 13-5: 必ず変更する必要があるオプション
オプション
説明
agent_name
JENNIFERサーバで認識するIDで、JENNIFERサーバ内で唯一でなければなりません。
agent_tcp_port
JENNIFERサーバからのTCPリクエストを受け取るJENNIFERエージェントのポート
logfile
JENNIFERエージェントのログファイル
lwst_logfile
JENNIFERエージェントのLWSTと関連したログファイル
エージェントをインストールするJavaアプリケーションサーバのJavaオプションに変更されたエー
ジェント構成ファイルのパスとライブラリを設定します。
190
JENNIFER4.0 インストールガイド
13.3. インストールのトラブルシューティング
この節ではJENNIFERエージェントインストール作業の中で生じる可能性のある問題とその対応策
を記述します。
13.3.1.エージェントインストール後にWebアプリケーションサーバが稼
働しない場合
1. JENNIFERエージェントの設定をWebアプリケーションサーバに記述する際にミスタイピングが
なく正確に記述されているか確認します。
2. ミスタイピングがなく、JENNIFERエージェントの設定が正常であるのに起動しない場合はlwst
の生成に誤りがある可能性が高いです。この場合、lwst40.sh(bat)コマンドでlwstファイルを再生
成します。
Warning: lwst生成時、インストール対象Webアプリケーションサーバが使用しているJVMのrt.jar, core.jar
ファイルを基盤として生成されなければなりません。
lwst生成方法 : lwst40.sh(bat) [command option] [rt.jar(core.jar)]
Notice: JDKが1.4までは[commnad option]へjdkを入れ、1.5からはjdk15を入れます。
Notice: 効率的にモニタリングするにはモニタリングするJavaアプリケーションのソースコードを修正せずに、
性能データ収集に必要な追跡コードとプロファイル情報追跡コードをJavaアプリケーションを構成するクラス
に挿入することが可能でなければなりません。これをByte Code Intrumentation(以下BCI)といいます。
JENNIFERでBCIを担当するモジュールをInstrumentationまたはLWSTモジュールと呼びます。
Notice: LWSTモジュールによるBCIは、lwst.boot.jarとlwst.javaagent.jarファイルによるランタイム処理とオ
フラインでjava.lang.ClassLoader, java.net.Socketなどの主要Javaクラスをパッチしてパッケージした
lwst.jdk.jarファイルによる処理に区分されます。
13.3.2.JENNIFERエージェントがサーバに登録されない場合
1. Webアプリケーションサーバオプションの中で-Djennifer.configオプションの設定にミスタイピン
グがないか、設定したファイルが該当位置に存在し、読み込み権限があるか確認します。
2. JENNIFERエージェントオプションファイル(例、w11.conf)の中でudp_server_host、
server_udp_runtime_port、server_udp_listen_port、server_udp_lwst_call_stack_portの値が
JENNIFERサーバの設定値と同じか確認します。
3. JENNIFERエージェントファイルの中でjennifer.jarが正確な位置(javax.servlet.http.HttpServlet
と同じクラス)に存在するか確認します。javax.servlet.http.HttpServletが含まれるクラスパスの
確認は各Webアプリケーションサーバで提供する文書などを参考にします。
13. 構成変更及びトラブルシューティング
191
4. JENNIFERエージェントとサーバ間のファイアウォールのようなネットワークの制約により通信
が正常に成立しない場合があります。TCPの場合は、telnetプログラムで確認が可能です。UDPの
場合は、JENNIFERエージェントで提供するudptest.sh(bat)ユーティリティを実行して
JENNIFERサーバのログに下記のようなメッセージが出力されるか確認します。
Notice: RECV(6703) from=127.0.0.1 data=100 bytes
5. 4)をテストするときパラメータ値が小さい場合は成功しますが、パラメータ値が大きい場合には失
敗することがあります。これはシステム或いはネットワークサイドでパケットのサイズを制限し
ている場合です。JENNIFERエージェントでも１回に送信することが可能なパケットのサイズを
指定できるオプションがあります。xview_profile_udp_packet_size値を減らしながら正常な通信が
できるか確認します。
13.3.3.Invalid LicenseKey メッセージが出力される場合
JENNIFERエージェントディレクトリでipcheck.sh(bat)ユーティリティを実行した結果のIPアドレ
スにライセンスが発行されているか確認します。
Notice: JENNIFERライセンスキーはJENNIFERエージェントのIPアドレスを基盤に発行されます。
Notice: Unix/Linuxでipcheck.sh(bat)実行結果が127.0.0.1の場合、/etc/hostsファイルにホスト名とIPアドレス
をマッピングさせなければなりません。
13.3.4.License Keyを登録できない場合
1. ライセンスファイルに書き込み権限があるか確認します。
2. JENNIFERサーバでJENNIFERエージェントのTCPコネクションが可能かどうか確認します。(デ
フォルトは7750で、JENNIFERエージェントオプションはagent_tcp_portオプションに登録され
たポートです。）
Notice: JENNIFERエージェントでagent_tcp_portオプションに登録されたポートが連結されない場合、構成
管理メニューとリアルタイムアクティブサービスリスト画面などでメニューが正常に表示されません。
13.3.5.CPU/ メモリ情報が表示されない場合
JENNIFERエージェントのlibjennifer20.so(sl)-Windowsの場合、jennifer20.dll-ファイルは、シス
テムやJavaプロセスのCPU使用率及びメモリ使用量を表示します。該当ライブラリがインストールさ
れていないと、システム/メモリに関連する性能データを収集することができません。しかし、
JENNIFERエージェントの動作には問題がありません。
192
JENNIFER4.0 インストールガイド
1. JENNIFERネイティブライブラリが正常にローディングされなければ、JENNIFER エージェント
ログファイルに下記のようなメッセージが表示されます。この場合、JENNIFERクライアント画
面の[ 障害診断 | ユーティリティ | システム環境変数 ]メニューで該当エージェントを選択して、
java.library.pathの値を確認します。libjennifer20.so(sl)-Windowsの場合、該当ディレクトリ内に
jennifer20.dll-ファイルがコピーされているか確認します。
libjennifer20.so(sl) shared library loaded failed: java.lang.UnsatisfiedLinkError: no jennifer20 in
java.library.path
2. JENNIFERエージェントのjni/[OS]ディレクトリでJENNIFERネイティブライブラリをテストす
ることが可能です。libjennifer20.so(sl)-Windowsの場合、ファイル名をjennifer20.dll-に変更して
からtest.shを実行させて下記のようなメッセージが表示されるか確認します。
Notice: Jennifer4.0.4.1(2009-00-00) libjennifer20.so(sl) shared library loaded successfully.
Warning: test.sh ファイルの内容中、 java -Djava.library.path=この部分でjava実行ファイルは必ずWebアプリケー
ションサーバが使用中のjava実行ファイルでなければなりません。
13.3.6.X-Viewに点が表示されない場合
JENNIFERエージェントがサーバに登録されていて、JENNIFERサーバとエージェントのネット
ワークにも問題がないのにX-Viewに点が表示されない場合は下記の内容を確認します。
1. フレームワークの中でstruts2を使用しているか確認します。struts2を使用している場合、
JENNIFERエージェント設定ファイルに下記のように登録します。
http_service_class =org.apache.struts2.dispatcher.FilterDispatcher
http_service_method=doFilter.
2. javax.servlet.http.HttpServletクラスのserviceメソッドを再定義(Override)しているクラスが存在
するか確認します。この場合にもJENNIFERエージェントオプション(http_service_class )に再定
義したクラス名を登録します。
13.3.7.X-ViewプロファイルでSQLが表示されない場合
JDBCコネクション追跡設定とは、java.sql.ConnectionオブジェクトをJenniferConnectionオブ
ジェクトでWrappingすることをいいます。
JENNIFERでは3種類のJDBCコネクション追跡設定方法を提供します。
13. 構成変更及びトラブルシューティング
193
JNDIとjavax.sql.DataSourceで追跡するケースをタイプ1とし、JENNIFERエージェントに特別な
設定なしで運用することが可能です。
Notice: SQL/JDBCに対する情報はServlet/JSP ThreadからのJDBCリクエストのみ抽出されます。Non
Servlet/JSP Threadで発生するJDBC/SQL情報を抽出するには明示的に
enable_non_servlet_thread_jdbc_trace = trueを設定します。
アプリケーションでjava.sql.DriverManagerクラスを通じてjava.sql.Connectionオブジェクトを獲
得するケースをタイプ2とします。
アプリケーションがコネクションプールの役割をする任意のクラスを通じてjava.sql.Connectionオ
ブジェクトを獲得するケースをタイプ3とします。
JDBCコネクション設定タイプ2で、アプリケーションのソースコードにconn =
DriverManager.getConnection("jdbc:apache:commons:dbcp:/poolname"); のように使用する場合、
エージェントの設定ファイルに下記のように設定する必要があります。
user_defined_jdbc_connectionpool_prefixes=jdbc:apache:commons:dbcp
JDBCコネクション設定タイプ3の場合、java.sql.Connectionを解放するメソッドを下記のように設
定しなければなりません。
jdbc_connection_get=db.DBConnectionManager.getConnection(String)
• タイプ3で設定時の留意事項
1. パッケージ名を含むクラス名を使用しなければなりません。但し、メソッドのパラメータはパッ
ケージ名を除いたクラス名のみを使用することが可能です。
2. jdbc_connection_getまたはjdbc_connection_justgetオプションで設定したメソッドの解放値は
java.sql.Connectionタイプでなければなりません。
3. jdbc_connection_closeオプションで設定したメソッドのパラメータの中で必ず１つは
java.sql.Connectionタイプでなければなりません。但し、パラメータ位置は関係ありません。
4. 全てのオプションにセミコロン[;]を区切りとして２つ以上の値を設定することが可能です。
Notice: 該当設定を適用するにはJavaアプリケーションサーバ(インスタンス)を再起動する必要があります。
• フレームワーク別JDBC設定方法
[Hibernate使用時
jdbc_connection_justget = org.hibernate.jdbc.ConnectionManager.getConnection()
194
JENNIFER4.0 インストールガイド
[iBatis使用時
jdbc_connection_get=com.ibatis.sqlmap.engine.transaction.jdbcJdbcTransaction.getConnection()
[Apache DBCP使用時
jdbc_connection_get = org.apache.commons.dbcp.PoolingDataSource.getConnection()
• アプリケーション内で使用するJDBCコネクション方法が分からない場合
1. エージェント設定ファイルでlwst_trace_remote_portのオプションに使用するDBのポート番号を
記述して該当オプションを活性化させます。(一番最初の#を削除)
2. アプリケーションサーバを再起動します。
3. JENNIFER管理コンソール画面の「障害診断」->「ファイル/ソケット」画面に該当ポートに接続
する時点のスタックトレースを確認します。
4. 確認されたコネクション部分をjdbc_connection_getまたはjdbc_connection_justget エージェント
オプションに設定します。
13.3.8.X-ViewプロファイルでSQLパラメータが正常に表示されない場
合
JENNIFERエージェントとサーバのfile.encodingが異なる場合にJENNIFERサーバが収集した性能
データが正常に表示されないことがあります。この場合には明示的にJENNIFERサーバの起動オプ
ションのfile.encoding値をJENNIFERエージェントのserver_encodingオプションに設定します。
13.3.9.JENNIFERエージェントインストール後、ネイティブメモリリー
クが発生した場合
SUN Java1.5や6.0などでNative メモリ Leak現象が発生した場合、Webアプリケーションサーバの
Java実行オプションに次のオプションを追加します。
-XX:CompileCommand=exclude,org/apache/jennifer/bcel/classfile/Attribute,readAttribute
13. 構成変更及びトラブルシューティング
195
13.3.10.エージェントインストール後、アプリケーションクッキー情報
が失われた場合
JENNIFERエージェントは訪問者数と同時端末ユーザ数を収集するためにクッキーを使用します。
使用可能なクッキーの数とクッキーには制限があるため、既存Javaアプリケーションで多くのクッ
キーを使用しているとクッキー情報が失われることがあります。この場合にはJENNIFERエージェン
トのhotfix_remote_address_for_wmonidオプションをtrueに設定します。
hotfix_remote_address_for_wmonid = true
このオプションがtrueに設定されているとremote addressをユーザ区分に使用します。
Notice: hotfix_remote_address_for_wmonidオプションをtrueに設定するとイントラネットシステムでのみ訪
問者数と同時端末ユーザ数が意味を持ちます。
13.3.11.Oracle DB使用時、 ClassCastExceptionが発生する場合
Oracleに従属的なCLOB/BLOBタイプをアプリケーションで明示的にOracleResultSetへタイプキャ
ストして使用しているときClassCastExceptionが発生することがあります。この場合JENNIFERエー
ジェントのオプション設定を通じて解決が可能です。
enable_jdbc_oracle_dependency_used = true
13.3.12.同じ設定で多重プロセスにインストールする場合
JENNIFERエージェントはJavaプロセス単位で設定しなければなりません。これは、各Javaプロ
セスの-Djennifer.configオプションを異なる設定にする必要があるためです。
しかし一部のAPサーバやJavaデーモンが同一実行コマンドに設定された値を利用して複数の多重プ
ロセスを実行する場合があります。この場合には各Javaプロセスのための互いに異なる
-Djennifer.configオプションを個別に設定することができません。
このような多重プロセス環境にJENNIFERエージェントをインストールするときは共通で使用され
るJava実行オプションに-Dconfig.auto=trueを追加で設定します。
詳細の内容についてはマニュアル[JENNIFERエージェント運用管理]部分の[多重プロセスに
JENNIFERをインストール]の部分をご参照ください。
196
JENNIFER4.0 インストールガイド
13.3.13.オンラインインストールテクニカルサポートの問い合わせ
テクニカルサポートの問い合わせの前にJENNIFERSOFTのWebサイト(www.jennifersoft.com)の[
ドキュメント]や[Q&A]をご確認ください。最新マニュアル及び各ドキュメント、過去の問い合わせに
対する回答を掲載しています。
本文書の内容に不明な点がある場合や、インストールと関連した問題がある場合は、
JENNIFERSOFTテクニカルサポートチームからテクニカルサポートをご提供します。
インストール時に問題が発生した場合、Javaアプリケーションサーバ、DBMS、JENNIFERサーバ/
エージェントの基本情報と共にインストールトラブルシューティングの結果ファイルを添付して、
[email protected]までお送りください。
なお、JENNIFERバージョン情報はJENNIFERエージェントディレクトリにあるversion.shコマン
ドを実行させると得ることができます。
13. 構成変更及びトラブルシューティング
197
198
JENNIFER4.0 インストールガイド