JENNIFER4 INSTALL JP - > e-Corporation.JP · v Adobe、Adobe ロゴ、Reader は、Adobe Systems...

JENNIFER 4インストールガイド

JENNIFER 4 インストールガイド2009 年 06 月 10 日初版リリース

著　　者 JENNIFERSOFT,Inc

Copyright © 2009 by JENNIFERSOFT, Inc. All Rights Reserved.

本文書は JENNIFERSOFT,Inc が発行した文書であり著作権法により保護された著作物であるため発行所の許可

なく無断転載や複製を禁じます。

著作権案内

本文書の著作権及び知的財産権はJENNIFERSOFT,Inc（以下当社）にあります。

本文書及び本文書の複写本全体或いは一部分に対してコピーライト(Copyright)など文書及び製品と

関連する登録商標や知的財産権などの標識を毀損、修正、分離、削除することはできません。本権利は

韓国の著作権関連法と国際著作権協約をはじめ知的財産権法律及び協約により保護されます。

本文書は韓国内での使用に関することに限り、アメリカ、日本などその他の国家においては本文書の

配布及び使用を制限します。

本文書には当社が所有している特許に関する内容が含まれてる可能性があります。当社は本文書で言

及した内容に関連して特許と関連するなんらの権利を提供するものではありません。

本文書は基本的に当社の承認なしで商業的な用途で使用、譲渡、販売、配布することを禁じます。但

し、本文書はJENNIFERSOFTのアプリケーション性能管理ソリューションであるJENNIFER™につ

いての製品説明および運用/管理についての情報を提供する目的で作成されているため、JENNIFER製

品ライセンスの範囲内で題名、表紙、日付、著者及び著作権表示などを含んだ文書全体を複写したり電

子文書でジェニファーユーザに伝えることは例外的に許容します。このような場合でも本文書に対する

著作権や知的財産権が移管さたり販売されることはなく、その使用だけを承諾します。

本文書は技術的誤謬や記述的誤謬を含んでいる可能性があります。当社は本文書の情報の正確性を維

持するために最大限の努力を尽くしておりますが、本文書の技術的誤謬、誤った情報が含まれてないこ

とを保証するものではありません。本文書は予告なしに持続的に修正・補完されますが、本文書に記述

されている情報によって発生し得る直接的あるいは間接的な損害、データ、プログラム、その他無形の

財産に関する損失、使用利益の損失などに関して、たとえ、これらの損害可能性について事前に承知の

ことであっても、損害賠償その他の責任を負うことはありません。

ユーザは本文書を購入するか、電子文書でダウンロードすることにより使用を始めることで本事項に

明記された内容を理解し、これに同意するものとみなします。また、本内容がこれ以前の説明やその他

告知に優先することを承認したとみなします。

JENNIFER™とJENNIFERSOFT®は当社の固有登録商標であり、特許法と著作権法などにより保

護されます。当社の許可なしで無断に該当商標を使用したり配布する者は法律により処罰されます。

JENNIFERSOFT® JENNIFER™

iii

Trademarks

商標について

Microsoft、Windows、Windows Server、Windows Vista、Internet Information Server、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

vi JENNIFER4.0 マニュアル

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

１つのサーバに複数の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

xii JENNIFER4.0 マニュアル

文書構成

本文書は概念的理解を段階的に深めていけるように順次構成されています。しかし、関連主題別に必

要に応じて読めるようできる限り独立した構成となっています。本文書の構成は次の通りです。

1章、「JENNIFER概要」 JENNIFERのモジュールの構成と概念に関して紹介します。

2章、「JENNIFERサーバインストール」JENNIFERサーバのインストール方法について説明します。

3章、「インストールガイド（WebSphere用）」WebSphereにJENNIFERエージェントをインストー

ルする方法について説明します。

4章、「インストールガイド（WebLogic用）」WebSphereにJENNIFERエージェントをインストール

する方法について説明します。

5章、「インストールガイド（Tomcat用）」 TomcatにJENNIFERエージェントをインストールする方

法について説明します。

6章、「インストールガイド（Resin用）」ResinにJENNIFERエージェントをインストールする方法に

ついて説明します。

7章、「インストールガイド（JBoss用）」JBossにJENNIFERエージェントをインストールする方法

について説明します。

8章、「インストールガイド（Oracle AS用）」Oracle Application ServerにJENNIFERエージェント

をインストールする方法について説明します。

9章、「インストールガイド（GlassFish用）」GlassFishにJENNIFERエージェントをインストールす

る方法について説明します。

10章、「インストールガイド（Sun AS用）」Sun Application ServerにJENNIFERエージェントをイ

ンストールする方法について説明します。

11章、「構成変更及びトラブルシューティング」リアルタイムモニタリング、統計分析及びJENNIFERレポートについて説明します。

xiii

xiv JENNIFER4.0 マニュアル

xvi JENNIFER4.0 マニュアル

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-1: JENNIFERネットワークアーキテクチャ

1. JENNIFER 概要 3

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


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を構成する主要モジュール間にファイアウォールがあ

る場合には、関連ポートが正常に開かれているか確認する必要があります。


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


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


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を使用することが可能です。


　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をサポートしません。


図 2-1: Javaコントロールパネル

3. Javaアプレットランタイム設定エリアの表示ボタンをクリックするとJavaランタイム設定画面が

表示されます。複数のJavaをインストールした場合には[有効]コラムを通じて使用するJavaを選択

します。く


図 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


図 2-3: IE Javaプラグイン設定

　Mozilla Firefox3.0を使用する場合には[ツール｜インターネットオプション｜セキュリティ｜レベル

のカスタマイズ]メニューでアクティブスクリプト有効区分を確認します。


図 2-4: Firefox Javaプラグイン設定

Web ブラウザ設定 - Java スクリプト

　MS IE7.0またはIE8.0を使用する場合には[ツール|インターネットオプション|セキュリティ |レベ

ルのカスタマイズ] メニューでスクリプト有効区分を設定します。デフォルトでは有効に設定されてい

ます。


図 2-5: IE Javaスクリプト設定

　Mozilla Firefox3.0を使用する場合には[ツール|設定]メニューでJavaプラグイン有効区分を設定し

ます。設定画面でコンテンツタブを選択後、「Javaスクリプトを有効にする」を選択します。デフォル

トで選択されています。


図 2-6: Firefox Javaスクリプト設定

Flash プレイヤ

　JENNIFERクライアントの一部はFlashで構成されています。正常な画面表示のためには

AdobeFlashプレイヤ9.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が選択されるようにします。


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 は“１”番を選択します。

JENNIFERエージェントディレクトリ /home/jennifer/agent

Javaホームディレクトリ /was/WebSphere61/AppServer/java




########################################################

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


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メールでご連絡ください。


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を指定します。


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


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.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 環境



3.2.1. WebSphere インストール環境



Notice: SQLが表示されない場合、JENNIFERメソッドの“ライセンス及びJDBCモニタリング”部分をご参

照ください。

Notice: WebSphereが使用するJDKのバージョンが1.5以上の場合は一般JVMプロパティの「 -javaagent 」項目も削除します。


JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをWebSphereが運用中である


