jennifer4 install jp - > e-corporation.jp · v adobe、adobe ロゴ、reader は、adobe systems...
TRANSCRIPT
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、InternetExplorer およびExcel は、米国あるいはその他の国における米国Microsoft Corporation の商標または
登録商標です。Windows の正式名称は、Microsoft Windows Operating System です。
Netscape Navigator、Netscape Communicator およびNetscape Enterprise Server は、NetscapeCommunications 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
Table of Contents
Chapter 1 JENNIFER概要 1JENNIFERパッ ケージング構成要素 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1JENNIFERデ ィ レ ク ト リ構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2JENNIFERネ ッ ト ワーク構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Chapter 2 JENNIFERサーバイ ンス ト ール 7JENNIFERサーバスペ ッ ク . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7JENNIFERサーバイ ンス ト ール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
UNIX用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
ク ラ イアン ト 設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Chapter 3 イ ンス ト ールガイ ド (WebSphere用) 21UNIX 環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
WebSphere イ ンス ト ール環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21事前イ ンス ト ール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22ポス ト イ ンス ト ール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26WebSphere の再起動及び確認事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Windows 環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28WebSphere イ ンス ト ール環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28事前イ ンス ト ール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29ポス ト イ ンス ト ール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34WebSphere の再起動及び確認事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Chapter 4 イ ンス ト ールガイ ド (WebLogic用) 37UNIX 環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
WebLogic イ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37事前イ ンス ト ール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38ポス ト イ ンス ト ール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42イ ンス ト ールの確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Windows 環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44WebLogic イ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44事前イ ンス ト ール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45ポス ト イ ンス ト ール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Table of Contents vii
イ ンス ト ールの確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Chapter 5 イ ンス ト ールガイ ド (Tomcat用) 51UNIX環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Tomcatイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51事前イ ンス ト ール(Pre-Installation)作業. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Windows環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Tomcatイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59事前イ ンス ト ール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Chapter 6 イ ンス ト ールガイ ド (Resin用) 67UNIX環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Resinイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67事前イ ンス ト ール(Pre-Installation)作業. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Windows環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Resinイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74事前イ ンス ト ール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Chapter 7 イ ンス ト ールガイ ド (JBoss用) 85UNIX環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
JBossイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85事前イ ンス ト ール(Pre-Installation)作業. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Windows環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93JBossイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93事前イ ンス ト ール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
viii JENNIFER4.0 マニュアル
Chapter 8 イ ンス ト ールガイ ド (Oracle AS用) 103UNIX環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Oracle ASイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103事前イ ンス ト ール(Pre-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Windows環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Oracle ASイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110事前イ ンス ト ール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Chapter 9 イ ンス ト ールガイ ド (GLASSFISH用) 119UNIX環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
GlassFishイ ンス ト ール環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119事前イ ンス ト ール(Pre-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Windows環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126GlassFishイ ンス ト ール環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126事前イ ンス ト ール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Chapter 10 イ ンス ト ールガイ ド (Sun AS用) 135UNIX環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Sun ASイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135事前イ ンス ト ール(Pre-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Windows環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Sun ASイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142事前イ ンス ト ール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Chapter 11 イ ンス ト ールガイ ド (Interstage用) 151
Table of Contents ix
UNIX環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Interstageイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151事前イ ンス ト ール(Pre-Installation)作業. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Windows環境. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159Interstageイ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159事前イ ンス ト ール作業(Pre-installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160ポス ト イ ンス ト ール(Post-Installation)作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163イ ンス ト ール確認作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164JENNIFERエージ ェ ン ト 構成削除。 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Chapter 12 イ ンス ト ールガイ ド (Cosminexus用) 169UNIX 環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Cosminexus イ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169事前イ ンス ト ール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170ポス ト イ ンス ト ール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Cosminexus の再起動及び確認事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175JENNIFERエージ ェ ン ト 構成削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Windows 環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Cosminexus イ ンス ト ール環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177事前イ ンス ト ール(Pre-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178ポス ト イ ンス ト ール(Post-Installation) 作業 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Cosminexus の再起動及び確認事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183JENNIFERエージ ェ ン ト 構成削除。 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Chapter 13 構成変更及び ト ラ ブルシューテ ィ ング 187JENNIFERサーバ構成変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
ク ラ イアン ト のための設定変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187JENNIFERエージ ェ ン ト のための設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188JENNIFER使用のためのフ ァ イアウォール設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
1 つのサーバに複数のJENNIFERエージ ェ ン ト を イ ンス ト ール . . . . . . . . . . . . . . . . . . . 190イ ンス ト ールの ト ラ ブルシューテ ィ ング . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191エージ ェ ン ト イ ンス ト ール後にWebアプ リ ケーシ ョ ンサーバが稼働し ない場合. . . . . . . . . . . . . . 191JENNIFERエージ ェ ン ト がサーバに登録されない場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Invalid LicenseKeyメ ッ セージが出力される場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192License Keyを登録できない場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192CPU/メ モ リ情報が表示されない場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192X-Viewに点が表示されない場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193X-Viewプロ フ ァ イルでSQLが表示されない場合. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193X-Viewプロ フ ァ イルでSQLパラ メ ータが正常に表示されない場合 . . . . . . . . . . . . . . . . . . . . . . . . 195JENNIFERエージ ェ ン ト イ ンス ト ール後、 ネイテ ィ ブ メ モ リ リークが発生し た場合 . . . . . . . . . . 195エージ ェ ン ト イ ンス ト ール後、 アプ リ ケーシ ョ ン ク ッキー情報が失われた場合 . . . . . . . . . . . . . . 196Oracle DB使用時、 ClassCastExceptionが発生する場合. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
x JENNIFER4.0 マニュアル
同じ設定で多重プロセスにイ ンス ト ールする場合 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196オン ラ イ ン イ ンス ト ールテ クニカルサポー ト の問い合わせ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Table of Contents xi
文書構成
本文書は概念的理解を段階的に深めていけるように順次構成されています。しかし、関連主題別に必
要に応じて読めるようできる限り独立した構成となっています。本文書の構成は次の通りです。
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
1JENNIFER概要
この章では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.3.0.1. JENNIFERエージェントとJENNIFERサーバ通信
UDP 通信オプション指定
JENNIFERエージェントは、収集されたデータをUDP方式でJENNIFERサーバに送信します。
JENNIFERサーバは、JENNIFERエージェントが送ったデータを3つのUDPポートに分けて受取りま
す。
下記に紹介する3つのUDPポートは、JENNIFERエージェント構成ファイルとサーバ構成ファイル
全て同一です。JENNIFERサーバ/エージェントインストールシステム環境制限のためポート変更が必
要な場合、両側の構成ファイル全てを同一に変更しなければなりません。
server_udp_runtime_portオプションで設定したUDPポートを通じて全てのトランザクションの開
始と終了に関連するデータを送信します。
server_udp_listen_portオプションで設定したUDPポートを通じて1秒毎に反復的にサービス要求
率、平均応答時間などの性能データを送信します。
2秒毎に反復的にX-Viewトランザクションファイルデータを送信します。
TCP 通信オプション指定
JENNIFERエージェントはJENNIFERサーバからリクエストされたリアルタイムデータの提供及
び構成変更のために固有なTCPポートを指定されます。1台のサーバで複数のエージェントを構成する
場合、ポートが固有に設定されるようにします。 デフォルトポート番号は7750です。
Notice: JENNIFERサーバ/エージェント構築時に特別な制限事項がない場合、追加的な変更なしでデフォルト
値をそのまま使用します。
server_udp_runtime_port = 6901
server_udp_listen_port = 6902
server_udp_lwst_call_stack_port = 6703
agent_tcp_port = 7750
4 JENNIFER4.0 インストールガイド
JENNIFER サーバ IP 指定
JENNIFERサーバがJENNIFERエージェントと別途のサーバ(server)に構成されている場合、デー
タが伝達されるJENNIFERサーバのIPを指定します。
1.3.0.2. JENNIFERサーバとJENNIFERクライアント
管理コンソール接続ポート
JENNIFERクライアントはWeb基盤のユーザインターフェイスを提供します。 JENNIFERクライア
ントは7900ポートを使用して接続します。
ポート変更が必要な場合、SARTUP_PORT環境変数値を他のポートに指定してからJENNIFERサーバを起動します。(startup.sh, startup.bat)
アプレット通信ポート
JENNIFERダッシュボードのJavaアプレットはチャート構成に必要なデータをJENNIFERサーバ
からTCP通信を通じて獲得します。
1.3.0.3. ネットワーク構成に関する注意事項
ネットワーク構成に関する注意事項は次の通りです。
• 同じポートの重複使用防止 - 同じハードウェアに複数のJENNIFERエージェントをインストールし
た場合には、JENNIFERエージェントのagent_tcp_portオプションでインストールしたポート番号
が重複しないようにします。また同じハードウェアに複数のJENNIFERサーバをインストールした
場合には、 JENNIFERサーバのserver_udp_runtime_port, server_udp_listen_port,
udp_server_host = localhost(JENNIFERサーバが運用されるIP記述)
UNIX
export STARTUP_PORT=7901
startup.sh
WINDOWS
set STARTUP_PORT=7901
startup.bat
server_tcp_port = 6701
1. JENNIFER 概要 5
server_udp_lwst_call_stack_port, server_tcp_portなどのオプションで設定したポート番号が重複
しないようにします。
• ファイアウォールに対する点検 - JENNIFERを構成する主要モジュール間にファイアウォールがあ
る場合には、関連ポートが正常に開かれているか確認する必要があります。
6 JENNIFER4.0 インストールガイド
2JENNIFERサーバイ ンス ト ール
この章では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 サーバインストールに必要なサーバの環境情報を表示しています。
本インストールガイドは下記の環境値を基準に説明します。そのため、実際の値はユーザサーバの環境情報に合わせてインストール作業を行ってください。
1. JENNIFERアカウントを新しく作成するとき、/home/jenniferホームディレクトリを確認して作
成します。
2. 作成されたディレクトリに圧縮ファイルを解凍します。
3. JAVA_HOME環境変数をインストールします。
4. /home/jennifer/server/binへ移動します。(cd /home/jennifer/server/bin)
表 2-2: JENNIFER サーバインストール例のためのシステム環境変数
環境変数 値
JENNIFERサーバホームディレクトリ /home/jennifer/server
[JAVA_HOME] /usr/java15
JENNIFERサーバIP Address 192.168.0.139
# gzip -d jennifer4.0.3.tar.gz
# tar -xvf jennifer4.0.3.tar
# export JAVA_HOME=/usr/java5
8 JENNIFER4.0 インストールガイド
5. startup.shを実行後、ログを確認します。
6. ログイン
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
2. JENNIFER サーバイ ンス ト ール 9
Webブラウザのアドレス欄にJENNIFERサーバをインストールしたサーバのIP或いはドメインアド
レスとポート番号で構成されたURLを入力すると、ログイン画面が表示されます。JENNIFERの全て
の機能はログイン後に使用することが可能です。JENNIFER サーバのデフォルトポート番号は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 サーバインストール例のためのシステム環境変数
1. ダウンロードしたJENNIFERパッケージングファイルを圧縮ユーティリティを使用して
JENNIFERインストールディレクトリ(例:c:\jennifer)に解凍します。
2. コマンドプロンプトを実行します。
3. Windowsシステム環境変数にJAVA_HOMEがインストールされているか確認します。
4. 環境変数がインストールされていない場合[マイコンピュータアイコンを右クリック|プロパテイ
選択|詳細タブ選択|環境変数]にJAVA_HOME環境変数値を設定します。
http://jennifer_server_ip:7900
環境変数 値
JEENIFERサーバホームディレクトリ c:\jennifer\server
JAVA_HOME C:\Java\jdk16u13
JENNIFERサーバ IP Address 192.168.0.139
C:\Java>echo %JAVA_HOME%
C:\Java\jdk16u13
10 JENNIFER4.0 インストールガイド
5. コマンドプロンプト上でJENNIFERサーバディレクトリ(例:c:\jennifer\server\bin)移動後、
startup.batを実行します。環境変数を新たに入力する場合、新しいコマンドプロンプトを生成し
てから進行します。エクスプローラ上で直接startup.batファイルをダブルクリックして実行する
ことも可能です。
JENNIFERサーバの最初の起動時のみデータベーステーブル生成作業が進行されます。サーバマシ
ンのスペックによりJENNIFERサーバの起動時間に差が生じることがあります。
6. ログイン
Webブラウザのアドレス欄にJENNIFERサーバをインストールしたサーバのIP或いはドメインアド
レスとポート番号で構成されたURLを入力するとログイン画面が表示されます。JENNIFERの全ての
機能はログイン後に使用することが可能です。JENNIFER サーバのデフォルト番号は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 スタイルが正常に表示されません。現在使用
しているテーマはデスクトップ画面でマウスの右側をクリックすると表示されるコンテキストメニューの[プロパティ ]メニューを選択すると確認することが可能です。
Web ブラウザ
http://jennifer_server_ip:7900
Notice: 公式的にはJENNIFERクライアントはLinuxとMac OSをサポートしていません。しかし、Firefox3.0以上とJavaプラグイン1.6.0_10以上をインストール可能なOSであればJENNIFERを使用することが可能です。
2. JENNIFER サーバイ ンス ト ール 11
MS IE7.0またはIE8.0及びMozilla Firefox3.0などのWebブラウザをサポートします。
JENNIFERを使用するにはクッキーとJavaスクリプトを使用できるようにWebブラウザを設定する
必要があります。大半のWebブラウザはデフォルトでこの機能を使用できるように設定されています。
2.1.0.1. Javaプラグイン
JENNIFERクライアントの一部はJavaアプレットで構成されているためSUN Javaプラグイン
1.6.0_10以上をインストールする必要があります。
インストールと削除
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タブ
を選択します。
Warning: IE6.0はCSSを含んだWeb標準サポートが不十分で透明なPNGイメージファイルを処理できないとい
う短所があります。その為、 IE6.0はサポートしません。IE7.0かIE8.0にアップグレードできない環境では
Firefox3.0を使用することをおすすめします。
Warning: JENNIFER4.0からはMS Java VMをサポートしません。
12 JENNIFER4.0 インストールガイド
図 2-1: Javaコントロールパネル
3. Javaアプレットランタイム設定エリアの表示ボタンをクリックするとJavaランタイム設定画面が
表示されます。 複数のJavaをインストールした場合には[有効]コラムを通じて使用するJavaを選択
します。く
2. JENNIFER サーバイ ンス ト ール 13
図 2-2: Javaランタイム設定
4. 例えば、Javaヒープメモリの最小値を100MB、最大値を150MBに設定するにはJREのJavaラン
タイムパラメータコラムに次のように入力します。
設定可能なJavaヒープメモリ最大値はマシンのスペックと環境に影響を受けます。設定可能な値よ
り大きい値を指定するとエラーが発生したり、Webブラウザが異常終了されることがあります。
設定可能なJavaヒープメモリ最大値についての明確な規定がないため、システムに合わせてJavaヒープメモリ最大値を設定する必要があります。
Web ブラウザ設定 - Java アプレット
MS IE7.0またはIE8.0を使用する場合には[ツール|インターネットオプション]メニューでJavaプラ
グイン有効区分を設定します。インターネットオプションで詳細設定タブを選択するとインストールされたJavaプラグイン情報が表示されます。ここでSUN Javaプラグインを有効にするように設定し
ます。
-Xms100m -Xmx150m
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を使用します。
2. Windowsサービスに登録したら[コントロールパネル|管理ツール|サービス] メニューで
JENNIFERサーバを起動します。
コマンドプロンプトを実行後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. JENNIFER サーバイ ンス ト ール 19
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.2. 事前イ ンス ト ール(Pre-Installation) 作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。 WebSphere は“1”番を選択します。
JENNIFERエージェントディレクトリ /home/jennifer/agent
Javaホームディレクトリ /was/WebSphere61/AppServer/java
JENNIFERサーバIP Address 192.168.0.139
表 3-1: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
########################################################
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) ===>> 1
22 JENNIFER4.0 インストールガイド
2. WebSphereのホームディレクトリを指定します。 WebSphereの場合 jennifer.jarファイルをファイ
ルを特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパスに設定する方法を提供します。
3. WebSphereが使用するJAVA HOMEディレクトリを指定します。 WebSphereが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.jarファイルを生成する作業をします。一般的な場合は WebSphereから提供する jdkを使用します。
########################################################
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
########################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 3-2: 設定時に必要なオプション
########################################################
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
オプション 説明
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. 最後に設定された内容を確認します。
3.1.3. ポス ト イ ンス ト ール(Post-Installation) 作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをWebSphere Javaオプションに設定する作業をします。
• WebSphere Javaオプシ ョ ン設定
1. WebSphereの「管理コンソール」で[サーバー|アプリケーション・サーバ|サーバー選択|
サーバー・インフラストラクチャーのJavaおよびプロセス管理|プロセス定義|追加プロパ
ティーのJava仮想マシン]メニューを選択します。
2. 「一般プロパティー」の「Classpath」に「 jennifer.jar」ファイルのパスを入力します。
3. 「一般プロパティー」の「Boot Classpath」に下記の値を 入力します。
4. 「追加プロパティー」の「カスタム・プロパティー」に下記の値を新規作成します。
[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 : /was/WebSphere61/AppServer/bin/
libjennifer20.so(sl)
/home/jennifer/agent/jennifer.jar
/home/jennifer/agent/lwst.jdk.jar
/home/jennifer/agent/lwst.boot.jar
-Djennifer.config=/home/jennifer/agent/W11.conf
26 JENNIFER4.0 インストールガイド
5. 該当のオプション値を保存します。
3.1.4. WebSphere の再起動及び確認事項
3.1.4.1. ライセンスキーの登録
WebSphereを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンス
キーを登録します。
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
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。ただ、WebSphereが開始するときに登録されるようにするにはエージェント設定ファイルで
agent_boot_classオプションを活性化させます。
---------------------------------------
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.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
3. イ ンス ト ールガイ ド (WebSphere 用) 27
3.1.4.2. モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
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」関連設定値を削除します。
5. JENNIFERネイティブライブラリファイル(例の場合、/was/WebSphere61/AppServer/bin/libjennifer20.so)を削除します。
6. WebSphereを再起動します。
3.2. Windows 環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
3.2.1. WebSphere イ ンス ト ール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
Notice: WebSphereが使用するJDKのバージョンが1.5以上の場合は一般JVMプロパティの「 -javaagent 」項目も削除します。
28 JENNIFER4.0 インストールガイド
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをWebSphereが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行ってください。
3.2.2. 事前イ ンス ト ール(Pre-Installation) 作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
表 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. イ ンス ト ールガイ ド (WebSphere 用) 29
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。 WebSphere は“1”番を選択します。
###################################################
######### 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ファイルをファイ
ルを特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパスに設定する方法を提供します。
3. WebSphereが使用するJAVA HOMEディレクトリを指定します。 WebSphereが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.jarファイルを生成する作業をします。一般的な場合は WebSphereから提供する jdkを使用します。
####################################################
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"
#####################################################
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ファイルを環境に合わせ
て修正後、使用することが可能です。
表 3-4: 設定時に必要なオプシ ョ ン
####################################################
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]
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
3. イ ンス ト ールガイ ド (WebSphere 用) 33
6. 最後に設定された内容を確認します。
3.2.3. ポス ト イ ンス ト ール(Post-Installation) 作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをWebSphere Javaオプションに設定する作業をします。
• WebSphere Javaオプション設定
1. WebSphereの「管理コンソール」で[サーバー|アプリケーション・サーバ|サーバー選択|
サーバー・インフラストラクチャーのJavaおよびプロセス管理|プロセス定義|追加プロパ
ティーのJava仮想マシン]メニューを選択します。
2. 「一般プロパティー」の「Classpath」に「 jennifer.jar」ファイルのパスを入力します。
3. 「一般プロパティー」の「Boot Classpath」に下記の値を 入力します。
license_filename ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを指定し
ます。
agent_tcp_port JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
"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
オプション 説明
c:\jennifer\jenniferagent\jennifer.jar
c:\jennifer\jenniferagent\lwst.boot.jar
c:\jennifer\jenniferagent\lwst.jdk.jar
34 JENNIFER4.0 インストールガイド
4. 「追加プロパティー」の「カスタム・プロパティー」に下記の値を新規作成します。
5. 該当のオプション値を保存します。
3.2.4. WebSphere の再起動及び確認事項
3.2.4.1. ライセンスキーの登録
WebSphereを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
-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
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。ただ、WebSphereが開始するときに登録されるようにするにはエージェント設定ファイルに
agent_boot_classオプションを活性化させます。
---------------------------------------
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情報などが正常に表示されるか確認します。.
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を再起動します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。.
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.2. 事前イ ンス ト ール(Pre-Installation) 作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。 WebLogic は“2”番を選択します。
JENNIFERエージェントディレクト
リ
/home/jennifer/agent
Javaホームディレクトリ /was/bea/jdk150_11
JENNIFERサーバIP Address 192.168.0.139
表 4-1: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
########################################################
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) ===>> 2
38 JENNIFER4.0 インストールガイド
2. WebLogicのホームディレクトリを指定します。 WebLogicの場合 jennifer.jarファイルをファイルを
特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパスに設定する方法を提供します。
3. WebLogicが使用するJAVA HOMEディレクトリを指定します。 WebLogicが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.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
########################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 4-2: 設定時に必要なオプシ ョ ン
########################################################
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
オプション 説明
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. 最後に設定された内容を確認します。
4.1.3. ポス ト イ ンス ト ール(Post-Installation) 作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをWebLogic Javaオプションに設定する作業をします。
• WebLogic Javaオプション設定
1. WebLogicの環境設定ファイルは基本的には$DOMAIN_HOME/bin/startWebLogic.shファイルで
す。
2. WebLogicの環境設定ファイルの「CLASSPATH」の先頭に「 jennifer.jar」ファイルのパスを追加
します。
3. WebLogicの環境設定ファイルの「JAVA_OPTIONS」に下記の項目を追加します。
4. 該当のオプション値を保存して、WebLogicを再起動します。
[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 : /was/bea/jdk150_11/jre/lib/i386/
server/libjennifer20.so(sl)
CLASSPATH=/home/jennifer/agent/jennifer.jar :"${CLASSPATH}${CLASSPATHSEP}
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バージョン以下は該当のオプションを設定しません。.
42 JENNIFER4.0 インストールガイド
4.1.4. イ ンス ト ールの確認
4.1.4.1. ライセンスキーの登録
WebLogicを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
4.1.4.2. モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
---------------------------------------
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.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
4. イ ンス ト ールガイ ド (WebLogic 用) 43
4.1.5. JENNIFERエージ ェ ン ト 構成削除
1. WebLogicを停止します。
2. WebLogicの$DOMAIN_HOME/bin/startWebLogic.shファイルでJENNIFERエージェント関連設
定値を削除します。
3. JENNIFERネイティブライブラリファイルを削除します。
4. WebLogicを再起動します。
4.2. Windows 環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
4.2.1. WebLogic イ ンス ト ール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをWebLogicが運用中である
サーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明させています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行ってください。
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}
表 4-3: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
WebLogic ホームディレクトリ c:\JavaApplicationServer\weblogic
JENNIFERエージェントディレクトリ c:\jennifer\jenniferagent
Javaホームディレクトリ C:\Java\jdk16u13
JENNIFERサーバIP Address 192.168.0.139
44 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ファイルをファイルを
特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパスに設定する方法を提供します。
3. WebLogicが使用するJAVA HOMEディレクトリを指定します。 WebLogicが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.jarファイルを生成する作業をします。
4. JENNIFERエージェントは、システムのCPUやメモリ情報を収集するためにネイティブライブラ
リを設定する必要があります。システムでのメモリが2GBを超過する場合は“y”、 2GB以下の場合
は“n”を選択します。
###################################################
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"
###################################################
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"
###################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 4-4: 設定時に必要なオプシ ョ ン
###################################################
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]
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
4. イ ンス ト ールガイ ド (WebLogic 用) 47
6. 最後に設定された内容を確認します。.
4.2.3. ポス ト イ ンス ト ール(Post-Installation) 作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをWebLogic Javaオプションに設定する作業をします。
• WebLogic Javaオプション設定
1. WebLogicの環境設定ファイルは基本的には%WEBLOGIC_HOME%\bin\startWebLogic.cmdファイルです。
2. WebLogicの環境設定ファイルの「CLASSPATH」の先頭に「 jennifer.jar」ファイルのパスを追加
します。
license_filename ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを指
定します。
agent_tcp_port JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
"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
オプション 説明
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」に下記の項目を追加します。
4. 該当のオプション値を保存して、WebLogicを再起動します。
4.2.4. イ ンス ト ールの確認
4.2.4.1. ライセンスキーの登録
WebLogicを再起動してENNIFERエージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
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バージョン以下は該当のオプションを設定しません。.
---------------------------------------
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”というメッセージではない場合は、
インストールガイドのトラブルシューティングの部分をご参照ください。
4. イ ンス ト ールガイ ド (WebLogic 用) 49
4.2.4.2. モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
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を再起動します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。.
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.2. 事前イ ンス ト ール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Tomcat4.x / Tomcat5.xは“5”番を選択します。
JENNIFERエージェントディレクトリ /home/jennifer/agent
Javaホームディレクトリ /jdk/sun/java15
JENNIFERサーバIP Address 192.168.0.139
表 5-1: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
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を押し
ます。
3. Tomcatが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ
ルが生成されます。/jdk/sun/java15と入力して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ファイルがコピーされます。
########################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 5-2: 設定時に必要なオプション
########################################################
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
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
license_filename ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを
指定します。
agent_tcp_port JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
56 JENNIFER4.0 インストールガイド
6. 最後に設定された内容を確認します。
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がない場合は追加で記述しま
す。
[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 : /jdk/sun/java15/jre/lib/i386/
server/libjennifer20.so(sl)
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エージェントを動作させ、下記の内容確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
5.1.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Tomcatが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
---------------------------------------
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.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
58 JENNIFER4.0 インストールガイド
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
5.1.5. JENNIFERエージ ェ ン ト 構成削除
1. Tomcatを中止します。
2. /was/tomcat5/common/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が運用中のサーバの
ディレクトリにコピーします。
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザサーバの環境情報に合わせてインストール作業を行ってください。
Notice: Tomcat6の場合、/was/tomcat6/libディレクトリのjennifer.jarを削除します。
表 5-3: JENNIFER エージェント構成例説明のための環境
区分 説明
Tomcatホームディレクトリ c\JavaApplicationServer\tomcat4
JENNIFERエージェントホームディレクトリ c:\jennifer\jenniferagent
Javaホームディレクトリ C:\Java\jdk16u13
5. イ ンス ト ールガイ ド (Tomcat 用) 59
5.2.2. 事前イ ンス ト ール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Tomcat4.x / Tomcat 5.x は“5”番を選択します。
JENNIFER サーバIP Address 192.168.0.139
表 5-3: JENNIFER エージェント構成例説明のための環境
区分 説明
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を入力します。
3. Tomcatが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ
ルが生成されます。c:\Java\jdk16u13と入力して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ファイルがコピーされます。
###################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 5-4: オプション紹介
###################################################
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]
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
5. イ ンス ト ールガイ ド (Tomcat 用) 63
6. 最後に設定された情報を確認します。
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がない場合、追加で記述しま
す。
license_filename ライセンスキーを保存するライセンスファイルパスを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
"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
オプション 説明
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エージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
5.2.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。 Tomcatが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
---------------------------------------
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.” というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
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を削除します。
4. JENNIFERネイティブライブラリを削除します。(%JAVA_HOME%\bin\jennifer20.dll - C:\Java\jdk16u13\bin\jennifer20.dll)
5. Tomcatを再起動します。
Notice: Tomcat6は%TOMCAT_HOME%\lib\jennifer.jarを削除します。
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.2. 事前イ ンス ト ール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Resinは“7”番を選択します。
JENNIFERエージェントディレクトリ /home/jennifer/agent
Javaホームディレクトリ /jdk/sun/java15
JENNIFERサーバIP Address 192.168.0.139
表 6-1: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
########################################################
######## 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) ===>> 7
68 JENNIFER4.0 インストールガイド
2. Resinのホームディレクトリを指定します。jennifer.jarファイルをResinホームディレクトリの/libディレクトリへコピーする作業が行われます。/was/resin315と入力してEnterを押します。
3. Resinが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイル
が生成されます。/jdk/sun/java15と入力して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
########################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 6-2: 設定時に必要なオプション
########################################################
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
オプション 説明
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. 最後に設定された内容を確認します。
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の設定ファイルに下記のように事前作業を通じて作られたライブラリ及びエージェント構成
ファイルの設定作業をします。
6.1.3.2. Resin 2.x/3.0.xのJavaオプション設定
1. 該当バージョンは${RESIN_HOME}/bin/httpd.shファイルに設定を追加します。
[ 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 : /jdk/sun/java15/jre/lib/i386/
server/libjennifer20.so(sl)
<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未満は該当オプションを設定しません。
72 JENNIFER4.0 インストールガイド
2. 実行スクリプトに下記のように事前作業を通じて作られたライブラリ及びエージェント構成ファ
イルの設定作業をします。
6.1.4. イ ンス ト ール確認作業
6.1.4.1. ライセンスキー登録
Resinを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることえを確認します。
-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未満は該当オプションを設定しません。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Resinが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプショ
ンを活性化させます。
---------------------------------------
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情報などが正常に表示されるか確認します。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
6.1.5. JENNIFERエージ ェ ン ト 構成削除
1. Resinを中止します。
2. ${RESIN_HOME}/libディレクトリのjennifer.jarを削除します。
3. ${RESIN_HOME}/conf/resin.confファイルで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エー
ジェントがインストールされたサーバの環境情報を表示します。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
Notice: Resin 2.1.x、3.0.xの場合は、起動スクリプトに設定したJENNIFERエージェント関連オプションを削
除します。
74 JENNIFER4.0 インストールガイド
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをResinが運用中のサーバの
ディレクトリにコピーします。
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザサーバの環境情報に合わせてインストール作業を行ってください。
6.2.2. 事前イ ンス ト ール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
表 6-3: JENNIFER エージェント構成例説明のための環境
区分 説明
Resinホームディレクトリ c\JavaApplicationServer\resin3
JENNIFERエージェントホームディレクトリ c:\jennifer\jenniferagent
Javaホームディレクトリ c:\Java\jdk16u13
JENNIFER サーバIP Address 192.168.0.139
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を入力します。
3. Resinが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイル
が生成されます。c:\Java\jdk16u13と入力してEnterを入力します。
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
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"
###################################################
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"
###################################################
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ファイルを環境に合わせて修正
したあとで使用することが可能です。
表 6-4: オプション紹介
###################################################
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]
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
78 JENNIFER4.0 インストールガイド
6. 最後に設定された情報を確認します。
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エージェントの構成設定を記述し
ます。
license_filename ライセンスキーを保存するライセンスファイルパスを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
"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
オプション 説明
<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の設定ファイルに下記のように事前作業を通じて作られたライブラリ及びエージェント構成
ファイルの設定作業をします。
6.2.3.3. Resin 2.x/3.0.xのJavaオプション設定
1. Resinの起動コマンドに「-J」オプションに付けてJENNIFERエージェントの構成設定を入力して
Resinを起動します。
2. Resinの起動コマンドは基本的に%RESIN_HOME%\httpd.exeです。
6.2.4. イ ンス ト ール確認作業
6.2.4.1. ライセンスキー登録
Resinを再起動して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未満は該当オプションを設定しません。
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未満は該当オプションを設定しません。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。 Resinが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプショ
ンを活性化させます。
80 JENNIFER4.0 インストールガイド
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
6.2.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
6.2.5. JENNIFERエージ ェ ン ト 構成削除
1. Resinを中止します。
2. %RESIN_HOME%\lib(C:\JavaApplicationServer\resin3\lib)ディレクトリからjennifer.jarファ
イルを削除します。
---------------------------------------
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.” というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
6. イ ンス ト ールガイ ド (Resin 用) 81
3. %RESIN_HOME%\confディレクトリ(C:\JavaApplicationServer\resin3\conf)のresin.conf(resin.xml)ファイルでJENNIFERエージェントの設定をを削除します。
4. JENNIFERネイティブライブラリを削除します。(%JAVA_HOME%\bin\jennifer20.dll)
5. Resinを再起動します。
Notice: Resin 2.x/3.0.xの場合は、起動コマンドの実行時の追加オプションを削除します。
82 JENNIFER4.0 インストールガイド
7イ ンス ト ールガイ ド (JBoss用)
7.1. UNIX環境
JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス
トール(post-installation)そして、インストール確認作業で構成されています。
7.1.1. JBossイ ンス ト ール環境
下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー
ジェントがインストールされたサーバの環境情報を表示します。
JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをJBossが運用中であるサー
バのディレクトリへコピーします。
85
本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行う必要があります。
7.1.2. 事前イ ンス ト ール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
JBoss3.xは“8”番を選択します。
表 7-1: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
JBossホームディレクトリ /was/jboss3
/was/jboss4
JENNIFERエージェントディレクトリ /home/jennifer/agent
Javaホームディレクトリ /jdk/sun/java15
JENNIFERサーバIP Address 192.168.0.139
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を入力します。
3. JBossが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイル
が生成されます。/jdk/sun/java15と入力して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ディレクトリにコピーします。
########################################################
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ファイルを環境に合わせ
て修正後、使用することが可能です。
表 7-2: 設定時に必要なオプション
########################################################
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
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
license_filename ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを
指定します。
agent_tcp_port JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
90 JENNIFER4.0 インストールガイド
6. 最後に設定された内容を確認します。
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オプションに下記のように事前作業を通じて作られたライブ
ラリ及びエージェント構成ファイルの設定作業をします。
[ 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 : /jdk/sun/java15/jre/lib/i386/
server/libjennifer20.so(sl)
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エージェントを動作させ、下記の内容確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
7.1.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。JBossが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
---------------------------------------
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.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
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を削
除します。
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が運用中のサーバの
ディレクトリにコピーします。
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザサーバの環境情報に合わせてインストール作業を行う必要があります。
Notice: JBoss4.xの場合は、${JBOSS_HOME}/server/default/libディレクトリのjennifer.jarファイルを削除し
ます。
表 7-3: JENNIFER エージェント構成例説明のための環境
区分 説明
JBossホームディレクトリ c\JavaApplicationServer\jboss3
JENNIFERエージェントホームディレクトリ c:\jennifer\jenniferagent
7. イ ンス ト ールガイ ド (JBoss 用) 93
7.2.2. 事前イ ンス ト ール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
JBossは“8”番を選択します。
Javaホームディレクトリ c:\Java\jdk16u13
JENNIFER サーバIP Address 192.168.0.139
表 7-3: JENNIFER エージェント構成例説明のための環境
区分 説明
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を入力します。
3. JBossが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイル
が生成されます。c:\Java\jdk16u13と入力してEnterを入力します。
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
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"
###################################################
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"
###################################################
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ファイルを環境に合わせて修正
したあとで使用することが可能です。
表 7-4: オプション紹介
###################################################
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]
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
7. イ ンス ト ールガイ ド (JBoss 用) 97
6. 最後に設定された情報を確認します。
7.2.3. ポス ト イ ンス ト ール(Post-Installation)作業
ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをJBossのJavaオプションに設定する作業をします。
1. JBossの設定ファイルは基本的には、%JBOSS_HOME%\bin\run.batです。例では
c:\JavaApplicationServer\jboss3\bin\run.batです。
2. JBossの設定ファイルのJAVA_OPTSに下記のように事前作業を通じて作られたライブラリ及び
エージェント構成ファイルの設定作業をします。
license_filename ライセンスキーを保存するライセンスファイルパスを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
"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
オプション 説明
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エージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
7.2.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。 JBossが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプショ
ンを活性化させます。
---------------------------------------
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.” というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
7. イ ンス ト ールガイ ド (JBoss 用) 99
7.2.5. JENNIFERエージ ェ ン ト 構成削除
1. JBossを中止します。
2. %JBOSS_HOME%\server\default\deploy\jbossweb-tomcat50.sarディレクトリからjennifer.jarファイルを削除します。
3. %JBOSS_HOME%\bin\run.batファイルでJENNIFERエージェントの設定をを削除します。
4. JENNIFERネイティブライブラリを削除します。(%JAVA_HOME%\bin\jennifer20.dll)
5. JBossを再起動します。
Notice: JBoss4.xの場合は、%JBOSS_HOME%\server\default\libディレクトリから削除します。
100 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.2. 事前イ ンス ト ール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Oracle ASは“4”番を選択します。
JENNIFERエージェントディレクトリ /home/jennifer/agent
Javaホームディレクトリ /was/OracleAS/jdk
JENNIFERサーバIP Address 192.168.0.139
表 8-1: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
########################################################
######## 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) ===>> 4
104 JENNIFER4.0 インストールガイド
2. Oracle ASのホームディレクトリを指定します。jennifer.jarファイルをOracle ASホームディレク
トリの/j2ee/home/lib/api-extディレクトリへコピーする作業が行われます。/was/OracleASと入力
してEnterを入力します。
3. Oracle ASが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファ
イルが生成されます。/was/OracleAS/jdkと入力して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
########################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 8-2: 設定時に必要なオプション
########################################################
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
オプション 説明
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. 最後に設定された内容を確認します。
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の設定ファイルに下記のように事前作業を通じて作られたライブラリ及びエージェント
構成ファイルの設定作業をします。
[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 : /was/OracleAS/jdk/jre/lib/i386/server/libjennifer20.so(sl)
<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エージェントを動作させ、下記の内容確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
8.1.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Oracle ASが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
---------------------------------------
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.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
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 エージェント構成例説明のための環境
区分 説明
Oracle ASホームディレクトリ c\JavaApplicationServer\oraas
JENNIFERエージェントホームディレクトリ c:\jennifer\jenniferagent
Javaホームディレクトリ c:\JavaApplicationServer\oraas\jdk
JENNIFER サーバIP Address 192.168.0.139
110 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を入力します。
3. Oracle ASが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファ
イルが生成されます。c:\JavaApplicationServer\oraas\jdkと入力してEnterを入力します。
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
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"
###################################################
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"
###################################################
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ファイルを環境に合わせて修正
したあとで使用することが可能です。
表 8-4: オプション紹介
###################################################
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]
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
8. イ ンス ト ールガイ ド (Oracle AS 用) 113
6. 最後に設定された情報を確認します。
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の設定ファイルに下記のように事前作業を通じて作られたライブラリ及びエージェント
構成ファイルの設定作業をします。
license_filename ライセンスキーを保存するライセンスファイルパスを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
"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
オプション 説明
<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エージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
8.2.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。 Oracle ASが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
---------------------------------------
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.” というメッセージがない場合、
インストールガイドのトラブルシューティング部分をご参照ください。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
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 インストールガイド
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.2. 事前イ ンス ト ール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
GlassFishは“11”番を選択します。
JENNIFERエージェントディレクトリ /home/jennifer/agent
Javaホームディレクトリ /jdk/sun/java15
JENNIFERサーバIP Address 192.168.0.139
表 9-1: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
########################################################
######## 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) ===>> 11
120 JENNIFER4.0 インストールガイド
2. GlassFishのホームディレクトリを指定します。jennifer.jarファイルをGlassFishホームディレク
トリのlibディレクトリへコピーする作業が行われます。/was/glassfishと入力してEnterを押しま
す。
3. GlassFishが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファ
イルが生成されます。/jdk/sun/java15と入力して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
########################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 9-2: 設定時に必要なオプション
########################################################
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
オプション 説明
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. 最後に設定された内容を確認します。
9.1.3. ポス ト イ ンス ト ール(Post-Installation)作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをGlassFish Javaオプションに設定する作業をします。
• GlassFish Javaオプション設定
1. GlassFishの管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メニューを選択します。
2. 管理コンソールで下記のような設定を追加後、設定を保存します。
[ 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 : /was/glassfish/lib/
libjennifer20.so(sl)
-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エージェントを動作させ、下記の内容確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
9.1.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。GlassFishが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
---------------------------------------
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.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
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 エージェント構成例説明のための環境
区分 説明
GlassFishホームディレクトリ c\JavaApplicationServer\glassfish
JENNIFERエージェントホームディレクトリ c:\jennifer\jenniferagent
Javaホームディレクトリ C:\Java\jdk16u13
JENNIFER サーバIP Address 192.168.0.139
126 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を押します。
3. GlassFishが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファ
イルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
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"
###################################################
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"
###################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 9-4: オプション紹介
###################################################
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]
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
9. イ ンス ト ールガイ ド (GLASSFISH 用) 129
6. 最後に設定された情報を確認します。
9.2.3. ポス ト イ ンス ト ール(Post-Installation)作業
ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをGlassFish Javaオプションに設定する作業をします。
1. GlassFishの管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メニューを選択します。
2. 管理コンソールで下記のような設定を追加後、設定を保存します。
license_filename ライセンスキーを保存するライセンスファイルパスを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
"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
オプション 説明
-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エージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
9.2.4.2. モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されているか確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。 GlassFishが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
---------------------------------------
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.” というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
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 インストールガイド
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.2.事前イ ンス ト ール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Sun ASは“10”番を選択します。
JENNIFERエージェントディレクトリ /home/jennifer/agent
Javaホームディレクトリ /jdk/sun/java15
JENNIFERサーバIP Address 192.168.0.139
表 10-1: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
########################################################
######## 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) ===>> 10
136 JENNIFER4.0 インストールガイド
2. Sun ASのホームディレクトリを指定します。jennifer.jarファイルをSun ASホームディレクトリ
のlibディレクトリへコピーする作業が行われます。/was/SUNWappserverと入力してEnterを押し
ます。
3. Sun ASが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ
ルが生成されます。/jdk/sun/java15と入力して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
########################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 10-2: 設定時に必要なオプション
########################################################
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
オプション 説明
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. 最後に設定された内容を確認します。
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. 管理コンソールで下記のような設定を追加後、設定を保存します。
• SUN AS 7のJavaオプション設定
1. Javaオプションの設定ファイルは基本的に${SUNAS_HOME}/domains/domain1/server1/config/serverxmlです。
[ 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 : /was/SUNWappserver9/lib/
libjennifer20.so(sl)
-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未満は該当オプションを設定しません。
140 JENNIFER4.0 インストールガイド
2. 設定ファイルに下記のJENNIFERエージェント設定を追加します。
10.1.4.イ ンス ト ール確認作業
10.1.4.1.ライセンスキー登録
Sun ASを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。
1. 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未満は該当オプションを設定しません。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Sun ASが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
---------------------------------------
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情報などが正常に表示されるか確認します。
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が運用中のサーバ
のディレクトリにコピーします。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
142 JENNIFER4.0 インストールガイド
本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザサーバの環境情報に合わせてインストール作業を行ってください。
10.2.2.事前イ ンス ト ール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
表 10-3: JENNIFER エージェント構成例説明のための環境
区分 説明
Sun ASホームディレクトリ c\JavaApplicationServer\sunas8
JENNIFERエージェントホームディレクトリ c:\jennifer\jenniferagent
Javaホームディレクトリ C:\Java\jdk16u13
JENNIFER サーバIP Address 192.168.0.139
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を押します。
3. Sun ASが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ
ルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
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"
###################################################
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"
###################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 10-4: オプション紹介
###################################################
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]
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
146 JENNIFER4.0 インストールガイド
6. 最後に設定された情報を確認します。
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. 管理コンソールで下記のような設定を追加後、設定を保存します。
• Sun AS 7のJavaオプション設定
license_filename ライセンスキーを保存するライセンスファイルパスを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
"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
オプション 説明
-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未満は該当オプションを設定しません。
10. イ ンス ト ールガイ ド (Sun AS 用) 147
1. Javaオプションの設定ファイルは基本的に
${SUNAS_HOME}\domains\domain1\server1\config\serverxmlです。
2. 設定ファイルに下記のJENNIFERエージェント設定を追加します。
10.2.4.イ ンス ト ール確認作業
10.2.4.1.ライセンスキー登録
Sun ASを再起動して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未満は該当オプションを設定しません。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。 Sun ASが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
148 JENNIFER4.0 インストールガイド
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
10.2.4.2.モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
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)を削除します。
---------------------------------------
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.” というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
10. イ ンス ト ールガイ ド (Sun AS 用) 149
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.2.事前イ ンス ト ール(Pre-Installation)作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
JENNIFERエージェントディレクトリ /home/jennifer/agent
Javaホームディレクトリ /opt/Interstage/FJSVawjbk/jdk5
JENNIFERサーバIP Address 192.168.0.139
表 11-1: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
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を押します。
3. Interstageが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイルが生成されます。/jdk/sun/java15と入力して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
########################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 11-2: 設定時に必要なオプション
########################################################
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
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
license_filename ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを
指定します。
agent_tcp_port JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
156 JENNIFER4.0 インストールガイド
6. 最後に設定された内容を確認します。
11.1.3.ポス ト イ ンス ト ール(Post-Installation)作業
ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをInterstage Javaオプションに設定する作業をします。
• jennifer.jarファイルのコピー
JENNIFERの「jennifer.jar」ファイルをInterstageにコピーします。コピー先は[Interstageホーム
ディレクトリ/J2EEホームディレクトリ/var/deployment/ijserver/APサーバ名/ext]です。
• Interstage 8.x/9.xのJavaオプション設定
1. Interstageの管理コンソールの[Interstage Application Server|System|WorkUnit|サービス名
|Settings|WorkUnit Settings|Java VM Options]メニューを選択します。
2. 管理コンソールで下記のような設定を追加後、設定を保存します。
[ 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 : /opt/Interstage/FJSVawjbk/jdk5/
jre/lib/i386/server/libjennifer20.so(sl)
cp /home/jennifer/agent/jennifer.jar /opt/Interstage/FJSVj2ee/var/deployment/
ijserver/IJServer/ext/
-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エージェントを動作させ、下記の内容確認します。
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
11.1.4.2.モニタリングデータ確認
1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。Interstageが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプションを活性化させます。
---------------------------------------
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.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
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.2.2.事前イ ンス ト ール作業(Pre-installation)作業
JENNIFERエージェントディレクトリでpreinstall.batを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。
Interstageは“13”番を選択します。
JENNIFER サーバIP Address 192.168.0.139
表 11-3: JENNIFER エージェント構成例説明のための環境
区分 説明
###################################################
######### 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を押します。
3. Interstageが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。
4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ
のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば
“n”を選択します。
###################################################
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
###################################################
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"
###################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 11-4: オプション紹介
###################################################
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]
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
162 JENNIFER4.0 インストールガイド
6. 最後に設定された情報を確認します。
11.2.3.ポス ト イ ンス ト ール(Post-Installation)作業
ポストインストール作業では「jennifer.jar」ファイルのコピーと事前インストール作業によって作
成されたライブラリ及びエージェント構成ファイルパスをInterstage Javaオプションに設定する作業
をします。
• jennifer.jarファイルのコピー
JENNIFERの「jennifer.jar」ファイルをInterstageにコピーします。コピー先は[Interstageホーム
ディレクトリ/J2EEホームディレクトリ/var/deployment/ijserver/APサーバ名/ext]です。
• Interstage 8.x/9.xのJavaオプション設定
1. Interstageの管理コンソールの[Interstage Application Server|System|WorkUnit|サービス名
|Settings|WorkUnit Settings|Java VM Options]メニューを選択します。
license_filename ライセンスキーを保存するライセンスファイルパスを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
"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
オプション 説明
cp C:\jennifer\agent\jennifer.jar
c:\Interstage\J2EE\var\deployment\ijserver\IJServer\ext\
11. イ ンス ト ールガイ ド (Interstage 用) 163
2. 管理コンソールで下記のような設定を追加後、設定を保存します。
11.2.4.イ ンス ト ール確認作業
11.2.4.1.ライセンスキー登録
Interstageを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ
グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。
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未満は該当オ
プションを設定しません。
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。 Interstageが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ
ションを活性化させます。
---------------------------------------
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.” というメッセージがない場合、イ
ンストールガイドのトラブルシューティング部分をご参照ください。
164 JENNIFER4.0 インストールガイド
11.2.4.2.モニタリングデータ確認
1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
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を再起動します。
Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご
参照ください。
11. イ ンス ト ールガイ ド (Interstage 用) 165
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.2.事前イ ンス ト ール(Pre-Installation) 作業
JENNIFERエージェントディレクトリでpreinstall.shを実行します。
1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。 Cosminexus は“12”番を選択します。
JENNIFERエージェントディレクトリ /home/jennifer/agent
Javaホームディレクトリ /opt/Hitachi/Cosminexus/jdk
JENNIFERサーバIP Address 192.168.0.139
表 12-1: JENNIFER エージェント構成例(説明のための環境)
区分 ディレクトリ
########################################################
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) ===>> 12
170 JENNIFER4.0 インストールガイド
2. Cosminexusのホームディレクトリを指定します。 Cosminexusの場合 jennifer.jarファイルを
Cosminexusの「hitj2ee.jar」ファイルにアップロードします。このステップではクラスパスに設
定する方法を提供します。
3. Cosminexusが使用するJAVA HOMEディレクトリを指定します。 Cosminexusが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.jarファイルを生成する作業をします。一般的な場合は Cosminexusから提供する jdkを使用します。
########################################################
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
########################################################
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ファイルを環境に合わせて修正後、使用
することが可能です。
表 12-2: 設定時に必要なオプション
########################################################
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
オプション 説明
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. 最後に設定された内容を確認します。
12.1.3.ポス ト イ ンス ト ール(Post-Installation) 作業
ポストインストール作業では、JENNIFERの核心モジュール「jennifer.jar」ファイルをCosmin-exusの「hitj2ee.jar」 ファイルにアップロードします。また、事前インストール作業によって作成され
たライブラリ及びエージェント構成ファイルパスをCosminexus JVMオプションに設定する作業をし
ます。
• jennifer.jarファイルのアップロード
Cosminexusの「hitj2ee.jar」ファイルにjennifer.jarファイルのorg、javax、comパッケージをアッ
プデートします。
1. /opt/Hitachi/Cosminexus/CC/lib/hitj2ee.jarファイルをバックアップします。
2. 任意のフォルダでjennifer.jarファイルの三つのパッケージ(com, org, javax)を抽出します。
3. hitj2ee.jarファイルに抽出したパッケージをアップデートします。
[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 : /opt/Hitachi/Cosminexus/jdk/bin/
libjennifer20.so(sl)
cp /opt/Hitachi/Cosminexus/CC/lib/hitj2ee.jar /opt/Hitachi/Cosminexus/CC/lib/hitj2ee.jar.backup
/]# cd /tmp
tmp]# jar –xvf /home/jennifer/agent/jennifer.jar com org javax
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. 「拡張起動パラメタ」に下記の値を各々 入力します。
3. Cosminexusが使っているJDKのバージョンが1.5以上の場合、下記の値も「拡張起動パラメタ」
に 入力します。
4. 適用ボタンをクリックしてパラメタを適用します。
5. 「設定情報の配布」ボタンをクリックして配布します。
12.1.4.Cosminexus の再起動及び確認事項
12.1.4.1.ライセンスキーの登録
Cosminexusを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/
lwst.boot.jar
-Djennifer.config=/home/jennifer/agent/w11.conf
-javaagent:/home/jennifer/agent/lwst.javaagent.jar
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。
12. イ ンス ト ールガイ ド (Cosminexus 用) 175
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
12.1.4.2.モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
12.1.5.JENNIFERエージ ェ ン ト 構成削除
1. バックアップした「hitj2ee.jar.backup」ファイルを修復します。。
---------------------------------------
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.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。
/]#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」設定値を削除し
ます。。
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が運用中であ
るサーバのディレクトリへコピーします。
本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行ってください。
Notice: Cosminexusが使用するJDKのバージョンが1.5以上の場合は「lwst.javaagent.jar」項目も削
除します。
表 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 は“12”番を選択します。
###################################################
######### 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」ファイルにアップロードします。このステップではクラスパスに設
定する方法を提供します。
3. Cosminexusが使用するJAVA HOMEディレクトリを指定します。 Cosminexusが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.jarファイルを生成する作業をします。一般的な場合は Cosminexusから提供する jdkを使用します。
####################################################
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"
#####################################################
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ファイルを環境に合わせ
て修正後、使用することが可能です。
表 12-4: 設定時に必要なオプシ ョ ン
####################################################
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]
オプション 説明
agent_name 必ず3文字のエージェント区切り文字を指定します。
12. イ ンス ト ールガイ ド (Cosminexus 用) 181
6. 最後に設定された内容を確認します。
12.2.3.ポス ト イ ンス ト ール(Post-Installation) 作業
ポストインストール作業では、JENNIFERの核心モジュール「jennifer.jar」ファイルをCosmin-exusの「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ファイルをバックアップします。
license_filename ライセンスキーを保存するライセンスファイルパス及びファイルを指定します。
logfile JENNIFERエージェントログ記録ファイルのパス及びファイルを指定します。
lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを指定し
ます。
agent_tcp_port JENNIFERエージェントでバインディングするポートを指定します。
udp_server_host JENNIFERサーバがインストールされたサーバのIP Addressを指定します。
"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
オプション 説明
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)を抽出します。
3. hitj2ee.jarファイルに抽出したパッケージをアップデートします。
• Cosminexus JVMオプシ ョ ン設定
1. Cosminexus Management Serverのコンソールで[論理サーバの環境設定|論理J2EEサーバ|J2EEサーバ|設定するサーバ選択|JVM]メニューを選択します。
2. 「拡張起動パラメタ」に下記の値を各々 入力します。
3. Cosminexusが使っているJDKのバージョンが1.5以上の場合、下記の値も「拡張起動パラメタ」
に 入力します。
4. 適用ボタンをクリックしてパラメタを適用します。
5. 「設定情報の配布」ボタンをクリックして配布します。
12.2.4.Cosminexus の再起動及び確認事項
12.2.4.1.ライセンスキーの登録
WebSphereを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。
C:\>mkdir tmp C:\>cd tmpC:\tmp> jar –xvf c:\jennifer\jennifer\agent\jennifer.jar com org javax
C:\tmp> jar –uvf C:\Program Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jar com org javax
-Xbootclasspath/
p:c:\jennifer\jennifer\agent\lwst.jdk.jar;c:\jennifer\jennifer\agent\lwst.boot.jar
-Djennifer.config=c:\jennifer\jennifer\agent\w11.conf
-javaagent:c:\jennifer\jennifer\agent\lwst.javaagent.jar
Notice: ユーザの最初のリクエストがあってからJENNIFERエージェントがJENNIFERサーバに登録されま
す。
12. イ ンス ト ールガイ ド (Cosminexus 用) 183
1. JENNIFERエージェントログが指定したファイルに生成されたかどうか確認するために、ログ
ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認しま
す。
2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー
を登録します。
12.2.4.2.モニタリングデータ確認
1. ユーザからのサービスリクエストがある場合、X-Viewに点などが表示されるか確認します。
2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。.
3. [ 障害診断 | ユーティリティ | ローディングクラスリスト]にローディングされたクラスなどが正
常に表示されるか確認します。
12.2.5.JENNIFERエージ ェ ン ト 構成削除。
1. バックアップした「hitj2ee.jar.backup」ファイルを修復します。。
2. Cosminexus Management Serverのコンソールで[論理サーバの環境設定|論理J2EEサーバ|J2EEサーバ|設定するサーバ選択|JVM]メニューを選択します。
---------------------------------------
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.”というメッセージではない場
合は、インストールガイドのトラブルシューティングの部分をご参照ください。
Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参
照ください。.
C:\tmp>cp C:\Program Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jar.backup C:\Program
Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jar
184 JENNIFER4.0 インストールガイド
3. 設定した「拡張起動パラメタ」項目の「lwst.boot.jar, lwst.jdk.jar」、「w11.conf」設定値を削除し
ます。。
4. JENNIFERネイティブライブラリファイル(例の場合、C:\Program
Files\Hitachi\Cosminexus\jdk\bin\jennifer20.dll)を削除します。
5. Cosminexusを再起動します。
Notice: Cosminexusが使用するJDKのバージョンが1.5以上の場合は「lwst.javaagent.jar」項目も削
除します。
12. イ ンス ト ールガイ ド (Cosminexus 用) 185
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ファイルの次の部分でポート番号を設定します。
Windowsの場合には、catalina.batファイルの次の部分でポート番号を設定します。
Javaアプレットはチャート構成に必要なデータをJENNIFERサーバからTCP通信を通じて獲得しま
す。このとき使用されるJENNIFERサーバのデフォルトTCPポート番号はJENNIFERサーバの
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です。
JAVA_HOME="$JAVA_HOME"
if [ -z "${STARTUP_PORT}" ]
then
export STARTUP_PORT="7900"
fi
if [ -z "${SHUTDOWN_PORT}" ]
then
export SHUTDOWN_PORT="7999"
fi
set JAVA_HOME=%JAVA_HOME%
if "%STARTUP_PORT%" == "" SET STARTUP_PORT=7900
if "%SHUTDOWN_PORT%" == "" SET SHUTDOWN_PORT=7999
server_tcp_port = 6701
server_udp_runtime_port = 6901
188 JENNIFER4.0 インストールガイド
JENNIFERエージェントはJENNIFERサーバのserver_udp_listen_portオプションで設定したUDPポートを通じて1秒毎に反復的にサービス要求率、平均応答時間などの性能データを送信します。デ
フォルトポート番号は6902です。
JENNIFERエージェントはJENNIFERサーバのserver_udp_lwst_call_stack_portオプションで設
定したUDPポートを通じて2秒毎に反復的にX-Viewトランザクションプロファイルデータを送信しま
す。デフォルトポート番号は6703です。
JENNIFERエージェントがUDP方式で送った性能データをJENNIFERサーバが受けるとき使用す
るIPバインディングアドレスを指定する必要があります。これはJava TCPソケットプログラミングで
new java.net.DatagramSocket(port, ip)クリエーターの2番目のパラメータIPに該当する値です。
ハードウェアに2つ以上のネットワークカードがある場合、特定ネットワークカードに届いたリクエストのみバインディングするときに設定します。udp_server_host属性を"0.0.0.0"に指定すると全ての
ネットワークカードに届いたパケットを受信することが可能です。
• エージェントTCPコネクションオプション
JENNIFERサーバにJENNIFERエージェントのTCPコネクションのためのTIME OUTオプション
が存在します。下記の設定値がデフォルト値(ms)です。
13.1.3.JENNIFER使用のためのフ ァ イアウォール設定
JENNIFERサーバとJENNIFERエージェントまたはJENNIFERクライアント間にファイアウォー
ルが存在する場合、先に設定したポート番号がファイアウォールを正常に通過するように設定する必要があります。
server_udp_listen_port = 6902
server_udp_lwst_call_stack_port = 6703
Notice: 前に説明したUDPポート番号を修正するときはJENNIFERサーバだけでなくJENNIFERエージェン
トの同一オプションも共に修正する必要があります。
udp_server_host = 0.0.0.0
agent_tcp_io_timeout=5000
agent_tcp_connect_timeout=3000
Notice: ネットワーク連結が遅延する現象が発生すると、JENNIFERサーバでエラーが保存されます。この場
合、オプション値を変える前にまずJENNIFERエージェントのサーバ間のネットワーク環境をチューニングす
ることをおすすめします。
13. 構成変更及び ト ラ ブルシューテ ィ ング 189
• ユーザコンピュータからJENNIFERサーバへHTTP7900ポートとTCP6701ポートを通じてアクセ
スするようにします。
• JENNIFERエージェントからJENNIFERサーバへUDP6901、6902、6703ポートを通じてアクセ
スするようにします。
• JENNIFERサーバからJENNIFERエージェントへTCP7750ポートを通じてアクセスするようにし
ます。
13.2. 1 つのサーバに複数のJENNIFERエージ ェ ン ト
を イ ンス ト ール
JENNIFERエージェントをインストールすると物理的に1つのサーバに複数のインスタンスが存在
する場合が多くあります。このような場合に、JENNIFERエージェントを構成する方法について説明
します。ここでは、同じJENNIFERサーバへ性能データを送信すると仮定します。
同じJavaアプリケーションサーバで動作している複数のインスタスにJENNIFERエージェントをイ
ンストールする場合、基本的に事前インストール作業 (pre-installation)は最初の1回のみ実行します。
2回目からのインストールは既に構成されたエージェント構成ファイル(例、w11.conf)のコピー及び修
正や該当インスタンスへの設定作業になります。
JENNIFERエージェントをインストールして構成されたエージェント構成ファイル(例、w11.conf)を適切なファイル(例、w12.conf)にコピーし、該当ファイルの内容の中で下記のオプション部分を変更
します。
エージェントをインストールするJavaアプリケーションサーバのJavaオプションに変更されたエー
ジェント構成ファイルのパスとライブラリを設定します。
Reference: UDPネットワークに対するファイアウォールテストについてマニュアル(ネットワークテスト)
をご参照ください。
表 13-5: 必ず変更する必要があるオプション
オプション 説明
agent_name JENNIFERサーバで認識するIDで、JENNIFERサーバ内で唯一でなければなりません。
agent_tcp_port JENNIFERサーバからのTCPリクエストを受け取るJENNIFERエージェントのポート
logfile JENNIFERエージェントのログファイル
lwst_logfile JENNIFERエージェントのLWSTと関連したログファイル
190 JENNIFER4.0 インストールガイド
13.3. イ ンス ト ールの ト ラ ブルシューテ ィ ング
この節ではJENNIFERエージェントインストール作業の中で生じる可能性のある問題とその対応策
を記述します。
13.3.1.エージ ェ ン ト イ ンス ト ール後にWebアプ リ ケーシ ョ ンサーバが稼
働し ない場合
1. JENNIFERエージェントの設定をWebアプリケーションサーバに記述する際にミスタイピングが
なく正確に記述されているか確認します。
2. ミスタイピングがなく、JENNIFERエージェントの設定が正常であるのに起動しない場合はlwstの生成に誤りがある可能性が高いです。この場合、lwst40.sh(bat)コマンドでlwstファイルを再生
成します。
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アプリケーションサーバで提供する文書などを参考にします。
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. 構成変更及び ト ラ ブルシューテ ィ ング 191
4. JENNIFERエージェントとサーバ間のファイアウォールのようなネットワークの制約により通信
が正常に成立しない場合があります。 TCPの場合は、telnetプログラムで確認が可能です。UDPの場合は、JENNIFERエージェントで提供するudptest.sh(bat)ユーティリティを実行して
JENNIFERサーバのログに下記のようなメッセージが出力されるか確認します。
5. 4)をテストするときパラメータ値が小さい場合は成功しますが、パラメータ値が大きい場合には失
敗することがあります。これはシステム或いはネットワークサイドでパケットのサイズを制限している場合です。JENNIFERエージェントでも1回に送信することが可能なパケットのサイズを
指定できるオプションがあります。 xview_profile_udp_packet_size値を減らしながら正常な通信が
できるか確認します。
13.3.3.Invalid LicenseKeyメ ッ セージが出力される場合
JENNIFERエージェントディレクトリでipcheck.sh(bat)ユーティリティを実行した結果のIPアドレ
スにライセンスが発行されているか確認します。
13.3.4.License Keyを登録できない場合
1. ライセンスファイルに書き込み権限があるか確認します。
2. JENNIFERサーバでJENNIFERエージェントのTCPコネクションが可能かどうか確認します。 (デフォルトは7750で、JENNIFERエージェントオプションはagent_tcp_portオプションに登録され
たポートです。)
13.3.5.CPU/メ モ リ情報が表示されない場合
JENNIFERエージェントのlibjennifer20.so(sl)-Windowsの場合、jennifer20.dll-ファイルは、シス
テムやJavaプロセスのCPU使用率及びメモリ使用量を表示します。 該当ライブラリがインストールさ
れていないと、システム/メモリに関連する性能データを収集することができません。しかし、
JENNIFERエージェントの動作には問題がありません。
Notice: RECV(6703) from=127.0.0.1 data=100 bytes
Notice: JENNIFERライセンスキーはJENNIFERエージェントのIPアドレスを基盤に発行されます。
Notice: Unix/Linuxでipcheck.sh(bat)実行結果が127.0.0.1の場合、/etc/hostsファイルにホスト名とIPアドレス
をマッピングさせなければなりません。
Notice: JENNIFERエージェントでagent_tcp_portオプションに登録されたポートが連結されない場合、構成
管理メニューとリアルタイムアクティブサービスリスト画面などでメニューが正常に表示されません。
192 JENNIFER4.0 インストールガイド
1. JENNIFERネイティブライブラリが正常にローディングされなければ、 JENNIFER エージェント
ログファイルに下記のようなメッセージが表示されます。この場合、JENNIFERクライアント画
面の[ 障害診断 | ユーティリティ | システム環境変数 ]メニューで該当エージェントを選択して、
java.library.pathの値を確認します。libjennifer20.so(sl)-Windowsの場合、該当ディレクトリ内に
jennifer20.dll-ファイルがコピーされているか確認します。
2. JENNIFERエージェントのjni/[OS]ディレクトリでJENNIFERネイティブライブラリをテストす
ることが可能です。libjennifer20.so(sl)-Windowsの場合、ファイル名をjennifer20.dll-に変更して
からtest.shを実行させて下記のようなメッセージが表示されるか確認します。
13.3.6.X-Viewに点が表示されない場合
JENNIFERエージェントがサーバに登録されていて、JENNIFERサーバとエージェントのネット
ワークにも問題がないのにX-Viewに点が表示されない場合は下記の内容を確認します。
1. フレームワークの中でstruts2を使用しているか確認します。struts2を使用している場合、
JENNIFERエージェント設定ファイルに下記のように登録します。
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コネクション追跡設定方法を提供します。
libjennifer20.so(sl) shared library loaded failed: java.lang.UnsatisfiedLinkError: no jennifer20 in java.library.path
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実行フ ァ イルでなければな り ません。
http_service_class =org.apache.struts2.dispatcher.FilterDispatcher
http_service_method=doFilter.
13. 構成変更及び ト ラ ブルシューテ ィ ング 193
JNDIとjavax.sql.DataSourceで追跡するケースをタイプ1とし、JENNIFERエージェントに特別な
設定なしで運用することが可能です。
アプリケーションでjava.sql.DriverManagerクラスを通じてjava.sql.Connectionオブジェクトを獲
得するケースをタイプ2とします。
アプリケーションがコネクションプールの役割をする任意のクラスを通じてjava.sql.Connectionオブジェクトを獲得するケースをタイプ3とします。
JDBCコネクション設定タイプ2で、アプリケーションのソースコードにconn = DriverManager.getConnection("jdbc:apache:commons:dbcp:/poolname"); のように使用する場合、
エージェントの設定ファイルに下記のように設定する必要があります。
JDBCコネクション設定タイプ3の場合、java.sql.Connectionを解放するメソッドを下記のように設
定しなければなりません。
• タイプ3で設定時の留意事項
1. パッケージ名を含むクラス名を使用しなければなりません。但し、メソッドのパラメータはパッケージ名を除いたクラス名のみを使用することが可能です。
2. jdbc_connection_getまたはjdbc_connection_justgetオプションで設定したメソッドの解放値は
java.sql.Connectionタイプでなければなりません。
3. jdbc_connection_closeオプションで設定したメソッドのパラメータの中で必ず1つは
java.sql.Connectionタイプでなければなりません。但し、パラメータ位置は関係ありません。
4. 全てのオプションにセミコロン[;]を区切りとして2つ以上の値を設定することが可能です。
• フレームワーク別JDBC設定方法
[Hibernate使用時
Notice: SQL/JDBCに対する情報はServlet/JSP ThreadからのJDBCリクエストのみ抽出されます。Non Servlet/JSP Threadで発生するJDBC/SQL情報を抽出するには明示的に
enable_non_servlet_thread_jdbc_trace = trueを設定します。
user_defined_jdbc_connectionpool_prefixes=jdbc:apache:commons:dbcp
jdbc_connection_get=db.DBConnectionManager.getConnection(String)
Notice: 該当設定を適用するにはJavaアプリケーションサーバ(インスタンス)を再起動する必要があります。
jdbc_connection_justget = org.hibernate.jdbc.ConnectionManager.getConnection()
194 JENNIFER4.0 インストールガイド
[iBatis使用時
[Apache DBCP使用時
• アプリケーション内で使用する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実行オプションに次のオプションを追加します。
jdbc_connection_get=com.ibatis.sqlmap.engine.transaction.jdbcJdbcTransaction.getConnection()
jdbc_connection_get = org.apache.commons.dbcp.PoolingDataSource.getConnection()
-XX:CompileCommand=exclude,org/apache/jennifer/bcel/classfile/Attribute,readAttribute
13. 構成変更及び ト ラ ブルシューテ ィ ング 195
13.3.10.エージ ェ ン ト イ ンス ト ール後、 アプ リ ケーシ ョ ン ク ッ キー情報が失われた場合
JENNIFERエージェントは訪問者数と同時端末ユーザ数を収集するためにクッキーを使用します。
使用可能なクッキーの数とクッキーには制限があるため、既存Javaアプリケーションで多くのクッ
キーを使用しているとクッキー情報が失われることがあります。この場合にはJENNIFERエージェン
トのhotfix_remote_address_for_wmonidオプションをtrueに設定します。
このオプションがtrueに設定されているとremote addressをユーザ区分に使用します。
13.3.11.Oracle DB使用時、 ClassCastExceptionが発生する場合
Oracleに従属的なCLOB/BLOBタイプをアプリケーションで明示的にOracleResultSetへタイプキャ
ストして使用しているときClassCastExceptionが発生することがあります。この場合JENNIFERエー
ジェントのオプション設定を通じて解決が可能です。
13.3.12.同じ設定で多重プロセスにイ ンス ト ールする場合
JENNIFERエージェントはJavaプロセス単位で設定しなければなりません。これは、各Javaプロ
セスの-Djennifer.configオプションを異なる設定にする必要があるためです。
しかし一部のAPサーバやJavaデーモンが同一実行コマンドに設定された値を利用して複数の多重プ
ロセスを実行する場合があります。この場合には各Javaプロセスのための互いに異なる
-Djennifer.configオプションを個別に設定することができません。
このような多重プロセス環境にJENNIFERエージェントをインストールするときは共通で使用され
るJava実行オプションに-Dconfig.auto=trueを追加で設定します。
詳細の内容についてはマニュアル[JENNIFERエージェント運用管理]部分の[多重プロセスに
JENNIFERをインストール]の部分をご参照ください。
hotfix_remote_address_for_wmonid = true
Notice: hotfix_remote_address_for_wmonidオプションをtrueに設定するとイントラネットシステムでのみ訪
問者数と同時端末ユーザ数が意味を持ちます。
enable_jdbc_oracle_dependency_used = true
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