本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行ってください。





WebSphere ホームディレクトリ c:\JavaApplicationServer\wbsphere60\appserver

JENNIFERエージェントディレクトリ c:\jennifer\jenniferagent

Javaホームディレクトリ c:\JavaApplicationServer\websphere60\appserver\java



1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。 WebSphere は“１”番を選択します。

###################################################

######### Jennifer Agent Pre-Installation #########

###################################################

###################################################


###################################################

Send me e-mail at [email protected], if you can't find Java Application Serv

er you would like to install.


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


2. WebSphereのホームディレクトリを指定します。 WebSphereの場合 jennifer.jarファイルをファイ

ルを特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパスに設定する方法を提供します。

3. WebSphereが使用するJAVA HOMEディレクトリを指定します。 WebSphereが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.jarファイルを生成する作業をします。一般的な場合は WebSphereから提供する jdkを使用します。

####################################################


#####################################################

"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"

#####################################################


#####################################################

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"



リを設定する必要があります。システムでのメモリが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.



要があります。また、エージェント名は必ず3文字にしてください。指定したエージェント名で設

定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用するように

なります。生成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されませ

ん。この場合、JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせ

て修正後、使用することが可能です。


####################################################

Step 5 JENNIFER AGENT CONFIGURATION SETTING

####################################################

Do you want to customize agent configuration file ? (Y/N) : y

license_filename [ex: c:\jennifer\license.txt] :

c:\jennifer\jenniferagent\license.txt

agent_name - only 3 char [W11] : A11

logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log

lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] :

c:\jennifer\jenniferagent\lwst_A11.log

agent_tcp_port [7750] :

udp_server_host [localhost] : 192.168.0.139

server_udp_runtime_port [6901] :

server_udp_listen_port [6902] :

server_udp_lwst_call_stack_port [6703] :

Will you have any option that you need to change? If "Don't", continue to make

configuration file.

(Y/N)n

"Creating A11.conf..."

Agent configuration is completed...

Please, proceed with Post - Installation tasks







ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをWebSphere Javaオプションに設定する作業をします。

• WebSphere Javaオプション設定

1. WebSphereの「管理コンソール」で［サーバー｜アプリケーション・サーバ｜サーバー選択｜

サーバー・インフラストラクチャーのJavaおよびプロセス管理｜プロセス定義｜追加プロパ

ティーのJava仮想マシン］メニューを選択します。

2. 「一般プロパティー」の「Classpath」に「 jennifer.jar」ファイルのパスを入力します。

3. 「一般プロパティー」の「Boot Classpath」に下記の値を入力します。




ます。



"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


4. 「追加プロパティー」の「カスタム・プロパティー」に下記の値を新規作成します。

5. 該当のオプション値を保存します。

3.2.4. WebSphere の再起動及び確認事項





す。

-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


す。ただ、WebSphereが開始するときに登録されるようにするにはエージェント設定ファイルに

agent_boot_classオプションを活性化させます。

---------------------------------------


agent_name=A11

jennifer.config=c:/jennifer/jenniferagent/A11.conf

agent_tcp_port=7750


... Omitted ...

java.library.path=...

jennifer20.dll shared library loaded successfully.

---------------------------------------




2. ［構成管理 | ライセンスキー管理］メニューのライセンス入力フォームに発行されたライセンス

キーを登録します。



2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。.

3. ［障害診断 | ユーティリティ | ローディングクラスリスト］にローディングされたクラスなどが正



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を再起動します。


照ください。.


4インストールガイド（WebLogic用）

4.1. UNIX 環境



4.1.1. WebLogic インストール環境



JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをWebLogicが運用中である





WebLogic ホームディレクトリ /was/bea/weblogic92

37



1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。 WebLogic は“2”番を選択します。

JENNIFERエージェントディレクト

リ

/home/jennifer/agent

Javaホームディレクトリ /was/bea/jdk150_11




########################################################


########################################################

Send me e-mail at [email protected], if you can't find Java Appication Server you would like to install


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



2. WebLogicのホームディレクトリを指定します。 WebLogicの場合 jennifer.jarファイルをファイルを

特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパスに設定する方法を提供します。

3. WebLogicが使用するJAVA HOMEディレクトリを指定します。 WebLogicが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.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

########################################################


########################################################


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



4. インストールガイド（WebLogic 用） 39


リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業をします。WebLogicのJavaオプションに-d64オプションを使用する場合は“y”を入力し、Enterを押します。使用しない場合はそのままEnterを押します。

########################################################


########################################################




/was/bea/jdk150_11/jre/lib/i386/server/libjennifer20.so file is copied

successfully








定ファイルが生成されます。値を記入せずにEnterを入力すると、デフォルト値を使用します。生

成作業を望まない場合は(‘n’を選択した場合)新しい設定ファイルは生成されません。この場合、




########################################################


########################################################


















ます。






ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをWebLogic Javaオプションに設定する作業をします。

• WebLogic Javaオプション設定

1. WebLogicの環境設定ファイルは基本的には$DOMAIN_HOME/bin/startWebLogic.shファイルで

す。

2. WebLogicの環境設定ファイルの「CLASSPATH」の先頭に「 jennifer.jar」ファイルのパスを追加

します。

3. WebLogicの環境設定ファイルの「JAVA_OPTIONS」に下記の項目を追加します。

4. 該当のオプション値を保存して、WebLogicを再起動します。



Java Application Server Type : WebLogic Application Server

Java Application Server Home Directory : /was/bea/weblogic92

JDK Home Directory : /was/bea/jdk150_11


Agent config file : /home/jennifer/agent/WL1.conf


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バージョン以下は該当のオプションを設定しません。.


4.1.4. インストールの確認


WebLogicを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。



す。

2. [構成管理 | ライセンスキー管理]メニューのライセンス入力フォームに発行されたライセンスキー

を登録します。






---------------------------------------


agent_name=W11


agent_tcp_port=7750


... 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


---------------------------------------




照ください。



1. WebLogicを停止します。

2. WebLogicの$DOMAIN_HOME/bin/startWebLogic.shファイルでJENNIFERエージェント関連設

定値を削除します。

3. JENNIFERネイティブライブラリファイルを削除します。

4. WebLogicを再起動します。

4.2. Windows 環境



4.2.1. WebLogic インストール環境



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}



WebLogic ホームディレクトリ c:\JavaApplicationServer\weblogic

JENNIFERエージェントディレクトリ c:\jennifer\jenniferagent

Javaホームディレクトリ C:\Java\jdk16u13





1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。 WebLogic は“2”番を選択します。

###################################################


###################################################

###################################################


###################################################




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



Select : 2


2. WebLogicのホームディレクトリを指定します。 WebLogicの場合 jennifer.jarファイルをファイルを

特定なディレクトリにコピーしないでクラスパスに設定します。このステップではクラスパスに設定する方法を提供します。

3. WebLogicが使用するJAVA HOMEディレクトリを指定します。 WebLogicが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.jarファイルを生成する作業をします。


リを設定する必要があります。システムでのメモリが2GBを超過する場合は“y”、 2GB以下の場合

は“n”を選択します。

###################################################

Step 2. Type Java Applicatiion Server Home Directory

###################################################


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"

###################################################


###################################################

Input [JAVA_HOME] which is used for Java Application Server: C:\Java\jdk16u13

C:\Java\jdk16u13 is set as JAVA_HOME



###################################################


###################################################


jennifer20.dll has been copied to C:\Java\jdk16u13\bin successfully.









###################################################


###################################################














configuration file.

(Y/N)n








6. 最後に設定された内容を確認します。.


ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをWebLogic Javaオプションに設定する作業をします。

• WebLogic Javaオプション設定

1. WebLogicの環境設定ファイルは基本的には%WEBLOGIC_HOME%\bin\startWebLogic.cmdファイルです。

2. WebLogicの環境設定ファイルの「CLASSPATH」の先頭に「 jennifer.jar」ファイルのパスを追加

します。



lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを指

定します。





WAS TYPE : WebLogic 7.x/8.x/9.x/10.x

WAS HOME DIRECTORY : c:\JavaApplicationServer\weblogic

JAVA HOME DIRECTORY : C:\Java\jdk16u13



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%


3. WebLogicの環境設定ファイルの「JAVA_OPTIONS」に下記の項目を追加します。

4. 該当のオプション値を保存して、WebLogicを再起動します。

4.2.4. インストールの確認


WebLogicを再起動してENNIFERエージェントを動作させ、下記の内容を確認します。



す。



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バージョン以下は該当のオプションを設定しません。.

---------------------------------------


agent_name=A11


agent_tcp_port=7750


... Omitted...



---------------------------------------

Notice: 上記のような“jennifer20.dll shared library loaded successfully”というメッセージではない場合は、

インストールガイドのトラブルシューティングの部分をご参照ください。








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を再起動します。


照ください。.


5インストールガイド（Tomcat用）

5.1. UNIX環境

　JENNIFERエージェントのインストールは、事前インストール(pre-installation)、ポストインス


5.1.1. Tomcatインストール環境

　下記の表はJENNIFERエージェントのインストールについての理解を助けるためJENNIFER エー


　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをTomcatが運用中である


　本インストールガイドは次の環境値を基準として説明します。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行ってください。



Tomcat5ホームディレクトリ /was/tomcat5

51

5.1.2. 事前インストール(Pre-Installation)作業

　JENNIFERエージェントディレクトリでpreinstall.shを実行します。

1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。

Tomcat4.x / Tomcat5.xは“5”番を選択します。


Javaホームディレクトリ /jdk/sun/java15




Notice: Tomcat6の場合は“6”番を選択します。


########################################################

######## Jennifer Agent Pre-Installation ########

########################################################

########################################################


########################################################




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


5. インストールガイド（Tomcat 用） 53

2. Tomcatのホームディレクトリを指定します。jennifer.jarファイルをTomcatホームディレクトリの

common/libディレクトリへコピーする作業が行われます。/was/tomcat5と入力してEnterを押し

ます。

3. Tomcatが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ

ルが生成されます。/jdk/sun/java15と入力してEnterを入力します。

########################################################


########################################################


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ファイルがコピーされます。

########################################################


########################################################


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





リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業をします。TomcatのJavaオプションに-d64オプションを使用する場合は“y”を入力し、Enterを押します。使用しない場合はそのままEnterを押します。

########################################################


########################################################


libjennifer20_AMDx86.64.so test fail


/jdk/sun/java15/jre/lib/i386/server/libjennifer20.so file is copied successfully













########################################################


########################################################


Input the Agent Name [exactly 3 char] ex) W11 ===>> T11


logfile [ /home/jennifer/agent/jennifer_T11.log ] ?

lwst_logfile [ /home/jennifer/agent/lwst_T11.log ] ?












lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルパス及びファイルを

指定します。





5.1.3. ポストインストール(Post-Installation)作業

　ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをTomcat Javaオプションに設定する作業をします。

• Tomcat Javaオプション設定

1. Tomcatの設定ファイルは基本的には${TOMCAT_HOME}/bin/catalina.shです。例では/was/tomcat5/bin/catalina.shファイルです。

2. Tomcatの設定ファイルJAVA_OPTS環境変数に下記のように事前作業を通じて作られたライブラ

リ及びエージェント構成ファイルの設定作業をします。JAVA_OPTSがない場合は追加で記述しま

す。



Java Application Server Type : Jakarta Tomcat

Java Application Server Home Directory : /was/tomcat5

JDK Home Directory : /jdk/sun/java15


Agent config file : /home/jennifer/agent/T11.conf


Jennifer Native library file : /jdk/sun/java15/jre/lib/i386/


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.1.4. インストール確認作業

5.1.4.1. ライセンスキー登録

　Tomcatを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。


ファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。




1. ユーザがサービスリクエストをした場合、X-Viewに点などが表示されるか確認します。



す。Tomcatが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ

ションを活性化させます。

---------------------------------------


agent_name=T11

jennifer.config=/home/jennifer/agent/T11.conf

agent_tcp_port=7750


... 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


---------------------------------------




照ください。





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



5.2.2. 事前インストール作業(Pre-installation)作業

　JENNIFERエージェントディレクトリでpreinstall.batを実行します。


Tomcat4.x / Tomcat 5.x は“5”番を選択します。

JENNIFER サーバIP Address 192.168.0.139


区分説明

Notice: Tomcat6の場合、“6”番を選択します。

###################################################


###################################################

###################################################


###################################################




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



Select : 5


2. Tomcatのホームディレクトリを指定します。jennifer.jarファイルをTomcatホームディレクトリの

common/libディレクトリにコピーする作業が行われます。c:\JavaApplicationServer\tomcat4と入力してEnterを入力します。

3. Tomcatが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ

ルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。

###################################################


###################################################


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ファイルがコピーされます。

###################################################


###################################################

Input [JAVA_HOME] which is used for JAS : C:\Java\jdk16u13





4. JENNIFERエージェントでシステムのCPU、メモリ情報を収集するためにネイティブライブラリ

のインストール作業を行います。システム上のメモリが2GB以上ならば“y”、2GB以下ならば


###################################################


###################################################










表 5-4: オプション紹介

###################################################

Step 5. JENNIFER AGENT CONFIGURATION SETTING

###################################################














configuration file.

(Y/N)n








6. 最後に設定された情報を確認します。


　ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをTomcat Javaオプションに設定する作業をします。

1. Tomcatの設定ファイルは基本的には、%TOMCAT_HOME%\bin\catalina.batです。例では

c:\JavaApplicationServer\tomcat4\bin\catalina.batです。

2. Tomcatの設定ファイルJAVA_OPTS環境変数に下記のように事前作業を通じて作られたライブラ

リ及びエージェント構成ファイルの設定作業をします。JAVA_OPTSがない場合、追加で記述しま

す。

license_filename ライセンスキーを保存するライセンスファイルパスを指定します。


lwst_logfile JENNIFERトランザクション分析モジュール(LWST)のログファイルを指定します。




WAS TYPE : TOMCAT 4.X/5.5.x

WAS HOME DIRECTORY : c:\JavaApplicationServer\tomca4




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ファイルを修正する前にオリジナルをバックアップしておくことをおすすめします。




　Tomcatを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。

1. JENNIFERエージェントログが指定したファイルに生成されているかどうか確認するために、ロ

グファイルに下記のようなエージェントが開始されたというメッセージが出力されることを確認します。




1. ユーザがサービスリクエストを場合、X-Viewに点などが表示されているか確認します。



常に表示されているか確認します。


す。 Tomcatが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ


---------------------------------------


agent_name=A11


agent_tcp_port=7750


... Omitted ...

java.library.path=


---------------------------------------

Notice: 上記のような“jennifer20.dll shared library loaded successfully.” というメッセージがない場合、イ

ンストールガイドのトラブルシューティング部分をご参照ください。

Notice: SQLが表示されない場合、JENNIFERマニュアルの“ライセンス及びJDBCモニタリング”部分をご

参照ください。



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を削除します。


6インストールガイド（Resin用）

6.1. UNIX環境



6.1.1. Resinインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをResinが運用中であるサー

バのディレクトリへコピーします。

　本インストールガイドは次の環境値を基準として説明させています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行ってください。



Resinホームディレクトリ /was/resin315

67




Resinは“7”番を選択します。






########################################################


########################################################

########################################################


########################################################




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



2. Resinのホームディレクトリを指定します。jennifer.jarファイルをResinホームディレクトリの/libディレクトリへコピーする作業が行われます。/was/resin315と入力してEnterを押します。

3. Resinが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイル

が生成されます。/jdk/sun/java15と入力してEnterを入力します。

########################################################


########################################################


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

########################################################


########################################################



Application Server. ===>> /jdk/sun/java15




6. インストールガイド（Resin 用） 69


リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業をします。TomcatのJavaオプションに-d64オプションを使用する場合は“y”を入力してEnterを押します。使用しない場合はそのままEnterを押します。

########################################################


########################################################

















########################################################


########################################################


















指定します。






　ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスを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ファイルに設定を追加します。


Java Application Server Type : Resin

Java Application Server Home Directory : /was/resin315







<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未満は該当オプションを設定しません。


2. 実行スクリプトに下記のように事前作業を通じて作られたライブラリ及びエージェント構成ファ

イルの設定作業をします。



　Resinを再起動して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




す。Resinが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプショ

ンを活性化させます。

---------------------------------------


agent_name=W13


agent_tcp_port=7750


Omiitted


java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/jre/lib/i386:/jdk/sun/java15/jre/../lib/i386


---------------------------------------












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環境



6.2.1. Resinインストール環境




照ください。

Notice: Resin 2.1.x、3.0.xの場合は、起動スクリプトに設定したJENNIFERエージェント関連オプションを削

除します。


　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをResinが運用中のサーバの






区分説明

Resinホームディレクトリ c\JavaApplicationServer\resin3


Javaホームディレクトリ c:\Java\jdk16u13




Resinは“7”番を選択します。

###################################################


###################################################

###################################################


###################################################




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



Select : 7


2. Resinのホームディレクトリを指定します。jennifer.jarファイルをResinホームディレクトリの

\libディレクトリにコピーする作業が行われます。c:\JavaApplicationServer\resin3と入力して

Enterを入力します。

3. Resinが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイル

が生成されます。c:\Java\jdk16u13と入力してEnterを入力します。




###################################################


###################################################


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"

###################################################


###################################################

Input [JAVA_HOME] which is used for Java Application Server : C:\Java\jdk16u13




###################################################


###################################################





要があります。また、エージェント名は必ず3文字でなければなりません。指定したエージェント

名で設定ファイルが生成されます。値を記入せずにEnterを入力した場合、デフォルト値が使用さ

れます。生成作業を望まない場合(‘n’を選択した場合)は新しい設定ファイルは生成されません。

この場合、 JENNIFERが提供しているw11.confまたはjennifer.confファイルを環境に合わせて修正

したあとで使用することが可能です。


###################################################


###################################################














configuration file.

(Y/N)n










　ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをResinのJavaオプションに設定する作業をします。

6.2.3.1. Resin 4.xのJavaオプション設定

Resin 4.xの設定ファイルは基本的に%RESIN_HOME%\conf\resin.xmlファイルです。

Resinの設定ファイルの<jvm-arg>タグに下記のようにJENNIFERエージェントの構成設定を記述し

ます。







WAS TYPE : Resin 2.x/3.0.x/3.1.x/ 4.0.x

WAS HOME DIRECTORY : c:\JavaApplicationServer\resin3







<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>




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です。



　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>



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未満は該当オプションを設定しません。


す。 Resinが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプショ













1. Resinを中止します。

2. %RESIN_HOME%\lib(C:\JavaApplicationServer\resin3\lib)ディレクトリからjennifer.jarファ

イルを削除します。

---------------------------------------


agent_name=A11


agent_tcp_port=7750


... Omitted...

java.library.path=


---------------------------------------






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の場合は、起動コマンドの実行時の追加オプションを削除します。


7インストールガイド（JBoss用）

7.1. UNIX環境



7.1.1. JBossインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをJBossが運用中であるサー

バのディレクトリへコピーします。

85

　本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行う必要があります。




JBoss3.xは“8”番を選択します。



JBossホームディレクトリ /was/jboss3

/was/jboss4




Notice: JBoss4.xの場合は、”9”番を選択します。


########################################################


########################################################

########################################################


########################################################




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


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を入力します。

########################################################


########################################################


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ディレクトリにコピーします。

########################################################


########################################################


There is no default JAVA_HOME directory. Input the JAVA_HOME of the Java Application Server. ===>> /jdk/sun/java15






リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業をします。JBossのJavaオプションに-d64オプションを使用する場合は“y”を入力してEnterを押します。使用しない場合はそのままEnterを押します。

########################################################


########################################################

















########################################################


########################################################


Input the Agent Name [exactly 3 char] ex) W11 ===>> JB3


logfile [ /home/jennifer/agent/jennifer_JB3.log ] ?

lwst_logfile [ /home/jennifer/agent/lwst_JB3.log ] ?













指定します。






　ポストインストール作業では、事前インストール作業を通じて作成されたライブラリ及びエージェント構成ファイルパスをJBossのJavaオプションに設定する作業をします。

• JBossのJavaオプション設定

1. JBossの設定ファイルは基本的には${JBOSS_HOME}/bin/run.shです。例では/was/jboss3/bin/run.shファイルです。

2. JBossの設定ファイルのJAVA_OPTSオプションに下記のように事前作業を通じて作られたライブ

ラリ及びエージェント構成ファイルの設定作業をします。


Java Application Server Type : JBoss

Java Application Server Home Directory : /was/jboss3



Agent config file : /home/jennifer/agent/JB3.conf




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を追加





　JBossを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。









す。JBossが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ


---------------------------------------


agent_name=JB3

jennifer.config=/home/jennifer/agent/JB3.conf

agent_tcp_port=7750


Omitted





---------------------------------------




照ください。





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環境



7.2.1. JBossインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをJBossが運用中のサーバの


　本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザサーバの環境情報に合わせてインストール作業を行う必要があります。

Notice: JBoss4.xの場合は、${JBOSS_HOME}/server/default/libディレクトリのjennifer.jarファイルを削除し

ます。


区分説明

JBossホームディレクトリ c\JavaApplicationServer\jboss3






JBossは“8”番を選択します。

Javaホームディレクトリ c:\Java\jdk16u13



区分説明

Notice: JBoss4.xの場合は、“9”番を選択します。


###################################################


###################################################

###################################################


###################################################




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



Select : 8


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を入力します。




###################################################


###################################################


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"

###################################################


###################################################

Input [JAVA_HOME] which is used for Java Application Server : C:\Java\jdk16u13




###################################################


###################################################











###################################################


###################################################














configuration file.

(Y/N)n










　ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをJBossのJavaオプションに設定する作業をします。

1. JBossの設定ファイルは基本的には、%JBOSS_HOME%\bin\run.batです。例では

c:\JavaApplicationServer\jboss3\bin\run.batです。

2. JBossの設定ファイルのJAVA_OPTSに下記のように事前作業を通じて作られたライブラリ及び

エージェント構成ファイルの設定作業をします。







WAS TYPE : JBOSS 3.X

WAS HOME DIRECTORY : c:\JavaApplicationServer\jboss3







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を使用しません。




　JBossを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。











す。 JBossが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプショ


---------------------------------------


agent_name=A11


agent_tcp_port=7750


... Omitted...

java.library.path=


---------------------------------------







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ディレクトリから削除します。


8インストールガイド（Oracle AS用）

8.1. UNIX環境



8.1.1. Oracle ASインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをOracle ASが運用中である


　本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行う必要があります。



Oracle ASホームディレクトリ /was/OracleAS

103




Oracle ASは“4”番を選択します。


Javaホームディレクトリ /was/OracleAS/jdk




########################################################


########################################################

########################################################


########################################################




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



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を入力します。

########################################################


########################################################


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

########################################################


########################################################


Do you want to use the default JAVA_HOME [/was/OracleAS/jdk] ?

[/was/OracleAS/jdk] is set as JAVA_HOME



8. インストールガイド（Oracle AS 用） 105


リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業をします。Oracle ASのJavaオプションに-d64オプションを使用する場合は“y”を入力して

Enterを押します。使用しない場合はそのままEnterを押します。

########################################################


########################################################




　/was/OracleAS/jdk/jre/lib/i386/server/libjennifer20.so file is copied

successfully













########################################################


########################################################


Input the Agent Name [exactly 3 char] ex) W11 ===>> OR1


logfile [ /home/jennifer/agent/jennifer_T11.log ] ?

lwst_logfile [ /home/jennifer/agent/lwst_T11.log ] ?













指定します。






　ポストインストール作業では、事前インストール作業を通じて作成されたライブラリ及びエージェント構成ファイルパスをOracle ASのJavaオプションに設定する作業をします。

• Oracle ASのJavaオプション設定

1. Oracle ASの設定ファイルは基本的には${ORACLE_HOME}/opmn/conf/opmn.xmlです。例では/was/OracleAS/opmn/conf/opmn.xmlファイルです。

2. Oracle ASの設定ファイルに下記のように事前作業を通じて作られたライブラリ及びエージェント

構成ファイルの設定作業をします。



Java Application Server Type : Oracle Application Server

Java Application Server Home Directory : /was/OracleAS

JDK Home Directory : /was/OracleAS/jdk


Agent config file : /home/jennifer/agent/OR1.conf


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未満は該当オプションを設定しません。




　Oracle ASを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。









す。Oracle ASが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ


---------------------------------------


agent_name=OR1

jennifer.config=/home/jennifer/agent/OR1.conf

agent_tcp_port=7750


... 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


---------------------------------------




照ください。





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環境



8.2.1. Oracle ASインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをOracle ASが運用中のサー

バのディレクトリにコピーします。

　本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザサーバの環境情報に合わせてインストール作業を行う必要があります。表 8-3: JENNIFER エージェント構成例説明のための環境

区分説明

Oracle ASホームディレクトリ c\JavaApplicationServer\oraas


Javaホームディレクトリ c:\JavaApplicationServer\oraas\jdk






Oracle ASは“4”番を選択します。

###################################################


###################################################

###################################################


###################################################




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



Select : 4


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を入力します。




###################################################


###################################################


Example : c:\JavaApplicationServer\oraas


c:\JavaApplicationServer\oraas

Java Application Server Home Directory : c:\JavaApplicationServer\oraas

“c:\JavaApplicationServer\oraas”\oraas\j2ee\home\lib\api-ext jennifer.jar copy successful"

###################################################


###################################################

Input [JAVA_HOME] which is used for JavaApplicationServer :

C:\JavaApplicationServer\oraas\jdk

C:\JavaApplicationServer\oraas\jdk is set as JAVA_HOME



###################################################


###################################################


jennifer20.dll has been copied to C:\JavaApplicationServer\oraas\jdk\bin successfully.









###################################################


###################################################














configuration file.

(Y/N)n










　ポストインストール作業では事前インストール作業を通じて作成されたライブラリ及びエージェント構成ファイルパスをOracle ASのJavaオプションに設定する作業をします。

1. Oracle ASの設定ファイルは基本的には、%ORACLE_HOME%\opmn\conf\opmn.xmlです。例

ではc:\JavaApplicationServer\oraas\opmn\conf\opmn.xmlです。

2. Oracle ASの設定ファイルに下記のように事前作業を通じて作られたライブラリ及びエージェント

構成ファイルの設定作業をします。







WAS TYPE : OracleAS 10gR3

WAS HOME DIRECTORY : c:\JavaApplicationServer\oraas

JAVA HOME DIRECTORY : C:\JavaApplicationServer\oraas\jdk




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として設定します。




　Oracle ASを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。











す。 Oracle ASが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ


---------------------------------------


agent_name=A11


agent_tcp_port=7750


... Omitted...

java.library.path=


---------------------------------------

Notice: 上記のような“libjennifer20.dll shared library loaded successfully.” というメッセージがない場合、

インストールガイドのトラブルシューティング部分をご参照ください。





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を再起動します。


9インストールガイド（GLASSFISH用）

9.1. UNIX環境



9.1.1. GlassFishインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをGlassFishが運用中である


　本インストールガイドは次の環境値を基準として説明します。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行ってください。



GlassFish5ホームディレクトリ /was/glassfish

119




GlassFishは“11”番を選択します。






########################################################


########################################################

########################################################


########################################################




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



2. GlassFishのホームディレクトリを指定します。jennifer.jarファイルをGlassFishホームディレク

トリのlibディレクトリへコピーする作業が行われます。/was/glassfishと入力してEnterを押しま

す。

3. GlassFishが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファ

イルが生成されます。/jdk/sun/java15と入力してEnterを入力します。

########################################################


########################################################


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

########################################################


########################################################







9. インストールガイド（GLASSFISH 用） 121


リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業をします。GlassFishのJavaオプションに-d64オプションを使用する場合は“y”を入力し、


########################################################


########################################################

















########################################################


########################################################


Input the Agent Name [exactly 3 char] ex) W11 ===>> G01


logfile [ /home/jennifer/agent/jennifer_G01.log ] ?

lwst_logfile [ /home/jennifer/agent/lwst_G01.log ] ?













指定します。






　ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをGlassFish Javaオプションに設定する作業をします。

• GlassFish Javaオプション設定

1. GlassFishの管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メニューを選択します。

2. 管理コンソールで下記のような設定を追加後、設定を保存します。


Java Application Server Type : Sun Glassfish

Java Application Server Home Directory : /was/glassfish



Agent config file : /home/jennifer/agent/G01.conf


Jennifer Native library file : /was/glassfish/lib/


-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未満は該当オプションを設定しません。




　GlassFishを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。









す。GlassFishが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ


---------------------------------------


agent_name=G01

jennifer.config=/home/jennifer/agent/G01.conf

agent_tcp_port=7750


Omitted





---------------------------------------




照ください。





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環境



9.2.1. GlassFishインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをGlassFishが運用中のサー


　本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザサーバの環境情報に合わせてインストール作業を行ってください。表 9-3: JENNIFER エージェント構成例説明のための環境

区分説明

GlassFishホームディレクトリ c\JavaApplicationServer\glassfish








GlassFishは“11”番を選択します。

###################################################


###################################################

###################################################


###################################################




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



Select : 11


2. GlassFishのホームディレクトリを指定します。jennifer.jarファイルをGlassFishホームディレク

トリのlibディレクトリにコピーする作業が行われます。c:\JavaApplicationServer\glassfishと入

力してEnterを押します。

3. GlassFishが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファ

イルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。




###################################################


###################################################


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"

###################################################


###################################################





###################################################


###################################################











###################################################


###################################################














configuration file.

(Y/N)n










　ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをGlassFish Javaオプションに設定する作業をします。

1. GlassFishの管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メニューを選択します。








WAS TYPE : GlassFish 1.x/2.x

WAS HOME DIRECTORY : c:\JavaApplicationServer\glassfish




JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Java\jdk16u13\jennifer20.dll


-Xbootclasspath/

p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lwst.jdk.jar



Warning: GlassFishが使用するJDKが1.5以上の場合、

-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jarを追加しなければならず、jdk1.4未満は該当オプ

ションを設定しません。




　GlassFishを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。











す。 GlassFishが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ


---------------------------------------


agent_name=A11


agent_tcp_port=7750


... Omitted ...

java.library.path=


---------------------------------------







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を再起動します。


10インストールガイド（Sun AS用）

10.1. UNIX環境



10.1.1.Sun ASインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをSun ASが運用中である


　本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行ってください。



Sun ASホームディレクトリ /was/SUNWappserver9

135

10.1.2.事前インストール(Pre-Installation)作業



Sun ASは“10”番を選択します。






########################################################


########################################################

########################################################


########################################################




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



2. Sun ASのホームディレクトリを指定します。jennifer.jarファイルをSun ASホームディレクトリ

のlibディレクトリへコピーする作業が行われます。/was/SUNWappserverと入力してEnterを押し

ます。

3. Sun ASが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ

ルが生成されます。/jdk/sun/java15と入力してEnterを入力します。

########################################################


########################################################


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

########################################################


########################################################







10. インストールガイド（Sun AS 用） 137


リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業をします。Sun ASのJavaオプションに-d64オプションを使用する場合は“y”を入力し、Enterを押します。使用しない場合はそのままEnterを押します。

########################################################


########################################################

















########################################################


########################################################


Input the Agent Name [exactly 3 char] ex) W11 ===>> SW1


logfile [ /home/jennifer/agent/jennifer_SW1.log ] ?

lwst_logfile [ /home/jennifer/agent/lwst_SW1.log ] ?













指定します。





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]メニューを選択します。


• SUN AS 7のJavaオプション設定

1. Javaオプションの設定ファイルは基本的に${SUNAS_HOME}/domains/domain1/server1/config/serverxmlです。


Java Application Server Type : Sun Application Server

Java Application Server Home Directory : /was/SUNWappserver9



Agent config file : /home/jennifer/agent/SW1.conf


Jennifer Native library file : /was/SUNWappserver9/lib/



lwst.boot.jar



Warning: Sun ASが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを追



2. 設定ファイルに下記のJENNIFERエージェント設定を追加します。

10.1.4.インストール確認作業

10.1.4.1.ライセンスキー登録

　Sun ASを再起動して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を追



す。Sun ASが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ


---------------------------------------


agent_name=SW1

jennifer.config=/home/jennifer/agent/SW1.conf

agent_tcp_port=7750


Omitted





---------------------------------------






10.1.4.2.モニタリングデータ確認





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環境



10.2.1.Sun ASインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをSun ASが運用中のサーバ

のディレクトリにコピーします。


照ください。



10.2.2.事前インストール作業(Pre-installation)作業



区分説明

Sun ASホームディレクトリ c\JavaApplicationServer\sunas8






Sun ASは“10”番を選択します。

###################################################


###################################################

###################################################


###################################################




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



Select : 10


2. Sun ASのホームディレクトリを指定します。jennifer.jarファイルをSun ASホームディレクトリ

のlibディレクトリにコピーする作業が行われます。c:\JavaApplicationServer\sunas8と入力して

Enterを押します。

3. Sun ASが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイ

ルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。




###################################################


###################################################


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"

###################################################


###################################################





###################################################


###################################################











###################################################


###################################################














configuration file.

(Y/N)n










　ポストインストール作業では事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスをSun AS Javaオプションに設定する作業をします。

• Sun AS 8.x/9.xのJavaオプション設定

1. Sun ASの管理コンソールの[Application Server|JVM Setting|JVM Setting|JVM Options]メニューを選択します。


• Sun AS 7のJavaオプション設定







WAS TYPE : Sun App Server 7.x/8.x/9.x.10.x

WAS HOME DIRECTORY : c:\JavaApplicationServer\sunas8




JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Java\jdk16u13\jennifer20.dll


-Xbootclasspath/

p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lwst.jdk.jar



Warning: Sun ASが使用するJDKが1.5以上の場合、-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jarを追加しなければならず、jdk1.4未満は該当オプションを設定しません。


1. Javaオプションの設定ファイルは基本的に

${SUNAS_HOME}\domains\domain1\server1\config\serverxmlです。

2. 設定ファイルに下記のJENNIFERエージェント設定を追加します。



　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未満は該当オプションを設定しません。


す。 Sun ASが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ













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)を削除します。

---------------------------------------


agent_name=A11


agent_tcp_port=7750


... Omitted ...

java.library.path=


---------------------------------------






5. Sun ASを再起動します。


11インストールガイド（Interstage用）

11.1. UNIX環境



11.1.1.Interstageインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをInterstageが運用中である


　本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行ってください。



Interstageホームディレクトリ /opt/Interstage

151

11.1.2.事前インストール(Pre-Installation)作業



Javaホームディレクトリ /opt/Interstage/FJSVawjbk/jdk5






Interstageは“13”番を選択します。

########################################################


########################################################

########################################################


########################################################

Send me e-mail at [email protected], if you can't find Java Appication

Server you would like to install


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


11. インストールガイド（Interstage 用） 153

2. Interstageのホームディレクトリを指定します。/opt/Interstageと入力してEnterを押します。

3. Interstageが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイルが生成されます。/jdk/sun/java15と入力してEnterを入力します。

########################################################


########################################################


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

########################################################


########################################################



Application Server. ===>> /opt/Interstage/FJSVawjbk/jdk5

[/opt/Interstage/FJSVawjbk/jdk5] is set as JAVA_HOME





リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業をします。InterstageのJavaオプションに-d64オプションを使用する場合は“y”を入力し、


########################################################


########################################################




/opt/Interstage/FJSVawjbk/jdk5/jre/lib/i386/server/libjennifer20.so file is copied

successfully













########################################################


########################################################


Input the Agent Name [exactly 3 char] ex) W11 ===>> SW1


logfile [ /home/jennifer/agent/jennifer_SW1.log ] ?

lwst_logfile [ /home/jennifer/agent/lwst_SW1.log ] ?













指定します。






　ポストインストール作業では、事前インストール作業によって作成されたライブラリ及びエージェント構成ファイルパスを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]メニューを選択します。



Java Application Server Type : Fujitsu Interstage

Java Application Server Home Directory : /opt/Interstage

JDK Home Directory : /opt/Interstage/FJSVawjbk/jdk5


Agent config file : /home/jennifer/agent/SW1.conf


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



Warning: Interstageが使用するJDKが1.5以上の場合、-javaagent:/home/jennifer/agent/lwst.javaagent.jarを追加しなければならず、jdk1.4未満は該当オプションを設定しません。




　Interstageを再起動してJENNIFERエージェントを動作させ、下記の内容確認します。









す。Interstageが開始するときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプションを活性化させます。

---------------------------------------


agent_name=SW1

jennifer.config=/home/jennifer/agent/SW1.conf

agent_tcp_port=7750


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


---------------------------------------




照ください。





1. Interstageを中止します。


|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環境



11.2.1.Interstageインストール環境



　JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをInterstageが運用中のサー


　本インストールガイドは下記の環境値を基準にして説明されています。実際の作業時にはユーザサーバの環境情報に合わせてインストール作業を行ってください。表 11-3: JENNIFER エージェント構成例説明のための環境

区分説明

Interstageホームディレクトリ c\Interstage\

JENNIFERエージェントホームディレクトリ c:\jennifer\agent

Javaホームディレクトリ C:\Interstage\jdk5


11.2.2.事前インストール作業(Pre-installation)作業



Interstageは“13”番を選択します。



区分説明

###################################################


###################################################

###################################################


###################################################




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





Select : 13


2. Interstageのホームディレクトリを指定します。c:\Interstageと入力してEnterを押します。

3. Interstageが使用するJAVA HOMEディレクトリを指定します。このステップではlwst.jdk.jarファイルが生成されます。c:\Java\jdk16u13と入力してEnterを押します。




###################################################


###################################################


Example : c:\JavaApplicationServer\Interstage


c:\Interstage

Java Application Server Home Directory : c:\Interstage

###################################################


###################################################

Input [JAVA_HOME] which is used for JAS : C:\Interstage\jdk5

C:\Interstage\jdk5 is set as JAVA_HOME



###################################################


###################################################


jennifer20.dll has been copied to C:\Interstage\jdk5\bin successfully.









###################################################


###################################################














configuration file.

(Y/N)n










　ポストインストール作業では「jennifer.jar」ファイルのコピーと事前インストール作業によって作

成されたライブラリ及びエージェント構成ファイルパスをInterstage Javaオプションに設定する作業

をします。

• jennifer.jarファイルのコピー

JENNIFERの「jennifer.jar」ファイルをInterstageにコピーします。コピー先は[Interstageホーム

ディレクトリ/J2EEホームディレクトリ/var/deployment/ijserver/APサーバ名/ext]です。

• Interstage 8.x/9.xのJavaオプション設定


|Settings|WorkUnit Settings|Java VM Options]メニューを選択します。







WAS TYPE : Fujitsu Interstage

WAS HOME DIRECTORY : C:\Interstage

JAVA HOME DIRECTORY : C:\Interstage\jdk5



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\





　Interstageを再起動してJENNIFERエージェントを動作させ、下記の内容を確認します。





-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未満は該当オ

プションを設定しません。


す。 Interstageが開始したときに登録されるようにするにはエージェント設定ファイルにagent_boot_classオプ


---------------------------------------


agent_name=A11

jennifer.config=c:/jennifer/jenniferagent/w11.conf

agent_tcp_port=7750


... Omitted ...

java.library.path=


---------------------------------------









11.2.5.JENNIFERエージェント構成削除。

1. Interstageを中止します。


|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を再起動します。




12インストールガイド（Cosminexus用）

12.1. UNIX 環境



12.1.1.Cosminexus インストール環境



JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをCosminexusが運用中であ

るサーバのディレクトリへコピーします。




Cosminexus ホームディレクトリ /opt/Hitachi/Cosminexus

169

12.1.2.事前インストール(Pre-Installation) 作業


1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。 Cosminexus は“１2”番を選択します。


Javaホームディレクトリ /opt/Hitachi/Cosminexus/jdk




########################################################


########################################################




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





2. Cosminexusのホームディレクトリを指定します。 Cosminexusの場合 jennifer.jarファイルを

Cosminexusの「hitj2ee.jar」ファイルにアップロードします。このステップではクラスパスに設

定する方法を提供します。

3. Cosminexusが使用するJAVA HOMEディレクトリを指定します。 Cosminexusが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.jarファイルを生成する作業をします。一般的な場合は Cosminexusから提供する jdkを使用します。

########################################################


########################################################


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

########################################################


########################################################


Do you want to use the default JAVA_HOME [/opt/Hitachi/Cosminexus/jdk] ?

[/opt/Hitachi/Cosminexus/jdk] is set as JAVA_HOME



12. インストールガイド（Cosminexus 用） 171


リを使用しますが、システムに適したネイティブライブラリファイルを探してテストをする作業をします。CosminexusのJavaオプションに-d64オプションを使用する場合は“y”を入力し、Enterを押します。使用しない場合はそのままEnterを押します。

########################################################


########################################################




/opt/Hitachi/Cosminexus/jdk/bin/libjennifer20.so file is copied successfully













########################################################


########################################################


















ます。





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ファイルに抽出したパッケージをアップデートします。



Java Application Server Type : Cosminexus Application Server

Java Application Server Home Directory : /opt/Hitachi/Cosminexus

JDK Home Directory : /opt/Hitachi/Cosminexus/jdk




Jennifer Native library file : /opt/Hitachi/Cosminexus/jdk/bin/


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


• 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エージェントを動作させ、下記の内容を確認します。


lwst.boot.jar

-Djennifer.config=/home/jennifer/agent/w11.conf



す。




す。









1. バックアップした「hitj2ee.jar.backup」ファイルを修復します。。

---------------------------------------


agent_name=W11


agent_tcp_port=7750


... 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 ...


---------------------------------------




照ください。

/]#cp /opt/Hitachi/Cosminexus/CC/lib/hitj2ee.jar.backup /opt/Hitachi/Cosminexus/CC/lib/hitj2ee.jar



3. 設定した「拡張起動パラメタ」項目の「lwst.boot.jar, lwst.jdk.jar」、「w11.conf」設定値を削除し

ます。。

4. JENNIFERネイティブライブラリファイル(例の場合、/opt/Hitachi/Cosminexus/jdk/bin/libjennifer20.so)を削除します。

5. Cosminexusを再起動します。

12.2. Windows 環境



12.2.1.Cosminexus インストール環境



JENNIFERエージェントディレクトリ下位ファイル及びディレクトリをCosminexusが運用中であ

るサーバのディレクトリへコピーします。

本インストールガイドは次の環境値を基準として説明されています。実際の作業ではユーザのサーバ環境情報に合わせてインストール作業を行ってください。

Notice: Cosminexusが使用するJDKのバージョンが1.5以上の場合は「lwst.javaagent.jar」項目も削

除します。



Cosminexus ホームディレクトリ C:\Program Files\Hitachi\Cosminexus

JENNIFERエージェントディレクトリ C:\jennifer\jenniferagent

Javaホームディレクトリ C:\Program Files\Hitachi\Cosminexus\jdk



12.2.2.事前インストール(Pre-Installation) 作業


1. JENNIFERエージェントをインストールするJavaアプリケーションサーバの種類を選択します。 WebSphere は“１2”番を選択します。

###################################################


###################################################

###################################################


###################################################




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





Select : 12


2. Cosminexusのホームディレクトリを指定します。 Cosminexusの場合 jennifer.jarファイルを

Cosminexusの「hitj2ee.jar」ファイルにアップロードします。このステップではクラスパスに設

定する方法を提供します。

3. Cosminexusが使用するJAVA HOMEディレクトリを指定します。 Cosminexusが使用するJAVA HOMEディレクトリの確認の上、 lwst.jdk.jarファイルを生成する作業をします。一般的な場合は Cosminexusから提供する jdkを使用します。

####################################################


#####################################################


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"

#####################################################


#####################################################

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





リを設定する必要があります。システムでのメモリが2GBを超える場合は“y”、 2GB以下の場合は


####################################################


####################################################


jennifer20.dll has been copied to C:\Program Files\Hitachi\Cosminexus\jdk\bin successfully.









####################################################


####################################################



c:\jennifer\jennifer\agent\license.txt


logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jennifer\agent\A11.log


c:\jennifer\jennifer\agent\lwst_A11.log







configuration file.

(Y/N)n









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ファイルをバックアップします。




ます。





WAS TYPE : Cosminexus

WAS HOME DIRECTORY : C:\Program Files\Hitachi\Cosminexus

JAVA HOME DIRECTORY : C:\Program Files\Hitachi\Cosminexus\jdk



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


2. 任意のフォルダでjennifer.jarファイルの三つのパッケージ(com, org, javax)を抽出します。

3. hitj2ee.jarファイルに抽出したパッケージをアップデートします。

• Cosminexus JVMオプション設定


2. 「拡張起動パラメタ」に下記の値を各々入力します。

3. Cosminexusが使っているJDKのバージョンが1.5以上の場合、下記の値も「拡張起動パラメタ」

に入力します。

4. 適用ボタンをクリックしてパラメタを適用します。

5. 「設定情報の配布」ボタンをクリックして配布します。

12.2.4.Cosminexus の再起動及び確認事項

12.2.4.1.ライセンスキーの登録


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


す。




す。





2. X-Viewの点などを選択したときメソッド及びSQL情報などが正常に表示されるか確認します。.



12.2.5.JENNIFERエージェント構成削除。

1. バックアップした「hitj2ee.jar.backup」ファイルを修復します。。


---------------------------------------


agent_name=A11


agent_tcp_port=7750


... Omitted ...



---------------------------------------




照ください。.

C:\tmp>cp C:\Program Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jar.backup C:\Program

Files\Hitachi\Cosminexus\CC\lib\hitj2ee.jar


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」項目も削

除します。


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


　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)クリエーターの２番目のパラメータIPに該当する値です。

ハードウェアに２つ以上のネットワークカードがある場合、特定ネットワークカードに届いたリクエストのみバインディングするときに設定します。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. １つのサーバに複数のJENNIFERエージェント

をインストール

　JENNIFERエージェントをインストールすると物理的に1つのサーバに複数のインスタンスが存在

する場合が多くあります。このような場合に、JENNIFERエージェントを構成する方法について説明

します。ここでは、同じJENNIFERサーバへ性能データを送信すると仮定します。

　同じJavaアプリケーションサーバで動作している複数のインスタスにJENNIFERエージェントをイ

ンストールする場合、基本的に事前インストール作業 (pre-installation)は最初の１回のみ実行します。

２回目からのインストールは既に構成されたエージェント構成ファイル(例、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と関連したログファイル


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ファイルによる処理に区分されます。


4. JENNIFERエージェントとサーバ間のファイアウォールのようなネットワークの制約により通信

が正常に成立しない場合があります。 TCPの場合は、telnetプログラムで確認が可能です。UDPの場合は、JENNIFERエージェントで提供するudptest.sh(bat)ユーティリティを実行して

JENNIFERサーバのログに下記のようなメッセージが出力されるか確認します。

5. 4)をテストするときパラメータ値が小さい場合は成功しますが、パラメータ値が大きい場合には失

敗することがあります。これはシステム或いはネットワークサイドでパケットのサイズを制限している場合です。JENNIFERエージェントでも１回に送信することが可能なパケットのサイズを

指定できるオプションがあります。 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オプションに登録されたポートが連結されない場合、構成

管理メニューとリアルタイムアクティブサービスリスト画面などでメニューが正常に表示されません。


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.


　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オプションで設定したメソッドのパラメータの中で必ず１つは

java.sql.Connectionタイプでなければなりません。但し、パラメータ位置は関係ありません。

4. 全てのオプションにセミコロン[;]を区切りとして２つ以上の値を設定することが可能です。

• フレームワーク別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()


[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.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


13.3.13.オンラインインストールテクニカルサポートの問い合わせ

　テクニカルサポートの問い合わせの前にJENNIFERSOFTのWebサイト(www.jennifersoft.com)の[ドキュメント]や[Q&A]をご確認ください。最新マニュアル及び各ドキュメント、過去の問い合わせに

対する回答を掲載しています。

　本文書の内容に不明な点がある場合や、インストールと関連した問題がある場合は、JENNIFERSOFTテクニカルサポートチームからテクニカルサポートをご提供します。

　インストール時に問題が発生した場合、Javaアプリケーションサーバ、 DBMS、 JENNIFERサーバ/エージェントの基本情報と共にインストールトラブルシューティングの結果ファイルを添付して、[email protected]までお送りください。

　なお、JENNIFERバージョン情報はJENNIFERエージェントディレクトリにあるversion.shコマン

ドを実行させると得ることができます。


JENNIFER4 INSTALL JP - > e-Corporation.JP · v Adobe、Adobe ロゴ、Reader は、Adobe Systems...

Documents

Transcript of JENNIFER4 INSTALL JP - > e-Corporation.JP · v Adobe、Adobe ロゴ、Reader は、Adobe Systems...