ZOO Install Guide 4

JENNIFER v4 Installation Guide
JS-0810-04

Written By Nomin Park, Justin Kim Published By JenniferSoft, Inc Edited By Amie Song First Edition Oct, 30th 2008
Recent Edition January, 3st 2011

Document version 4.5
Document Number JS-0810-04

Reference Book JENNIFER v4 User s Guide
Copyright 2008 by JENNIFERSOFT, Inc. All Rights Reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or other-
wise, without the prior written permission of the publisher. Printed in Korea.
Table of Contents
1. JENNIFER Overview ............................................................................. 1
Element Package for JENNIFER ..................................................................................... 1 JENNIFER Directory Structure.......................................................................................... 2 JENNIFER Network Structure ........................................................................................... 2
Communication between the JENNIFER Agent and Server................................ 4 Setting of the UDP Communication Option .............................................. 4 Setting of the TCP Communication Option .............................................. 4 Setting of the JENNIFER IP ..................................................................... 4 Communication between the JENNIFER Server and Client................................ 5 Administration Console Connection Port.................................................. 5 Applet Communication Port...................................................................... 5 Cautions for Network Organization...................................................................... 5
2.
JENNIFER Server Installation .............................................................. 1

JENNIFER Server Specification ........................................................................................ 1 JENNIFER Server Installation ........................................................................................... 2
UNIX ............................................................................................................................... 2 Windows ......................................................................................................................... 4 JENNIFER Server Installation ............................................................................. 4
JENNIFER Client Setting .................................................................................................. 5

Window Service Registration............................................................................. 11
3.
Setup for WebSphere ......................................................................... 13

UNIX Environment.......................................................................................................... 13
Installation Environment for WebSphere....................................................................... 13 Pre Installation Works ................................................................................................... 14 Post Installation Works ................................................................................................. 19 Finalizing Process ......................................................................................................... 19 Registering the License Key .............................................................................. 19 Checking the Monitoring Data ........................................................................... 20 Removing the JENNIFER Agent Configuration............................................................. 20
Windows.......................................................................................................................... 21
Installation Environment for WebSphere....................................................................... 21 Pre Installation Works ................................................................................................... 22 Post Installation Works ................................................................................................. 26 Finalizing Process ......................................................................................................... 27 Registering the License Key .............................................................................. 27 Checking the Monitoring Data ........................................................................... 28 Removing the JENNIFER Agent Configuration............................................................. 28
Table of Contents
4.
Setup for WebLogic ............................................................................ 29

UNIX ............................................................................................................................... 29
Installation Environment for WebLogic .......................................................................... 29 Pre Installation Works.................................................................................................... 30 Post Installation Works .................................................................................................. 34 Finalizing Process ......................................................................................................... 35 Registering the License Key .............................................................................. 35 Checking the Monitoring Data............................................................................ 35 Removing the JENNIFER Agent Configuration ............................................................. 36
Windows .......................................................................................................................... 36
Installation Environment for WebLogic .......................................................................... 36 Pre Installation Works.................................................................................................... 37 Post Installation Works .................................................................................................. 42 Finalizing Process ......................................................................................................... 43 Registering the License Key .............................................................................. 43 Checking the Monitoring Data............................................................................ 43 Removing the JENNIFER Agent Configuration ............................................................. 44
5.
Setup for Tomcat................................................................................. 45

UNIX Environment.......................................................................................................... 45
Installation Environment for the Tomcat ........................................................................ 45 Pre Installation Works.................................................................................................... 46 Post Installation Works .................................................................................................. 51 Finalizing Process ......................................................................................................... 52 Registering License Key .................................................................................... 52 Checking the Monitoring Data............................................................................ 52 Removing the JENNIFER Agent Configuration ............................................................. 53
Windows Environment..................................................................................................... 53
Installation Environment for Tomcat .............................................................................. 53 Pre Installation Works.................................................................................................... 54 Post Installation Works .................................................................................................. 59 Finalizing Process ......................................................................................................... 60 Registering License Key .................................................................................... 60 Checking the Monitoring Data............................................................................ 61 Removing the JENNIFER Agent Configuration ............................................................. 61
6.
Setup for Resin.................................................................................... 63

UNIX ............................................................................................................................... 63
Installation Environment for Resin................................................................................. 63 Pre Installation Works.................................................................................................... 64 Post Installation Works .................................................................................................. 69 Resin 3.1.x Java option setting .......................................................................... 69 Resin 2.x/3.0.x Java option setting .................................................................... 69 Finalizing Process ......................................................................................................... 70
Checking the Monitoring Data ........................................................................... 70 Removing the JENNIFER Agent Configuration............................................................. 71
Windows.......................................................................................................................... 71
Installation Environment for Resin ................................................................................ 72 Pre Installation Works ................................................................................................... 72 Post Installation Works ................................................................................................. 77 Resin 3.1.x Java option setting.......................................................................... 77 Resin 2.x/3.0.x Java option setting .................................................................... 78 Resin 4.x Java option setting............................................................................. 78 Finalizing Process ......................................................................................................... 79 Registering the License Key .............................................................................. 79 Checking the Monitoring Data ........................................................................... 79 Removing the JENNIFER Agent Configuration............................................................. 80
7.
Setup for JBoss .................................................................................. 81

UNIX............................................................................................................................... 81
Installation Environment for JBoss................................................................................ 81 Pre Installation Works ................................................................................................... 82 Post Installation Works ................................................................................................. 87 Finalizing Process ......................................................................................................... 87 Registering the License Key .............................................................................. 87 Checking the Monitoring Data ........................................................................... 88 Removing the JENNIFER Agent Configuration............................................................. 88
Windows.......................................................................................................................... 89
Installation Environment for JBoss................................................................................ 89 Installation Environment for JBoss................................................................................ 90 Pre Installation Steps .................................................................................................... 90 Post Installation Works ................................................................................................. 95 Finalizing Process ......................................................................................................... 96 Registering the License Key .............................................................................. 96 Checking the Monitoring Data ........................................................................... 96 Removing the JENNIFER Agent Configuration............................................................. 97
8.
Setup for Oracle Application Server ................................................. 99

UNIX............................................................................................................................... 99
Installation Environment for Oracle Application Server................................................. 99 Pre Installation Works ................................................................................................. 100 Post Installation Works ............................................................................................... 104 Finalizing Process ....................................................................................................... 104 Registering the License Key ............................................................................ 104 Checking the Monitoring Data ......................................................................... 105 Removing the JENNIFER Agent Configuration........................................................... 105
Windows........................................................................................................................ 106
Installation Environment for Oracle Application Server............................................... 106 Pre Installation Works ................................................................................................. 106
Table of Contents
Post Installation Works ................................................................................................ 110 Finalizing Process ....................................................................................................... 111 Registering the License Key ............................................................................ 111 Checking the Monitoring Data.......................................................................... 111 Removing the JENNIFER Agent Configuration ........................................................... 112
9.
Setup for GlassFish .......................................................................... 113

UNIX ............................................................................................................................. 113
Installation Environment for GlassFish ........................................................................ 113 Pre Installation Works.................................................................................................. 114 Post Installation Works ................................................................................................ 118 Finalizing Process ....................................................................................................... 118 Registering License Key .................................................................................. 118 Checking the Monitoring Data.......................................................................... 119 Removing the JENNIFER Agent Configuration ........................................................... 119
Windows ........................................................................................................................ 120

Installation Environment for GlassFish ........................................................................ 120 Pre Installation Works.................................................................................................. 120 Post Installation Works ................................................................................................ 125 Finalizing Process ....................................................................................................... 125 Registering License Key .................................................................................. 125 Checking the Monitoring Data.......................................................................... 126 Removing the JENNIFER Agent Configuration ........................................................... 126
10. Setup for SUN Application Server ................................................... 129

UNIX ............................................................................................................................. 129
Installation Environment for SUN Application Server .................................................. 129 Pre Installation Works.................................................................................................. 130 Post Installation Works ................................................................................................ 134 Finalizing Process ....................................................................................................... 135 Registering the License Key ............................................................................ 135 Checking the Monitoring Data.......................................................................... 135 Removing the JENNIFER Agent Configuration ........................................................... 136
Windows ........................................................................................................................ 136

Installation Environment for SUN Application Server .................................................. 136 Pre Installation Works.................................................................................................. 137 Post Installation Works ................................................................................................ 142 Finalizing Process ....................................................................................................... 143 Registering License Key .................................................................................. 143 Checking the Monitoring Data.......................................................................... 144 Removing the JENNIFER Agent Configuration ........................................................... 144
11. Troubleshooting for Installation ...................................................... 145

Troubleshooting for Installation .................................................................................... 145
Using the env.jsp Program.......................................................................................... 145 Checking the JENNIFER Native Library ..................................................................... 146 Checking the Firewall.................................................................................................. 147 Request for On-line Supports for Installation .............................................................. 147
Table of Contents
Preface
This document comprehensively provides the details of installation guide for installing JENNIFER v4 on widely used Java Application Server(WebSphere, WebLogic, Tomcat, JBoss, JEUS, Resin, Oracle Application Server, Glassfish, Sun Application Server, etc). In addition, this document describes the details of the default configuration options about JENNIFER architecture, the directory structure and network ports. The information about how to configure Java Aapplication Server under UNIX and Windows O/S environment is also included. People who should read this document include technical support engineers for JenniferSoft, customers who operates JENNIFER on a regular basis, as well as people who simply wish to understand the detailed functions of JENNIFER. JENNIFER is an application performance management solution. We believe that JENNIFER can deliver special values and results to people who are in charge of performance tuning for capacity estimation and problem analysis, database performance tuning and the extraction of SQL queries from an application, as well as WAS operators for J2EE/WAS performance management and application developers for application performance improvements. Before reading this document, it is essential for you to have an understanding of the basic environment for the Java Virtual Machine (JVM), be able to develop Java applications and analyze source code, and have sufficient knowledge regarding the installation, organization and operation of the Java Application Server (JAS). In addition, a basic knowledge of TCP/IP and UDP communication network protocols for inter-system communication is required, as well as a minimal understanding of TCP/UDP port setting for systems. In addition, readers should fully understand the concept of a JDBC connection between the Java Application Server and the database and have sufficient knowledge of the specific JDBC connections applied to the system. Readers should have basic knowledge regarding the preparation of database SQL queries. Furthermore, readers should have some general understanding of the architecture of the Web, Java Application Server and DB servers operating in a web-based system and fundamental terminologies for performance analysis, such as visitors, concurrent users, throughputs and response time. This document does not include any content related to operation and management of JENNIFER v4. For specifics on operation and management, you are recommended to refer to the JENNIFER v4 Manual. For further details of the application or specific case studies, you are recommended to refer to an additional guideline or technical notes provided on the JenniferSoft website. Finally, I would like to thank all our customers and supporters, who have given positive feedback on JenniferSoft and its products prior to the release of JENNIFER v4 to the
xv
market, as well as the engineers at our partner companies who are fully devoted to providing technical support.
The team that wrote this book NoMin Park Team Manager JenniferSoft Technical Support Team
No-Min Park is an expert in IBM WebSphere troubleshooting and system analysis. He is currently responsible for overall technical support at JenniferSoft. He also provides Jennifer training, repair and maintenance services for engineers for our partner and customer companies on-site. He verifies all technical issues arising in various OS, from installation to actual operation. He is doing his best to improve product and service quality.
Justin Kim Pre-sales consultant at JenniferSoft

Justin Kim has been working at JenniferSoft since it was established. He is responsible for Jennifer free sales technical supports. He is actively working as a promoter in foreign business markets and is undertaking free sales technical consulting in Korea, USA, Japan and China. He prepares a wide range of technical and training documents and application guidelines. He is establishing technical milestones for the global business of JenniferSoft.
In addition, JenniferSoft R&D center have also made significant contributions by summarizing the Jennifer options and verifying, proofreading and testing the content of this document. In addition, I would like to offer my sincere gratitude for the efforts of Assistant Manager Amie Song from the marketing division, who helped to prepare and edit this manual as a coordinator.
Comments welcome
Your comments will be most beneficial to us! Issues, concerns, and/or any other comments that you have regarding this book can be mailed to:
xvi
E-mail: manual@jennifersoft.com Mail your comments to: 360 Fairview Way Milpitas, CA 95035
Chapter introduction
This document is organized in a certain sequence to help readers to understand the concepts. However, you may skip to the chapters that are most relevant to you if you wish, as each chapter is independent from each other. This document has the following chapters. 1, "JENNIFR Overview" This chapter describes JENNIFER s elements and its archtecture that is needed to install or configure the JENNIFER server and agent.. 2, "JENNIFR Server Installation" This chapter describes installation and configuration of the JENNIFER server. 3, "Set up for WebSphere" This chapter describes pre installation, configuration and option setting works for WebSphere under UNIX and Windows O/S environment. 4, "Set up for WebLogic" This chapter describes pre installation, configuration and option setting works for WebLogic under UNIX and Windows O/S environment. 5, "Set up for Tomcat" This chapter describes pre installation, configuration and option setting works for Tomcat under UNIX and Windows O/S environment. 6, "Set up for Resin" This chapter describes pre installation, configuration and option setting works for Resin under UNIX and Windows O/S environment. 7, "Set up for JBoss" This chapter describes pre installation, configuration and option setting works forJBoss under UNIX and Windows O/S environment. 8, "Set up for Oracle Application Server" This chapter describes pre installation, configuration and option setting works for Oracle Application Server under UNIX and Windows O/S environment. 9, "Set up for GlassFish" This chapter describes pre installation, configuration and option setting works for GlassFish under UNIX and Windows O/S environment. 10, "Set up for Sun Application Server" This chapter describes pre installation, configuration and option setting works for Sun Application Server under UNIX and Windows O/S environment. 11, "Troubleshooting for Installation" It is recommended to follow the procedures of troubleshooting on this chapter if you have exceptions and errors in registering the JENNIFER agent in the JENNIFER server.
xvii
About marks
The following marks are commonly used in this document. Before reading this document, it is essential for you to have an understanding of these marks.
Mark
Arial (Bold) Body Box Courier
Description
Main font, method/class/file/directory name, Code font Ex)
http_service_class = mysys.AServlet;mysys.BServlet
Courier Bold Code bold Ex)
http_service_class = mysys.AServlet;mysys.BServlet
[Menu]-Bold JENNIFER Dashboard menu Ex)
[Dashboard | JENNIFER Dashboard]

[Main menuSub menu] [Delimiter] Main/Sub menu order
Delimiter Ex) [,]
Notice/Warning Reference
Tipbox Ex)
[Transaction Data(32 page)]

Option name
config_refresh_check_interval
xviii
1
JENNIFER Overview
This chapter briefly describes about JENNIFER s elements and its archtecture that is needed to install or configure the JENNIFER server and agent. Please refer to the JENNIFER User Guide for more details not mentioned here.
1.1.
Element Package for JENNIFER

JENNIFER consists of the JENNIFER server, agent, REMON and client. Each elemet has the role as follows: The JENNIFER agent: Be installed in the Java application server to be monitored, and it sends various performance data to the JENNIFER server. The JENNIFER server: Processes the performance data sent from the JENNIFER agent, and stores it in a file and the database. It also manages a variety of configuration information of users, authorities, and menus. The JENNIFER client: It is a web browser (IE 7.0, IE 8.0,FireFox3.x, etc) installed Sun Java Plug-in 1.6.0_10 or higher and provides the insightful JENNIFER monitoring dashboard including real-time performance data.
The REMON:Collects performance and business data from IT resources other than the Java application server where the JENNIFER agent is installed, and helps the JENNIFER server to manage the data.
1.2.
JENNIFER Directory Structure

The JENNIFER directory consists of the server, the agent and the REMON module. Server: It has the files necessary for JENNIFER server operation. Agent: It has the files necessary for JENNIFER agent configuration. REMON: It has the files necessary for making up frameworks to expand monitoring by JENNIFER. Move the JENNIFER agent directory to the server operated by the Java Application Server where the JENNIFER agent is to be installed. Then you can build the JENNIFER monitoring system by following the agent installtion guidence. Move the JENNIFER independent agent directory (REMON) to the server that needs to collect the performance and business data related to IT resources. Then you can build the JENNIFER monitoring system by following the agent installtion guidence.
1.3.
JENNIFER Network Structure

The JENNIFER(server) communicate with user(browser) through two TCP(default:7900, 6701), agent through three UDP(default : 6901, 6902, 6703) and one TCP(default :7750)port. The following diagram describes an network architecture among user(PC), the JENNIFER server and agent. If you have firewalls among them, remove firewalls from your system. Allow above port communication.
Figure 1-1:Network and Java Thread Structure in JENNIFER
1. JENNIFER Overview
1.3.0.1. Communication between the JENNIFER Agent and Server Setting of the UDP Communication Option
The JENNIFER agent sends performance data to the JENNIFER server in UDP. The JENNIFER server receives the performance data through three separate UDP ports. The following three UDP ports are used in the JENNIFER agent configuration file and the server configuration file as well. If you change the port because of the environmental limitation on your system, you also have to change the port information in the both configuration files.
Notice: When you bulild the JENNIFER servr/agent, use the default port as possible. server_udp_runtime_port = 6901
The JENNIFER agent sends the data related to the beginning and end of every transaction through the UDP port set by the server_udp_runtime_port option of the JENNIFER server.
server_udp_listen_port = 6902
The JENNIFER agent sends general performance data such as the service request rate and the mean response time through the UDP port set by the server_udp_listen_port option of the JENNIFER server once every second.
server_udp_lwst_call_stack_port = 6703
The JENNIFER agent sends X-View transaction profile data once every two seconds.
Setting of the TCP Communication Option

agent_tcp_port = 7750
The JENNIFER agent has TCP port to provide the real-time performance data to the JENNIFER server and change the properties. If you set the multiple agents on a server, set the only one port. The default port number is 7750.
Setting of the JENNIFER IP

udp_server_host = localhost(Input the IP operating the JENNIFER server)
If the JENNIFER server is set to a seperated server without the JENNIFER agent, set the IP of the JENNIFER server where the data will be transmitted.
1.3.0.2. Communication between the JENNIFER Server and Client Administration Console Connection Port
The JENNIFER client provides the web-based user interface. You access to the JENNIFER client through 7900 port. When you want to change the port number, set the SARTUP_PORT environment variable into the different port. Then run the JENNIFER server.(startup.sh, startup.bat)
UNIX export STARTUP_PORT=7901 startup.sh WINDOWS set STARTUP_PORT=7901 startup.bat
Applet Communication Port

server_tcp_port = 6701 Java applet used in the JENNIFER dashboard gets the data needed to configure chart and graph from the JENNIFER server through TCP communication.
1.3.0.3. Cautions for Network Organization

The following is a list of items to watch for in network organization. Avoid duplicate use of the same port - If multiple JENNIFER agents are installed in the same computer, then you should use the agent_tcp_port option of the JENNIFER agent to prevent duplicate use of the port. If multiple JENNIFER agents are installed in the same hardware, then use the following options to prevent duplicate uses: server_udp_runtime_port, server_udp_listen_port, server_udp_lwst_call_stack_port, server_tcp_port. Check the firewall - If there is a firewall between the main modules of JENNIFER, you should check to ensure that a port is opened properly.
1. JENNIFER Overview
1
JENNIFER Server Installation
This chapter briefly describes about how to install or configure the JENNIFER server.
1.1.
JENNIFER Server Specification

The following are the minimum hardware specifications for running the JENNIFER Server under the conditions : monitoring less than 10 of JENNIFER Agents with maximum 100 TPS(Transaction Per Second). Table 1-1: JENNIFER Server Specification
Item
CPU Memory Hard Disk OS JAVA VERSION DB
Recommended Specifications
Pentium 4 or higher(Intel) More than 2GB More than 10GB - depending on the system size. Windows, Linux, AIX, HP, Solaris 1.5 or higher Derby(Defalut), Oracle, DB2
The JENNIFER server operates on the most system installed JAVA and the above hardware specification can be changed depending on the system size and data amount.
1.2.
JENNIFER Server Installation
1.2.1. UNIX
To help users understand how to install the JENNIFER server, the following table that contains environment information necessary for installation is presented. This installation guide describes following environment values, and it is recommended to adjust settings customized for each server environment information. Table 1-2: System Environment Variables for Installation of the JENNIFER Server
Environment Variables
Home directory for the JENNIFER server [JAVA_HOME] JENNIFER server s IP Address
Values
/home/jennifer/server
/usr/java15 192.168.0.139
1. Create a new jennifer account and check the /home/jennifer directory. 2. Uncompress the Jennifer zip file in the created directory.
# gzip -d jennifer4.0.3.tar.gz # tar -xvf jennifer4.0.3.tar
3. Set the JAVA_HOME environment variables.

# export JAVA_HOME=/usr/java5
4. Move to /home/jennifer/server/bin(cd /home/jennifer/server/bin).
5. Using the startup.sh file, start the JENNIFER server and check your log.
Notice: When the JENNIFER server is started for the first time, the database table is created. For this reason, it may take a very long time depending on the server specifications. Check the below log in the jennifer.log.yyyymmdd file of the /home/ jennifer/server/logs directory 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: When it is started for the second time and on, it checks the database as follows before starting the JENNIFER server. Checking database.....20081014/220513:done Checking Adm database.....20081014/220513:INF:done 20081014/220513:INF:XViewProfileManager ISAM index generated : 0 20081014/220513:INF:UdpRuntimeListener: udp listening on port 6901 20081014/220514:INF:UdpRuntimeWorkerPool started 10 20081014/220514:INF:UdpSummaryListener: udp listening on port 6902 20081014/220514:INF:XViewCProfileManager ISAM index generated : 0 20081014/220514:INF:UdpSummaryWorkerPool started : 10 20081014/220514:INF:UdpXViewProfileListener: udp listening on port 6703 20081014/220514:INF:DbWorkTxStatManager ISAM index generated : 0 20081014/220514:INF:UdpXViewProfileWorkerPool started 30 20081014/220515:INF:TcpSocketServer: listening port: 6701 20081014/220515:INF:Jennifer4.0.1(2008-10-13) started. 20081014/220515:INF:TcpServerWorkerPool started 80
6. Log-in.
1. JENNIFER Server Installation
If you enter the following URL, which consists of the port number and the domain address or the IP address of the server where the JENNIFER server is installed, the log-in screen will appear. All of the JENNIFER functions can be used after you log in. The default port number for the JENNIFER server is 7900..
http://jennifer_server_ip:7900
If you want to log in, you need to enter your password and click the [Log-in] button. The administrator s ID is admin, and its password is also admin. After you log in for the first time, you are strongly recommended to change the password. In addition, since the grid is implemented in flash files, Adobe Flash Player 9.0 or higher is requird.
1.2.2. Windows
1.2.2.1. JENNIFER Server Installation
The JENNIFER server runs based on Tomcat5.5. You can operates the JENNIFER server after setting the JAVA_HOME environment variables. Table 1-3: System Environment Variables for Installation of the JENNIFER Server
Environment Variables
Home directory for the JENNIFER server [JAVA_HOME] JENNIFER server s IP Address
Values
/home/jennifer/server
/usr/java15 192.168.0.139
1. Uncompress the Jennifer zip file that you downloaded in the JENNIFER installation directory(ex:c:\jennifer). 2. Execute cmd [ Start |Run | cmd input and execute] 3. Check that the JAVA_HOME is set in the Windows environment variables.
C:\Java>echo %JAVA_HOME% C:\Java\jdk16u13
4. If not, set JAVA_HOME environment variables in the [Clicking the right mouse button on the MY Computer icon| Properties |Advanced | Environment Variables].
5. In the cmd, move to the JENNIFER server directory (ex:c:\jennifer\server\bin)and execute the startup.bat file. If you input the new environment variables, reexecute the cmd. You can execute the startup.bat directly in the Explorer.exe. When the JENNIFER server is started for the first time, the database table is created. For this reason, it may take a very long time depending on the server specifications. 6. Log-in. If you enter the following URL, which consists of the port number and the domain address or the IP address of the server where the JENNIFER server is installed, the log-in screen will appear. All of the JENNIFER functions can be used after you log in. The default port number for the JENNIFER server is 7900..
http://jennifer_server_ip:7900
If you want to log in, you need to enter your password and click the [Log-in] button. The administrator s ID is admin, and its password is also admin. After you log in for the first time, you are strongly recommended to change the password. In addition, since the grid is implemented in flash files, Adobe Flash Player 9.0 or higher is requird.
1.3.
JENNIFER Client Setting

The JENNIFER client is web-based, and therefore the user accesses the JENNIFER user interface through a web browser. Since the charts are implemented via Java applets, the web browser that is used must have the Java plug-in. In addition, since the grid is implemented in flash files, a flash player is required.
Operating System
The JENNIFER client supports Microsoft windows XP and Vista. If you choose Windows classic theme on the windows XP, JENNIFER Black skin staly does not displayed properly. You can check the current theme on the [Properties] menu of the context menu by clicking the right mouse button.
Notice: Officially, the JENNIFER client does not support Linux or Mac OS. However, if your operating system can allow the installation of Firefox 3.0 or higher, with the Java plug-in 1.6.0_10 or higher, you should be able to use the JENNIFER client.
Web Browser
Various web browsers are supported, including Microsoft IE 7.0 and 8.0, and Mozilla firefox 3.0.
Warning: IE 6.0 will not be supported. IE 6.0 does not fully meet the web standard inclusing CSS and not support PNG image file clearly. Therefore, JENNIFER does not support IE 6.0. We recommend you to use Firefox 3.0 unless you upgrade it into IE 7.0 or 8.0.
If you want to user JENNIFER, you should set the web browser in such that it can use cookies and Java scripts. Most of web browsers are basically set to use these functions.
Java Plug-in
Since some aspects of the JENNIFER client are implemented via Java applets, you must install the Sun Java plug-in1.6.0_10 or higher.
Warning: JENNIFER 4.0 or higher does not support Microsoft Java VM.
Installing and Uninstalling

To install or uninstall the Java plug-in, you should refer to the Sun Microsystems Java site at (http://java.sun.com/javase/downloads/index.jsp).
Memory Setting
The default amount of maximum Java heap memory that Java applets can use is 96 MB(64 MB up to Java 1.6.0_6 ). You have to set the max/min value of the Java heap memory in order to use the JENNIFER client more stable. In most cases, the default setting is sufficient, but if there are too many agents or if the amount of processing is too great, then you need to set the maximum Java heap memory to a higher amount. In Windows OS, you can set the Java heap memory amount of your Java plug-in as follows. 1. Move to the control panel. 2. Double-click on the Java icon in the control panel, and the Java control panel will appear. Click the Java tab.
Picture 1-1:Java Control Panel
3. If you click the [View] button in the Java applet runtime setting menu, the Java runtime setting screen will appear. If you set multiple Java, select the one that is to be used.
Picture 1-2:Java Runtime Setting
4. For instance, if you want to set the minimum and maximum Java heap memory to 100MB and 150MB, you should enter the following in the Java runtime variable column as follows:
-Xms100m -Xmx150m
The maximum Java heap memory is affected by the computer specifications and environment. If you exceed the maximum setting, the web browser will be shut down or the following error message will appear: Since there is no clear limit for the maximum permissible Java heap memory, a user must find the optimum setting for his or her needs through a process of trial and error.
Web Browser Setting-Java Applet

If you use Microsoft IE 7.0 or IE 8.0, then you should activate the Java plug-in by selecting [Tools | Internet options] from the menu. After clicking the [Advanced] tab in the internet options menu, scroll to the bottom of the list, and you will be able to see the Java plug-in information. Here, you should activate the Java plug-in.
Picture 1-3:Internet Explorer 8.0 Java Plug-in Setting
If you use Mozilla Firefox 3.0, you should activate the Java script by selecting [Tools |Internet Option| Security|Custom Level] from the menu. By default, this option should be activated.
Picture 1-4:Firefox Java Plug-in Setting
Web Browser Setting-Java Script

If you use Microsofts IE 7.0 or 8.0, you should activate the Java script by selecting [Tools |Internet Option| Security|Custom Level] from the menu. By default, this option should be activated.
Flash Player
Some aspects of the JENNIFER client are implemented through flash files. This requires the installation of Adobe Flash Player 9.0 or higher.
10
1.3.0.1. Window Service Registration

1. Use the service.bat to register the JENNIFER server in the Window Service.
Execute cmd and move to the JENNIFER server directory(c:\jennifer\server\bin) Ex) 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: Using CATALINA_BASE: Using JAVA_HOME: Using JVM: C:\jennifer\server C:\jennifer\server C:\Java\jdk16u13 C:\Java\jdk16u13\jre\bin\server\jvm.dll
The service 'JenniferServer' has been installed. Notice : Set the 3rd parameter to be selected by [JENNIFER_SERVER_HOME]\bin.
2. Move to the [ Control pannel | Tool | Service ] menu and check that the JENNIFER server is registered in Window server and start JennfierServer.
11
12
2
Setup for WebSphere
2.1.
UNIX Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installation and Checking process.
2.1.1. Installation Environment for WebSphere

To help users understand how to install the JENNIFER agent, the following table presents the sample environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the file and directory that is under the JENNIFER agent directory into the directory(/home/jennifer/agent) of the server where the WebSphere runs.
13
This installation guide describes the following environment values, and it is recommended to adjust settings customized for each server environment information before proceeding with installation. Table 2-1: Environment for JENNIFER Agent Configuration
Classification
WebSphere s home directory JENNIFER directory agent s home
Directory
/was/WebSphere61/AppServer /home/jennifer/agent
Java home directory JENNIFER server s IP address
/was/WebSphere61/AppServer/java 192.168.0.139
2.1.2. Pre Installation Works

Run the preinstall.sh file in the JENNIFER agent directory.
14
1. Select a type of web application server where the JENNIFER agent is installed. Select 1 for WebSphere.
jennifer@jennifer1:~/agent$ ./preinstall.sh ######################################## ##### Jennifer Agent Pre Installation ## ##### Select Web Application Server ## ######################################## If you could not find your Web Application Server on the below list, contact us via an e-mail: tech@jennifersoft.com 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 (Q:Quit) ===>> 1
2.
15
2. Set the home directory for WebSphere and press the Enter key. In the event of WebSphere, the jennifer.jar file is not copied into a specific directory. Therefore, only the method for setting the class path is presented at this point.
######################################## ##### WAS Home Directory ######## ######################################## This process is for configuring the jennifer.jar file. Type the exact path of the directory for the WAS that you selected. 1)Do you want to use the default WAS HOME [ /usr/WebSphere/AppServer ]? /was/WebSphere61/AppServer WAS Home Directory : /was/WebSphere61/AppServer Access to the admin console --> select the Web Application Server that you want to install JENNIFER agent --> select process definition --> select java virtual machine --> specify the path of jennifer.jar
16
3. After checking the Java home used by WebSphere, you must create the lwst.jdk.jar file. Set the Java home used by WebSphere. In most cases, WebSpherei includes jdk. Check the default value and press the Enter key.
######################################## ##### JDK Home Directory ######## ######################################## 2) Specify the JAVA_HOME directory which is currently used by Web Application Server. Do you want to use the default JAVA_HOME [/was/WebSphere61/AppServer/ java]? [JDK HOME] : /was/WebSphere61/AppServer/java 3) Preinstaller is creating the JENNIFER LWST file. /was/WebSphere61/AppServer/java/jre/lib/core.jar The lwst.jdk.jar file is created successfully. Add the JVM Option. -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar Add the JVM Option. -javaagent:/home/jennifer/agent/lwst.javaagent.jar
4. The native library is used to collect the system CPU and memory information from the Jennfier agent. You must find the native library file suitable for the system, and test it. If the -d64 Java option of WebSphere is used, enter y and press the enter key. Otherwise, just press the Enter key.
4) Set the JENNIFER Native Library. Is Web Application Server running with -d64 option? [y/n] The libjennifer20_linux_32_32.so test is succeeded. The /was/WebSphere61/AppServer/java/bin/libjennifer20.so file is copied successfully. Notice: In this phase, you should check the JENNIFER native library suitable for the system, and copy it unto the directory that can load it. If all the JENNIFER native library fails, you should collect the information on OS/JDK types and versions, and send it to the JENNIFER technical support team at(tech@jennifersoft.com).
2.
17
5. Now you must set the JENNIFER agent setting files. You need to assign an agent name, and it must be three letters long. The setting file will be named as you wish. For other setting information, press the Enter key. Then the default setting will be used.
5) Do you want to customize an agent configuration file? [y/n] Input 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 ] ? Agent configuration is completed...
Table 2-2: Options Necessary for Setting

Option
agent_name license_filename logfile lwst_logfile agent_tcp_port udp_server_host
Description
An agent name. A combination of Alphabets and numbers (3 digits). Set the license file and its path to store the license key. Set the JENNIFER agent s log file and its path. Set the JENNIFER transaction analysis module (LWST) s log file and path Set the bining port for the JENNIFER agent. Set the IP address for the JENNIFER server
6. The following is a summary of the input.

Pre-Installation Summary WAS Type WAS Home Directory JDK Home Directory JENNIFER Agent Directory Agent config file build lwst file : WS56 : /was/WebSphere61/AppServer : /was/WebSphere61/AppServer/java : /home/jennifer/agent : /home/jennifer/agent/W11.conf : lwst.jdk.jar
libjennifer20 library : /was/WebSphere61/AppServer/java/jre/bin
18
2.1.3. Post Installation Works

Set the paths for the library and agent configuration files prepared from the pre instalation works in the WebSphere Java option.
WebSphere Java option setting

1. In the WebSphere management console, select the [ Select Application Server | Define Process | Java Virtual System ] menu. 2. Enter the path for the jennifer.jar file in the class path.
/home/jennifer/agent/jennifer.jar
3. Enter following values in the booth class path. /home/jennifer/agent/lwst.jdk.jar /home/jennifer/agent/lwst.boot.jar 4. Enter following values in the general JVM.
-Djennifer.config=/home/jennifer/agent/W11.conf Warning: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar(WebSphere 6.1 or higher supports JDK 1.5).
ex)-Djennifer.config=/home/jennifer/agent/W11.conf -javaagent:/home/jennifer/agent/ lwst.javaagent.jar 5. Save the setting values.
2.1.4. Finalizing Process

2.1.4.1. Registering the License Key
If you restart WebSphere, the JENNIFER agent will start operating. You must check following items.
Notice: To register the JENNIFER agent into the JENNIFER server, a user must submit a request.
2.
19
1. Check whether the JENNIFER agent log is recorded in the designated file. Check the following messages that signify the start of the JENNIFER agent in the log file.
--------------------------------------Jennifer4.0.0.2(2008-09-22) 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 The libjennifer20.so(sl) shared library is loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].
2. Check whether the JENNIFER license is okay.

2.1.4.2. Checking the Monitoring Data

1. When a user asks a service request, check whether dots are displayed on the X-View. 2. Check if the profile data such as method and SQL is displayed properly when a dot on the X-View is selected.
Notice: If there is no SQL, refer to manual. Resource and JDBC Monitoring of the JENNIFER 4.0
3. See if the classes loaded in the [ Problem Determination | Utility | Loading Class List ] menu appear properly.
2.1.5. Removing the JENNIFER Agent Configuration

1. In the WebSphere management console, select the [Select Application Server | Define Process | Java Virtual System ] menu.
20
2. Delete the jennifer.jar file in the class path. 3. Delete the lwst.boot.jar and lwst.jdk.jar file in the boot class. 4. Delete the -Djennifer.conf file in the general JVM.
Notice: For JDK 1.5 or higher, delete the -javaagent item in the general JVM.
5. Delete the JENNIFER native library file. 6. Restart WebSphere.
2.2.
Windows
2.2.1. Installation Environment for WebSphere

To help users understand how to install the JENNIFER agent, the following table presents the sample environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the file and directory that is under the JENNIFER agent directory into the directory of the server where the WebSphere runs. This installation guide describes the following environment values, and it is recommended to adjust settings customized for each server environment information before proceeding with installation Table 2-3: Environment for JENNIFER Agent Configuration
Classification
WebSphere s home directory JENNIFER directory agent s home
Directory
/was/WebSphere61/AppServer /home/jennifer/agent
/was/WebSphere61/AppServer/java 192.168.0.139
2. Windows
21

Run the preinstall.sh file in the JENNIFER agent directory. 1. Select a type of web application server where the JENNIFER agent is installed. Select 1 for WebSphere.
22
2. Set the home directory for WebSphere and press the Enter key. In the event of WebSphere, the jennifer.jar file is not copied into a specific directory. Therefore, only the method for setting the class path is presented at this step.
#################################################### Step 2. Type Java Application Server Home Directory ##################################################### "This process is for configuring jennifer.jar." Example : c:\JavaApplicationServer\WebSphere60\AppServer\java Type the exact path of directory for selected Java Application Server: c:\JavaApplicationServer\websphere60\appserver Java Application Server Home Directory : c:\JavaApplicationServer\websphere60\appserver "Java Application Server Home Directory Check Success"
3. After checking the Java home used by WebSphere, you must create the lwst.jdk.jar file. Set the Java home used by WebSphere. In most cases, WebSpherei includes jdk. Check the default value and press the Enter key.
##################################################### Step 3. Type JAVA Home Directory ##################################################### Input [JAVA_HOME] which is used for Java Application Server: c:\JavaApplicationServer\websphere60\appserver\java c:\JavaApplicationServer\websphere60\appserver\java is set as JAVA_HOME "Creating lwst.jdk.jar..." "LWST build success"
2. Windows
23
4. The native library is used to collect the system CPU and memory information from the Jennfier agent. You must find the native library file suitable for the system, and test it. If the -d64 Java option of WebLogic is used, enter y and press the enter key. Otherwise, just press the Enter key.
#################################################### 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.
5. Now you must set the JENNIFER agent setting files. You need to assign an agent name, and it must be three letters long. The setting file will be named as you wish. For other setting information, press the Enter key. Then the default setting will be
24
used. If you don t want to this working(In case of choosing n ), the new setting file is not created. In this case, modify the w11.conf or jennifer.conf file based on the environment and use them.
#################################################### Step 5 JENNIFER AGENT CONFIGURATION SETTING #################################################### Do you want to customize agent configuration file ? (Y/N) : y license_filename [ex: c:\jennifer\license.txt] : c:\jennifer\jenniferagent\license.txt agent_name - only 3 char [W11] : A11 logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] : c:\jennifer\jenniferagent\lwst_A11.log agent_tcp_port [7750] : udp_server_host [localhost] : 192.168.0.139 server_udp_runtime_port [6901] : server_udp_listen_port [6902] : server_udp_lwst_call_stack_port [6703] : Will you have any option that you need to change? If "Don't", continue to make configuration file. (Y/N)n "Creating A11.conf..." Agent configuration is completed... Please, proceed with Post - Installation tasks [Pre-Installation is finished]

Option
agent_name license_filename logfile
Description
An agent name. A combination of Alphabets and numbers (3 digits). Set the license file and its path to store the license key. Set the JENNIFER agent s log file and its path.
2. Windows
25
Option
lwst_logfile agent_tcp_port udp_server_host
Description
Set the JENNIFER transaction analysis module (LWST) s log file and path Set the bining port for the JENNIFER agent. Set the IP address for the JENNIFER server
6. Lastly, check the finished setting data.

"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

Set the paths for the library and agent configuration files prepared from the pre instalation works in the WebSphere Java option.
WebSphere Java option setting

1. In the WebSphere management console, select the [ Select Application Server | Define Process | Java Virtual System ] menu. 2. Enter the path for the jennifer.jar file in the class path.
c:\jennifer\jenniferagent\jennifer.jar
3. Enter following values in the booth class path.

c:\jennifer\jenniferagent\lwst.boot.jar c:\jennifer\jenniferagent\lwst.jdk.jar
26
4. Enter following values in the general JVM.

-Djennifer.config=c:\jennifer\jenniferagent\A11.conf -javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar Warning: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar(WebSphere 6.1 or higher supports JDK 1.5).
)-Djennifer.config=c:\jennifer\jenniferagent\A11.conf 5. Save the setting values by clicking the [Save] button.

If you restart WebSphere, the JENNIFER agent will start operating. You must check following items.
Notice: To register the JENNIFER agent into the JENNIFER server, a user must submit a request. However, when you run WebSphere, activate the agent_boot_class of agent configuration file to register the server on the JENNIFER.
--------------------------------------Jennifer4.0.5.0(2009-06-05) started. agent_name=A11 jennifer.config=c:/jennifer/jenniferagent/A11.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 ... Omitted ... java.library.path=... jennifer20.dll shared library loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].
2. Windows
27
2. Register the vaild license number in the [Properties | License Key Management] menu.


1. In the WebSphere management console, select the [Select Application Server | Define Process | Java Virtual System ] menu. 2. Delete the jennifer.jar file in the class path. 3. Delete the lwst.boot.jar and lwst.jdk.jar file in the boot class. 4. Delete the -Djennifer.conf file and javaagnt in the general JVM. 5. Delete the JENNIFER native library file.(ex,
C:\JavaApplicationServer\websphere60\appserver\java\bin\jennifer20.d ll)
6. Restart WebSphere.
28
3
Setup for WebLogic
3.1.
UNIX
3.1.1. Installation Environment for WebLogic

To help users understand how to install the JENNIFER agent, the following table presents the sample environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the file and directory that is under the JENNIFER agent directory into the directory(/home/jennifer/agent) of the server where the WebLogic runs. This installation guide describes the following environment values, and it is recommended to adjust settings customized for each server environment information before proceeding with installation. Table 3-1: Environment for JENNIFER Agent Configuration
Classification
WebLogic s home directory JENNIFER directory agent s home
Directory
/was/bea/weblogic92 /home/jennifer/agent
29
Table 3-1: Environment for JENNIFER Agent Configuration

Classification
Directory
/was/bea/jdk150_11 192.168.0.139

Run the preinstall.sh file in the JENNIFER agent directory. 1. Select a type of web application server where the JENNIFER agent is installed. Select 2 for WebLogic.
30
2. In the event of WebLogic, the jennifer.jar file is not copied into a specific directory. Therefore, only the method for setting the class path is presented at this point. Set the home directory for WebLogic and press the Enter key.
######################################################## 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 Application Server. WebLogic
Do you want to use the default Java Application Server HOME [ /usr/ bea/weblogic ]? /was/bea/weblogic92 WebLogic Application Server Home Directory : /was/bea/weblogic92 Add the /home/jennifer/agent/jennifer.jar classpath on the domain startup script
3. After checking the Java home used by WebLogic, you must create the lwst.jdk.jar file. Set the Java home used by WebLogic.
######################################################## Step 3. Type JAVA Home Directory ######################################################## Specify the JAVA_HOME directory which is used by Java Application Server. There is no default JAVA_HOME directory. Input the JAVA_HOME of the Java Application Server. ===>> /was/bea/jdk150_11 [/was/bea/jdk150_11] is set as JAVA_HOME Creating lwst.jdk.jar .... lwst.jdk.jar is created successfully
3. Setup for WebLogic
31
4. The native library is used to collect the system CPU and memory information from the Jennfier agent. You must find the native library file suitable for the system, and test it. If the -d64 Java option of WebLogic is used, enter y and press the enter key. Otherwise, just press the Enter key
######################################################## Step 4. Jennifer Native library setting ######################################################## Is Web Application Server running with the -d64 option? [y/n] libjennifer20_ibm_ppc64.so test fail libjennifer20_linux_32_32.so test success /was/bea/jdk150_11/jre/lib/i386/server/libjennifer20.so file is copied successfully
32
######################################################## 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 ===>> WL1
license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_WL1.log ] ? lwst_logfile [ /home/jennifer/agent/lwst_WL1.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

Option
Description
33

[Pre-Installation is finished] [ Pre-Installation Summary ] Java Application Server Type Server Java Application Server Home Directory JDK Home Directory Jennifer Agent Directory Agent config file WL1.conf Jennifer LWST file Jennifer Native library file jre/lib/i386/server/libjennifer20.so(sl) : WebLogic Application : /was/bea/weblogic92 : /was/bea/jdk150_11 : /home/jennifer/agent : /home/jennifer/agent/ : lwst.jdk.jar : /was/bea/jdk150_11/

Set the paths for the library and agent configuration files prepared from the pre instalation works in the WebLogic Java option.
WebLogic Java option setting

1. The default environment configuration file of WebLogic is $DOMAIN_HOME/bin/ startWebLogic.sh. 2. Add the path for the jennifer.jar file in the class path of WebLogic configuration file.
CLASSPATH=/home/jennifer/agent/jennifer.jar :"${CLASSPATH}${CLASSPATHSEP}
3. Add the below options in the JAVA_OPTIONS of WebLogic configureation file..

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: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).
34

If you restart WebLogic, the JENNIFER agent will start operating. You must check following items. 1. Check whether the JENNIFER agent log is recorded in the designated file. Check the following messages that signify the start of the JENNIFER agent in the log file.
--------------------------------------JENNIFER 4.0.0.2(2008-09-22) started. agent_name=WL1 jennifer.config=/home/jennifer/agent/WL1.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 .... Omiitted ... sun.boot.library.path=/jdk/sun/java15/jre/lib/i386 java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/ jre/lib/i386:/jdk/sun/java15/jre/../lib/i386 The libjennifer20.so(sl) shared library is loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].


3. When a user submits a request, check whether dots are displayed on the X-View. 4. Check if the profile data such as method and SQL is displayed properly when a dot on the X-View is selected.
Notice: If there is no SQL, refer to Resource and JDBC Monitoringof the JENNIFER 4.0 manual.
35

1. Stop WebLogic. 2. Delete the JENNIFER agent options in the $DOMAIN_HOME/bin/startWebLogic.sh file which is WebLogic configuration file.
JAVA_OPTIONS="-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/ home/jennifer/agent/lwst.boot.jar -Djennifer.config=/home/jennifer/ agent/WL1.conf -javaagent:/home/jennifer/agent/ lwst.javaagent.jar"$JAVA_OPTIONS CLASSPATH=/home/jennifer/agent/jennifer.jar :"${CLASSPATH}${CLASSPATHSEP}
3. Delete the JENNIFER native library file. 4. Restart WebLogic.
3.2.
Windows
3.2.1. Installation Environment for WebLogic

To help users understand how to install the JENNIFER agent, the following table presents the environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the JennfierAgent_installer.exe file into the server where the WebLogic runs. This installation guide describes following environment values, and it is recommended to adjust settings customized for each server environment information. Table 3-3: Environments for JENNIFER Agent Configuration
Claasification
WebLogic s home directory
Directory
c:/was/weblogic8
36
Table 3-3: Environments for JENNIFER Agent Configuration

Claasification
JENNIFER directory agent s home
Directory
c:/JenniferAgent
c:/jdk/sun/java15 192.168.0.139

Run the preinstall.sh file in the JENNIFER agent directory.
37
1. Select a type of web application server where the JENNIFER agent is installed. Select 2 for WebLogic.
################################################### ######### Jennifer Agent Pre-Installation ######### ################################################### ################################################### Step 1. Select Java Application Server ################################################### Send me e-mail at tech@jennifersoft.com, if you can't find Java Application Serv er you would like to install. 1. WebSphere 5.x / 6.x 2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x 3. JEUS 4.x / 5.x 4. OracleAS 10gR3 5. Tomcat 4.x / 5.x 6. Tomcat 6.x 7. Resin 2.x/3.0.x/3.1.x/ 4.0.x 8. Jboss 3.x 9. Jboss 4.x 10. Sun App Server 7.x/8.x/9.x 11. Glassfish 1.x/2.x Select : 2
38
2. In the event of WebLogic, the jennifer.jar file is not copied into a specific directory. Therefore, only the method for setting the class path is presented at this point. Set the home directory for WebLogic and press the Enter key.
################################################### Step 2. Type Java Applicatiion Server Home Directory ################################################### "This process is for configuring jennifer.jar." Example : c:\bea\WebLogic Type the exact path of directory for selected JAS : c:\JavaApplicationServer\weblogic Java Application Server Home Directory : c:\JavaApplicationServer\weblogic "Add classpath $DIR_HOME/jennifer.jar in start script"
3. After checking the Java home used by WebLogic, you must create the lwst.jdk.jar file. Set the Java home used by WebLogic.
################################################### Step 3. Type JAVA Home Directory ################################################### Input [JAVA_HOME] which is used for Java Application Server: C:\Java\jdk16u13 C:\Java\jdk16u13 is set as JAVA_HOME "Creating lwst.jdk.jar..." "LWST build success"
39
4. The native library is used to collect the system CPU and memory information from the Jennfier agent. You must find the native library file suitable for the system, and test it. If the memore size is over 2GB, choose y and if the memory size is less than 2GB, press the n key. .
################################################### Step 4. JENNIFER NATIVE LIBRARY SETTING ################################################### Does your system have 2GB or more MEMORY? (Y/N) : n jennifer20.dll has been copied to C:\Java\jdk16u13\bin successfully.
40
used. If you dont want to this working(In case of choosing n), the new setting file is not created. In this case, modify the w11.conf or jennifer.conf file based on the environment and use them
################################################### Step 5 JENNIFER AGENT CONFIGURATION SETTING ################################################### Do you want to customize agent configuration file ? (Y/N) : y license_filename [ex: c:\jennifer\license.txt] : c:\jennifer\jenniferagent\license.txt agent_name - only 3 char [W11] : A11 logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] : c:\jennifer\jenniferagent\lwst_A11.log agent_tcp_port [7750] : udp_server_host [localhost] : 192.168.0.139 server_udp_runtime_port [6901] : server_udp_listen_port [6902] : server_udp_lwst_call_stack_port [6703] : Will you have any option that you need to change? If "Don't", continue to make configuration file. (Y/N)n "Creating A11.conf..." Agent configuration is completed... Please, proceed with Post - Installation tasks [Pre-Installation is finished]

Option
Description
41
Option
Description
6. The following is a summary of the input

"Pre-Installation is finished" [Pre-Installation Summary] WAS TYPE : WebLogic 7.x/8.x/9.x/10.x WAS HOME DIRECTORY : c:\JavaApplicationServer\weblogic JAVA HOME DIRECTORY : C:\Java\jdk16u13 JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Java\jdk16u13\bin\jennifer20.dll

Set the paths for the library and agent configuration files prepared from the pre instalation works in the WebLogic starting command.(ex:StartWebLogic.cmd).
WebLogic Java option setting

1. The default environment configuration file of WebLogic is %WEBLOGIC_HOME%\bin\startWebLogic.cmd. 2. Add the path for the jennifer.jar file in the class path of WebLogic configuration file.
CLASSPATH=c:\jennifer\jenniferagent\jennifer.jar;%JAVA_HOME%\lib\tools .jar%WL_HOME%\server\lib\weblogic._sp.jar;%WL_HOME%\server\lib\weblogi c.jar;%CLASSPATH%
3. Add the below options in the JAVA_OPTIONS of WebLogic configureation file.

set JAVA_OPTIONS=-Xbootclasspath/ p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lw st.jdk.jar -Djennifer.config=c:\jennifer\jenniferagent\A11.conf -javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar;%JAVA_OPTIONS%
42
Warning: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).
ex)-Djennifer.config=c:\jennifer\jenniferagent\\A11.conf

If you restart WebLogic, the JENNIFER agent will start operating. You must check following items.

--------------------------------------Jennifer4.0.5.0(2009-06-05) started. agent_name=A11 jennifer.config=c:/jennifer/jenniferagent/A11.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 ... Omitted... java.library.path=... jennifer20.dll shared library loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].

43

1. Stop WebLogic. 2. Delete the JENNIFER agent options in the WebLogic start command(es,:startWebLogic.cmd).(such as jennifer.jar, lwst.boot.jar, lwst.jdk.jar, A11.conf, lwst.javaaget.jar) 3. Delete the JENNIFER native library file(ex, C:\Java\jdk16u13\bin\jennifer20.dll). 4. Restart WebLogic.
44
4
Setup for Tomcat
4.1.
UNIX Environment
4.1.1. Installation Environment for the Tomcat

To help users understand how to install the JENNIFER agent, the following table presents the sample environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the file and directory that is under the JENNIFER agent directory into the directory(/home/jennifer/agent) of the server where the Tomcat runs.
45
This installation guide describes the following environment values, and it is recommended to adjust settings customized for each server environment information before proceeding with installation. Table 4-1: Environment for JENNIFER Agent Configuration
Classification
tomcat5 s home directory JENNIFER directory agent s home
Directory
/was/tomcat5 /home/jennifer/agent
/jdk/sun/java15 192.168.0.139

Run the preinstall.sh file in the JENNIFER agent directory. 1. Select a type of web application server where the JENNIFER agent is installed. Select 5 for Tomcat4.x and Tomcat 5.x.
Notice: Select
6 for Tomcat 6.
46
jennifer@jennifer1:~/agent$ ./preinstall.sh ######################################## ##### Jennifer Agent Pre Installation ## ##### Select Web Application Server ## ######################################## Send me e-maile via tech@jennifersoft.com, if you can't find Web Application 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
(Q:Quit)
===>> 5
4. Setup for Tomcat
47
2. Copy the jennifer.jar file into the common/lib directory of the Tomcat home directory. Set the home directory for Tomcat. Input the /was/tomcat5 in the preinstall.sh file and press the Enter.
######################################################## Step 2. Type Java Application Server Home Directory ######################################################## This process is for configuring the jennifer.jar . Type the exact path of directory for the selected Jakarta Tomcat.
Do you want to use the default ava Application Server HOME [ /usr/ local/apache/tomcat ]? /was/tomcat5 Tomcat Home Directory : /was/tomcat5 /was/tomcat5/common/lib/jennifer.jar is copied successful Notice: In case of Tomcat 6, copy jennifer.jar into the /was/tomcat6/lib directory.
3. After checking the JAVA HOME directory of Tomcat, you need to create the lwst.jdk.jar file. Assign the JAVA HOME directory for Tomcat. Input the /jdk/sun/ java15 in the preinstall.sh file and press the Enter.
######################################################## Step 3. Type JAVA Home Directory ######################################################## Specify the JAVA_HOME directory which is used by Java Application Server. There is no default JAVA_HOME directory. Input the JAVA_HOME of the Java Application Server. ===>> /jdk/sun/java15 [/jdk/sun/java15] is set as JAVA_HOME Creating lwst.jdk.jar .... lwst.jdk.jar is created successfully
48
4. The native library is used to collect the system CPU and memory information from the Jennfier agent. You must find the native library file suitable for the system, and test it. If the -d64 Java option of Tomcat is used, enter y and press the enter key. Otherwise, just press the Enter key..
######################################################## Step 4. Jennifer Native library setting ######################################################## Is Web Application Server running with the -d64 option? [y/n] libjennifer20_AMDx86.64.so test fail libjennifer20_linux_32_32.so test success /jdk/sun/java15/jre/lib/i386/server/libjennifer20.so file is copied successfully Notice: After selecting the most appropriate JENNIFER native library to the system, copy the native library to the loadable directory. If every JENNIFER library is not loaded, send an e-mail including OS and JDK information such as type and version(tech@jennifersoft.com).
4. Setup for Tomcat
49
used. If you don t want to create new configuration file(choose n ), the file is not generated. In this case, you can use the w11.conf or jennifer.conf file offered by the JENNIFER after modifying them to the environment.
######################################################## Step 5. Jennifer Agent Configuration setting ######################################################## Do you want to customize an agent configuration file ? [y/n] Input the Agent Name [exactly 3 char] ex) W11 ===>> T11
license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_T11.log ] ? lwst_logfile [ /home/jennifer/agent/lwst_T11.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 192.168.0.139 server_udp_runtime_port [ 6901 ] ? server_udp_listen_port [ 6902 ] ? server_udp_lwst_call_stack_port [ 6703 ] ? The Agent configuration is completed... Please, proceed with Post Installation tasks

Option
Description
50
6. The following is a summary of the input. Please check them.

[Pre-Installation is finished] [ Pre-Installation Summary ] Java Application Server Type Java Application Server Home Directory JDK Home Directory Jennifer Agent Directory Agent config file T11.conf Jennifer LWST file Jennifer Native library file lib/i386/server/libjennifer20.so(sl) : Jakarta Tomcat : /was/tomcat5 : /jdk/sun/java15 : /home/jennifer/agent : /home/jennifer/agent/ : lwst.jdk.jar : /jdk/sun/java15/jre/

Set the paths for the library and agent configuration files prepared from the pre instalation works in the Tomcat Java option.
Tomcat Java option setting

1. The default environment configuration file of Tomcat is /was/tomcat5/bin/catalina.sh and /was/tomcat5/bin/catalina.sh is used in the example. 2. Add the below options in the JAVA_OPTS of Tomcat configureation file for configuring the JENNIFER library and agent.
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: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower). Notice: We recommand you backup the original file before modifying the catalina.sh file.
4. Setup for Tomcat
51

4.1.4.1. Registering License Key
If you restart Tomcat, the JENNIFER agent will start operating. You must check following items.
Notice: To register the JENNIFER agent into the JENNIFER server, a user must submit a first request. However, if you want to register it as starting Tomcat, activate the agent_boot_class option in the JENNIFER agent configuration file.
Check whether the JENNIFER agent log is recorded in the designated file. Check the following messages that signify the start of the JENNIFER agent in the log file 1. Check whether the JENNIFER agent log is recorded in the designated file. Check the following messages that signify the start of the JENNIFER agent in the log file.
--------------------------------------Jennifer4.0.5.0(2009-06-05) started. agent_name=T11 jennifer.config=/home/jennifer/agent/T11.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 ... Omiitted ... sun.boot.library.path=/jdk/sun/java15/jre/lib/i386 java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/ jre/lib/i386:/jdk/sun/java15/jre/../lib/i386 libjennifer20.so(sl) shared library loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].
2. Register the JENNIFER license key in the [Properties | License Management] menu and check whether the JENNIFER license is okay.

1. When a user asks a service request, check whether dots are displayed on the X-View.
52
2. Check if the profile data such as method and SQL is displayed properly when a dot on the X-View is selected.

1. Stop Tomcat. 2. Delete the jennifer.jar file in the /was/tomcat5/common/lib directory.
Notice: In case of Tomcat 6, delete the jennifer.jar file in the /was/tomcat6/lib directory.
3. Delete the JENNIFER agent options in the catalina.sh file which is Tomcat configuration file. 4. Delete the JENNIFER native library file(ex:/jdk/sun/java15/jre/lib/i386/ server/libjennifer20.so). 5. Restart Tomcat.
4.2.
Windows Environment
4.2.1. Installation Environment for Tomcat

To help users understand how to install the JENNIFER agent, the following table presents the environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the JENNIFER agent directory and its file into the server directory where the Tomcat runs.
4. Setup for Tomcat
53
This installation guide describes following environment values, and it is recommended to adjust settings customized for each server environment information. Table 4-3: Environments for JENNIFER Agent Configuration
Classification
Tomcat s home directory JENNIFER directory agent s home
Directory
c:/was/tomcat4 c:/JenniferAgent
c:/jdk/sun/java15 192.168.0.139

Run the preinstall.bat file in the JENNIFER agent directory. 1. Select a type of web application server where the JENNIFER agent is installed. Select 5 forTomcat4.x and Tomcat 5.x.
Notice: Select
6 for Tomcat 6.
54
jennifer@jennifer1:~/agent$ ./preinstall.sh ######################################## ##### Jennifer Agent Pre Installation ## ##### Select Web Application Server ## ######################################## Send me e-maile via tech@jennifersoft.com, if you can't find Web Application 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
(Q:Quit)
===>> 5
4. Setup for Tomcat
55
2. Set the home directory for Tomcat. Copy the jennifer.jar file into the common/lib directory of the Tomcat home directory. Input the c:\JavaApplicationServer\tomcat4 in the preinstall.bat file and press the Enter.
################################################### Step 2. Type Java Application Server Home Directory ################################################### "This process is for configuring jennifer.jar." Example : c:\JavaApplicationServer\tomcat4 Type the exact path of directory for selected Java Application Server: c:\JavaApplicationServer\tomcat4 Java Application Server Home Directory : c:\JavaApplicationServer\tomcat4 "c:\JavaApplicationServer\tomcat4"\common\lib\jennifer.jar copy successful" Notice: In case of Tomcat 6, the jennifer.jar copied in lib directory.
3. Assign the JAVA HOME directory for Tomcat. The lwst.jdk.jar file is created. Input the c:\Java\jdk16u13 and press the Enter.
################################################### Step 3. Type JAVA Home Directory ################################################### Input [JAVA_HOME] which is used for JAS : C:\Java\jdk16u13 C:\Java\jdk16u13 is set as JAVA_HOME "Creating lwst.jdk.jar..." "LWST build success"
56
4. The native library is used to collect the system CPU and memory information from the Jennfier agent. You must find the native library file suitable for the system, and test it. If the -d64 Java option of Tomcat is used, enter y and press the enter key. Otherwise, just press the Enter key..
################################################### Step 4. JENNIFER NATIVE LIBRARY SETTING ################################################### Does your system have 2GB or more MEMORY? (Y/N) : n jennifer20.dll has been copied to C:\Java\jdk16u13\bin successfully.
4. Setup for Tomcat
57
used. If you don t want to create new configuration file(choose n ), the file is not generated. In this case, you can use the w11.conf or jennifer.conf file offered by the JENNIFER after modifying them to the environment.
################################################### Step 5. JENNIFER AGENT CONFIGURATION SETTING ################################################### Do you want to customize agent configuration file ? (Y/N) : y license_filename [ex: c:\jennifer\license.txt] : c:\jennifer\jenniferagent\license.txt agent_name - only 3 char [W11] : A11 logfile [ex: c:\jennifer\logs\W11.log] : c:\jennifer\jenniferagent\A11.log lwst_logfile [ex: c:\jennifer\logs\lwst_W11.log] : c:\jennifer\jenniferagent\lwst_A11.log agent_tcp_port [7750] : udp_server_host [localhost] : 192.168.0.139 server_udp_runtime_port [6901] : server_udp_listen_port [6902] : server_udp_lwst_call_stack_port [6703] : Will you have any option that you need to change? If "Don't", continue to make configuration file. (Y/N)n "Creating A11.conf..." Agent configuration is completed... Please, proceed with Post - Installation tasks [Pre-Installation is finished]

Option
agent_name license_filename
Description
An agent name. A combination of Alphabets and numbers (3 digits). Set the license file and its path to store the license key.
58
Option
logfile lwst_logfile agent_tcp_port udp_server_host
Description
Set the JENNIFER agent s log file and its path. Set the JENNIFER transaction analysis module (LWST) s log file and path Set the bining port for the JENNIFER agent. Set the IP address for the JENNIFER server
6. The following is a summary of the input. Please check them.

"Pre-Installation is finished" [Pre-Installation Summary] WAS TYPE : TOMCAT 4.X/5.5.x WAS HOME DIRECTORY : c:\JavaApplicationServer\tomca4 JAVA HOME DIRECTORY : C:\Java\jdk16u13 JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Java\jdk16u13\bin\jennifer20.dll

Set the paths for the library and agent configuration files prepared from the pre instalation works in the Tomcat Java option.
Tomcat Java option setting

1. The default environment configuration file of Tomcat is %TOMCAT_HOME%\bin\catalina.bat andc:\JavaApplicationServer\tomcat4\bin\catalina.bat is used in the example. 2. Add the below options in the JAVA_OPTS of Tomcat configureation file for configuring the JENNIFER library and agent.
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
4. Setup for Tomcat
59
Warning: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower). Notice: We recommand you backup the original file before modifying the catalina.sh file.


Notice: To register the JENNIFER agent into the JENNIFER server, a user must submit a first request. However, if you want to register it as starting Tomcat, activate the agent_boot_class option in the JENNIFER agent configuration file.
Check whether the JENNIFER agent log is recorded in the designated file. Check the following messages that signify the start of the JENNIFER agent in the log file 1. Check whether the JENNIFER agent log is recorded in the designated file. Check the following messages that signify the start of the JENNIFER agent in the log file.
--------------------------------------Jennifer4.0.5.0(2009-06-05) started. agent_name=A11 jennifer.config=c:/jennifer/jenniferagent/A11.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 ... Omitted ... java.library.path= jennifer20.dll shared library loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].
2. Register the JENNIFER license key in the [Properties | License Management] menu and check whether the JENNIFER license is okay.
60


1. Stop Tomcat. 2. Delete the JENNIFER agent options in the Tomcat c:\JavaApplicationServer\tomcat4\bin\catalina.bat file which is Tomcat configuration file( lwst.boot.jar, lwst.jdk.jar, A11.conf, lwst.javaaget.jar). 3. Delete the c:\JavaApplicationServer\tomcat4\common\lib\jennifer.jar file.
Notice: In case of Tomcat 6, delete the jennifer.jar file.
4. Delete the JENNIFER agent options in the catalina.sh file which is Tomcat configuration file. 5. Delete the JENNIFER native library file(C:\Java\jdk16u13\bin\jennifer20.dll).
4. Setup for Tomcat
61
62
5
Setup for Resin
5.1.
UNIX
5.1.1. Installation Environment for Resin

To help users understand how to install the JENNIFER agent, the following table presents the sample environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the file and directory that is under the JENNIFER agent directory into the directory(/home/jennifer/agent) of the server where the Resin runs. This installation guide describes the following environment values, and it is recommended to adjust settings customized for each server environment information before proceeding with installation. Table 5-1: Environment for JENNIFER Agent Configuration
Classification
Resin s home directory JENNIFER directory agent s home
Directory
/was/resin315 /home/jennifer/agent
63

Classification
Directory
/jdk/sun/java15 192.168.0.139

Run the preinstall.sh file in the JENNIFER agent directory. 1. Select a type of web application server where the JENNIFER agent is installed. Select 7 for Resin.
64
2. Copy the jennifer.jar file into the common/lib directory of the Resin home directory. Set the home directory for Resin. Input the /was/resin315 in the preinstall.sh file and press the Enter.
######################################## ##### WAS Home Directory ######## ######################################## This process is for configuring the jennifer.jar file. Type the exact path of the directory for the WAS that you selected. 1) Do you want to use the default WAS HOME [ /usr/local/resin ]? /was/resin315
WAS Home Directory : /was/resin315 The /was/resin315/lib/jennifer.jar file is copied successfully.
5. Setup for Resin
65
3. After checking the JAVA HOME directory of Resin, you need to create the lwst.jdk.jar file. Assign the JAVA HOME directory for Resin. Input the /jdk/sun/java15 in the preinstall.sh file and press the Enter.
######################################## ##### JDK Home Directory ######## ######################################## 2) Specify the JAVA_HOME directory which is currently used by Web Application Server. There is no default JAVA_HOME. Input JAVA_HOME of WAS Directory. /jdk/sun/java15 [JDK HOME] : /jdk/sun/java15 3) Preinstaller is creating the JENNIFER LWST file. /jdk/sun/java15/jre/lib/rt.jar lwst.jdk.jar is created successfully Add the JVM Option -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar Add the JVM Option -javaagent:/home/jennifer/agent/lwst.javaagent.jar
66
4. The native library is used to collect the system CPU and memory information from the Jennfier agent. You must find the native library file suitable for the system, and test it. If the -d64 Java option of Resin is used, enter y and press the enter key. Otherwise, just press the Enter key..
######################################################## Step 4. Jennifer Native library setting ######################################################## Is Web Application Server running with the -d64 option? [y/n] libjennifer20_ibm_ppc64.so test fail libjennifer20_linux_32_32.so test success /jdk/sun/java15/jre/lib/i386/server/libjennifer20.so file is copied successfully
5. Setup for Resin
67
######################################################## Step 5. Jennifer Agent Configuration setting ######################################################## Do you want to customize an agent configuration file ? [y/n] Input the Agent Name [exactly 3 char] ex) W11 ===>> W13
license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_W13.log ] ? lwst_logfile [ /home/jennifer/agent/lwst_W13.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 192.168.0.139 server_udp_runtime_port [ 6901 ] ? server_udp_listen_port [ 6902 ] ? server_udp_lwst_call_stack_port [ 6703 ] ? The Agent configuration is completed... Please, proceed with Post Installation tasks

Option
Description
68

Pre-Installation Summary WAS Type WAS Home Directory JDK Home Directory Jennifer Agent Directory Agent config file build lwst file libjennifer20 library : RES : /was/resin315 : /jdk/sun/java15 : /home/jennifer/agent : /home/jennifer/agent/w13.conf : lwst.jdk.jar : /jdk/sun/java15/jre/bin

Set the paths for the library and agent configuration files prepared from the pre instalation works in the Resin Java option.
5.1.3.1. Resin 3.1.x Java option setting

1. The default environment configuration file of Resin 3.1.x is /was/resin315/conf/ resin.conf. 2. Add the below options in the JAVA_OPTS of Resin configureation file..
<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: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower.
5.1.3.2. Resin 2.x/3.0.x Java option setting

1. The $RESIN_HOME/bin/httpd.sh file is executing script for the Resin 2.x/3.0x version. 2. Add the below option in the executing script.
-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
5. Setup for Resin
69
Warning: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).

If you restart Resin, the JENNIFER agent will start operating. You must check following items.
Notice: To register the JENNIFER agent, the user must submit a request.
--------------------------------------JENNIFER 4.0.0.2(2008-09-22) started. agent_name=W13 jennifer.config=/home/jennifer/agent/W13.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 Omiitted sun.boot.library.path=/jdk/sun/java15/jre/lib/i386 java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/ jre/lib/i386:/jdk/sun/java15/jre/../lib/i386 The libjennifer20.so(sl) shared library is loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].


70

1. Stop Resin. 2. Delete the jennifer.jar file in the /was/resin315/lib directory.
Notice: In case of Resin 2.1.x and 3.0.x, delete the jennifer.jar in the $RESIN_HOME/lib directory.
3. In case of Resin 3.1.x, delete the JENNIFER agent configuration options in the /was/ resin315/conf/resin.conf file..
Notice: In case of Resin 2.1.x and 3.0.x, delete JENNIFER agent options in the start script. <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>
4. Delete the JENNIFER native library file. 5. Restart Resin.
5.2.
Windows
5. Setup for Resin
71
5.2.1. Installation Environment for Resin

To help users understand how to install the JENNIFER agent, the following table presents the environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the JennfierAgent_installer.exe file into the server where the Resin runs. This installation guide describes following environment values, and it is recommended to adjust settings customized for each server environment information. Table 5-3: Environments for JENNIFER Agent Configuration
Classification
Resin s home directory JENNIFER directory agent s home
Directory
c:/was/Resin c:/JenniferAgent
c:/jdk/sun/java15 192.168.0.139

Run the preinstall.bat file in the JENNIFER agent directory.
72
1. Select a type of web application server where the JENNIFER agent is installed. Select 7 for Resin.
################################################### ######### Jennifer Agent Pre-Installation ######### ################################################### ################################################### Step 1. Select Java Application Server ###################################################
Send me e-mail at tech@jennifersoft.com, if you can't find Java Application Serv er you would like to install.
1. WebSphere 5.x / 6.x 2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x 3. JEUS 4.x / 5.x 4. OracleAS 10gR3 5. Tomcat 4.x / 5.x 6. Tomcat 6.x 7. Resin 2.x/3.0.x/3.1.x/ 4.0.x 8. Jboss 3 9. Jboss 4 10. Sun App Server 7.x/8.x/9.x 11. Glassfish 1.x/2.x
Select : 7
5. Setup for Resin
73
2. Set the home directory for Resin. Copy and input the jennifer.jar file in the %RESIN_HOME%\lib. Input the c:\JavaApplicationServer\resin3 and press the Enter.
################################################### Step 2. Type Java Application Server Home Directory ################################################### "This process is for configuring jennifer.jar." Example : c:\JavaApplicationServer\resin3 Type the exact path of directory for selected Java Application Server: c:\JavaApplicationServer\resin3 Java Application Server Home Directory : c:\JavaApplicationServer\resin3 "c:\JavaApplicationServer\resin3"\lib\jennifer.jar copy successful"
3. Set the JAVA HOME directory of Resin, then the lwst.jdk.jar file will be created. Input theC:\Java\jdk16u13 in the preinstall.sh file and press the Enter..
################################################### Step 3. Type JAVA Home Directory ################################################### Input [JAVA_HOME] which is used for JavaApplicationServer : C:\Java\jdk16u13 C:\Java\jdk16u13 is set as JAVA_HOME "Creating lwst.jdk.jar..." "LWST build success"
74
4. The native library is used to collect the system CPU and memory information from the Jennfier agent. You must find the native library file suitable for the system, and test it. If the memore size is over 2GB, choose y and if the memory size is less than 2GB, press the n key..
################################################### Step 4. JENNIFER NATIVE LIBRARY SETTING ################################################### Does yjennifer20.dll has been copied to C:\Java\jdk16u13\bin successfully.our system have 2GB or more MEMORY? (Y/N) : n
5. Setup for Resin
75
used. If you dont want to this working(In case of choosing n), the new setting file is not created. In this case, modify the w11.conf or jennifer.conf file based on the environment and use them.

Option
Description
76
Option
Description

"Pre-Installation is finished" [Pre-Installation Summary] WAS TYPE : Resin 2.x/3.0.x/3.1.x/ 4.0.x WAS HOME DIRECTORY : c:\JavaApplicationServer\resin3 JAVA HOME DIRECTORY : C:\Java\jdk16u13 JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Java\jdk16u13\bin\jennifer20.dll

Set the paths for the library and agent configuration files prepared from the pre instalation works in the Resin Java option.
5.2.3.1. Resin 3.1.x Java option setting

1. Input the JENNIFER agent configurations in the Resin start command with -J option and start Resin application server. 2. Start command of Resin is c:\JavaApplicationServer\resin2\httpd.exe.
httpd -J-Xbootclasspath/ p:C:\Jennifer\bin\jennifer4042\agent\lwst.boot.jar;C:\Jennifer\bin\jen nifer4042\agent\lwst.jdk.jar -Djennifer.config=C:\Jennifer\bin\jennifer4042\agent\w11.conf Warning: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower.
5. Setup for Resin
77
5.2.3.2. Resin 2.x/3.0.x Java option setting

1. The%RESIN_HOME%\conf\resin.conf file is executing script for the Resin 3.1 version. 2. Add the below option in the <jvm-arg> of configuration file.
<jvm-arg>-Xbootclasspath/ p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lw st.jdk.jar</jvm-arg> <jvm-arg>-Djennifer.config=c:\jennifer\jenniferagent\A11.conf</ jvm-arg> <jvm-arg>.-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar</ jvm-arg> Warning: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).
5.2.3.3. Resin 4.x Java option setting

1. The%RESIN_HOME%\conf\resin.xml file is executing script for the Resin 4.x version. 2. Add the below option in the <jvm-arg> of configuration file.
<jvm-arg>-Xbootclasspath/ p:c:\jennifer\jenniferagent\lwst.boot.jar;c:\jennifer\jenniferagent\lw st.jdk.jar</jvm-arg> <jvm-arg>-Djennifer.config=c:\jennifer\jenniferagent\A11.conf</ jvm-arg> <jvm-arg>.-javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar</ jvm-arg> Warning: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).
78

1. When the Resin starts, the agent works and check the following messages.
Notice: To register the JENNIFER agent into the JENNIFER server, a user must submit a request.. Activate the agent_boot_class in the ajent configuration file to start the Resin at first.
2. Check the JENNIFER agen log file is created and the following message.
--------------------------------------Jennifer4.0.5.0(2009-06-05) started. agent_name=A11 jennifer.config=c:/jennifer/jenniferagent/A11.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 ... Omiitted ... java.library.path= jennifer20.dll shared library loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].

5. Setup for Resin
79

1. Stop Resin. 2. Delete the JENNIFER agent options in the /JavaApplicationServer/resin315/ resin.conf.
Notice: For Resin 2.x, delete the JENNIFER options in the start command.
3. Delete c:\JavaApplicationServer\resin3\lib\jennifer.jar. 4. Delete the JENNIFER native library file.(.C:\Java\jdk16u13\bin\jennifer20.dll) 5. Restart Resin.
80
6
Setup for JBoss
6.1.
UNIX
6.1.1. Installation Environment for JBoss

To help users understand how to install the JENNIFER agent, the following table presents the sample environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the file and directory that is under the JENNIFER agent directory into the directory(/home/jennifer/agent) of the server where the JBoss runs. This installation guide describes the following environment values, and it is recommended to adjust settings customized for each server environment information before proceeding with installation. Table 6-1: Environment for JENNIFER Agent Configuration
Classification
JBoss s home directory
Directory
/was/jboss3 /was/jboss4
81

Classification
JENNIFER directory agent s home
Directory
/home/jennifer/agent
/jdk/sun/java15 192.168.0.139

Run the preinstall.sh file in the JENNIFER agent directory. 1. Select a type of web application server where the JENNIFER agent is installed. Select 8 for JBoss3.
Notice: Select 9 for JBoss 4.x.
82
jennifer@jennifer1:~/agent$ ./preinstall.sh ######################################## ##### Jennifer Agent Pre Installation ## ##### Select Web Application Server ## ######################################## If you could not find your Web Application Server on the below list, contact us via an e-mail: tech@jennifersoft.com 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
(Q:Quit)
===>> 8
6. Setup for JBoss
83
2. Copy the jennifer.jar file into the /was/jboss3/server/default/deploy/ jbossweb-tomcat50.sar directory of the JBoss home directory. Set the home directory for JBoss. Input the /was/jboss3 in the preinstall.sh file and press the Enter.
######################################## ##### WAS Home Directory ######## ######################################## This process is for configuring the jennifer.jar file. Type the exact path of the directory for the WAS that you selected. 1) Do you want use default WAS HOME [ /usr/local/jboss ]? /was/jboss3
WAS Home Directory : /was/jboss3 The /was/jboss3/server/default/deploy/jbossweb-tomcat50.sar/ jennifer.jar is copid successfully. Notice: In case of JBoss 4.x, copy jennifer.jar into the /was/jboss4/server/default/lib
directory.
84
3. After checking the JAVA HOME directory of JBoss, you need to create the lwst.jdk.jar file. Assign the JAVA HOME directory for JBoss. Input the /jdk/sun/java15 in the preinstall.sh file and press the Enter.
######################################## ##### JDK Home Directory ######## ######################################## 2) Specify the JAVA_HOME directory which is currently used by Web Application Server. There is no default JAVA_HOME. Input JAVA_HOME of WAS Directory. / jdk/sun/java15 [JDK HOME] : /jdk/sun/java15 3) Preinstaller is creating the JENNIFER LWST file. /jdk/sun/java15/jre/lib/rt.jar The lwst.jdk.jar is created successfully. Add the JVM Option -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar Add the JVM Option -javaagent:/home/jennifer/agent/lwst.javaagent.jar
4. The native library is used to collect the system CPU and memory information from the Jennfier agent. You must find the native library file suitable for the system, and test it. If the -d64 Java option of JBoss is used, enter y and press the enter key. Otherwise, just press the Enter key..
4) Set the JENNIFER Native Library. Is Web Application Server running with -d64 option ? [y/n] The libjennifer20_linux_32_32.so test is succeeded.
The /jdk/sun/java15/jre/lib/i386/server/libjennifer20.so file is copied successfully.
6. Setup for JBoss
85
######################################################## Step 5. Jennifer Agent Configuration setting ######################################################## Do you want to customize an agent configuration file ? [y/n] Input the Agent Name [exactly 3 char] ex) W11 ===>> JB3
license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_JB3.log ] ? lwst_logfile [ /home/jennifer/agent/lwst_JB3.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 192.168.0.139 server_udp_runtime_port [ 6901 ] ? server_udp_listen_port [ 6902 ] ? server_udp_lwst_call_stack_port [ 6703 ] ? The Agent configuration is completed... Please, proceed with Post Installation tasks

Option
Description
86


Set the paths for the library and agent configuration files prepared from the pre instalation works in the JBoss Java option.
JBoss Java option setting

1. The default environment configuration file of JBoss is /was/jboss3/bin/run.sh. 2. Add the below options in the JAVA_OPTS of JBoss configureation file...
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: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).

If you restart JBoss, the JENNIFER agent will start operating. You must check following items.
6. Setup for JBoss
87
--------------------------------------JENNIFER 4.0.0.2(2008-09-22) started. agent_name=JB4 jennifer.config=/home/jennifer/agent/JB3.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 Omitted sun.boot.library.path=/jdk/sun/java15/jre/lib/i386 java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/ jre/lib/i386:/jdk/sun/java15/jre/../lib/i386 The libjennifer20.so(sl) shared library is loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].


1. Stop JBoss. 2. Delete the JENNIFER agent configuration options in the run.sh file which is JBoss configuration file.
88
3. Delete the jennifer.jar file in the /was/jboss3/server/default/deploy/ jbossweb-tomcat50.sar directory.

Notice: For JBoss 4.x, delete the jennifer.jar file in the /was/jboss4/server/default/lib
directory. 4. Delete the JENNIFER native library file. 5. Restart JBoss.
6.2.
Windows
The JENNIFER agent installation process has three steps: Pre-installation, Post-installation and Finalizing process.

To help users understand how to install the JENNIFER agent, the following table presents the environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the JennfierAgent_installer.exe file into the server where the JBoss runs. This installation guide describes following environment values, and it is recommended to adjust settings customized for each server environment information. Table 6-3: Environments for JENNIFER Agent Configuration
Classification
JBoss s home directory JENNIFER directory agent s home
Directory
c:/was/jboss3 c:/JenniferAgent
c:/jdk/sun/java15 192.168.0.139
6. Setup for JBoss
89

To help users understand how to install the JENNIFER agent, the following table presents the sample environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the file and directory that is under the JENNIFER agent directory into the directory(/home/jennifer/agent) of the server where the JBoss runs. This installation guide describes the following environment values, and it is recommended to adjust settings customized for each server environment information before proceeding with installation. Table 6-1: Environment for JENNIFER Agent Configuration
Classification
JBoss s home directory
Directory
/was/jboss3 /was/jboss4
JENNIFER directory
agent s
home
/home/jennifer/agent
/jdk/sun/java15 192.168.0.139
6.2.3. Pre Installation Steps

Run the preinstall.bat file in the JENNIFER agent directory. 1. Select a type of web application server where the JENNIFER agent is installed. Select 8 for JBoss3.
Notice: Select 9 for JBoss 4.x.
90
1. WebSphere 5.x / 6.x 2. WebLogic 6.x / 7.x / 8.x / 9.x / 10.x 3. JEUS 4.x / 5.x 4. OracleAS 10gR3 5. Tomcat 4.x / 5.x 6. Tomcat 6.x 7. Resin 2.x/3.0.x/3.1.x/ 4.0.x 8. Jboss 3.x 9. Jboss 4.x 10. Sun App Server 7.x/8.x/9.x 11. Glassfish 1.x/2.x
Select : 8
6. Setup for JBoss
91
2. Copy the jennifer.jar file into the %JBOSS_HOME%\server\default\deploy\jbossweb-tomcat50.sar directory of the JBoss home directory. Set the home directory for JBoss. Input the c:\JavaApplicationServer\jboss3 in the preinstall.sh file and press the Enter.
################################################### Step 2. Type Java Application Server Home Directory ################################################### "This process is for configuring jennifer.jar." Example : c:\JavaApplicationServer\jboss3 Type the exact path of directory for selected Java Application Server: c:\JavaApplicationServer\jboss3 Java Application Server Home Directory : c:\JavaApplicationServer\jboss3
/JavaApplicationServer/jboss3 /server/default/deploy/jbossweb-tomcat50.sar
jennifer.jar copy successful"
3. After checking the JAVA HOME directory of JBoss, you need to create the lwst.jdk.jar file. Assign the JAVA HOME directory for JBoss. Input the C:\Java\jdk16u13 in the preinstall.sh file and press the Enter..
################################################### Step 3. Type JAVA Home Directory ################################################### Input [JAVA_HOME] which is used for Java Application Server : C:\Java\jdk16u13 C:\Java\jdk16u13 is set as JAVA_HOME "Creating lwst.jdk.jar..." "LWST build success"
92
4. The native library is used to collect the system CPU and memory information from the Jennfier agent. You must find the native library file suitable for the system, and test it. If the -d64 Java option of JBoss is used, enter y and press the enter key. Otherwise, just press the Enter key.
################################################### Step 4. JENNIFER NATIVE LIBRARY SETTING ################################################### Does your system have 2GB or more MEMORY? (Y/N) : n
6. Setup for JBoss
93

Option
Description
94
Option
Description

"Pre-Installation is finished" [Pre-Installation Summary] WAS TYPE : JBOSS 3.X WAS HOME DIRECTORY : c:\JavaApplicationServer\jboss3 JAVA HOME DIRECTORY : C:\Java\jdk16u13 JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Java\jdk16u13\bin\jennifer20.dll

Set the paths for the library and agent configuration files prepared from the pre instalation works in the JBoss start command.
JBoss Java option setting

1. The default environment configuration file of JBoss is c:\JavaApplicationServer\jboss3\bin\run.bat. 2. Add the below options in the JAVA_OPTS of JBoss configureation file.
JAVA_OPTS=-Xbootclasspath/p:c:\jennifer\jenniferagent\lwst.jdk.jar;c:\jennifer\jenniferagent\lwst.boot.jar fer.config=c:\jennifer\jenniferagent\A11.conf -javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar Warning: For JDK 1.5 or higher, you must add -javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).
-Djenni-
6. Setup for JBoss
95

If you restart JBoss, the JENNIFER agent will start operating. You must check following items.
Notice: To register the JENNIFER agent, the user must submit a request. Activate the agent_boot_class in the ajent configuration file to start the Resin in the starting process.
--------------------------------------Jennifer 4.0.5.0(2009-06-05) started. agent_name=A11 jennifer.config=c:/jennifer/jenniferagent/A11.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 ... Omitted... java.library.path= The libjennifer20.dll shared library is loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].

96

1. Stop JBoss. 1. Delete the JENNIFER agent configuration options in the %JBOSS_HOME%\bin\run.bat file which is JBoss configuration file.(lwst.boot.jar, lwst.jdk.jar, A11.conf, lwst.javaaget.jar) 2. Delete the jennifer.jar file in the %JBOSS_HOME%\server\default\deploy\jbossweb-tomcat50.sar directory.
Notice: For JBoss 4.x, delete the jennifer.jar file in the /was/jboss4/server/default/lib
directory. 3. Delete the JENNIFER native library file. 4. Restart JBoss.
6. Setup for JBoss
97
98
7
Setup for Oracle Application Server
7.1.
UNIX
7.1.1. Installation Environment for Oracle Application Server

To help users understand how to install the JENNIFER agent, the following table presents the sample environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the file and directory that is under the JENNIFER agent directory into the directory(/home/jennifer/agent) of the server where the Oracle application server runs. This installation guide describes the following environment values, and it is recommended to adjust settings customized for each server environment information before proceeding with installation Table 7-1: Environment for JENNIFER Agent Configuration
Classification
OracleAS s home directory JENNIFER directory agent s home
Directory
/was/OracleAS /home/jennifer/agent
99

Classification
Directory
/was/OracleAS/jdk 192.168.0.139

Run the preinstall.sh file in the JENNIFER agent directory. 1. Select a type of web application server where the JENNIFER agent is installed. Select 4 for Oracle Application Server.
100
2. Copy the jennifer.jar file into the $ORACLE_WAS/j2ee/home/lib/api-ext directory of the Oracle Applciation Server. Set the home directory for Oracle Application Server. Input the /was/OracleAS in the preinstall.sh file and press the Enter.
######################################################## Step 2. Type Java Application Server Home Directory ######################################################## This process is for configuring the jennifer.jar . Type the exact path of directory for the selected Server. Oracle Application
Do you want to use the default Java 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
7. Setup for Oracle Application Server
101
3. After checking the JAVA HOME directory of Oracle Application Server, you need to create the lwst.jdk.jar file. Assign the JAVA HOME directory for Oracle Application Server. Input the /was/OracleAS/jdk in the preinstall.sh file and press the Enter.
######################################## ##### JDK Home Directory ######## ######################################## 2) Specify the JAVA_HOME directory which is currently used by Web Application Server. Do you want to use default JAVA_HOME [/was/OracleAS/jdk] ? [JDK HOME] : /was/OracleAS/jdk 3) Preinstaller is creating the JENNIFER LWST file. /was/OracleAS/jdk/jre/lib/rt.jar The lwst.jdk.jar is created successfully. Add the JVM Option -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar Add the JVM Option -javaagent:/home/jennifer/agent/lwst.javaagent.jar
4) Set the JENNIFER Native Library. Is Web Application Server running with -d64 option? [y/n] The libjennifer20_linux_32_32.so test is succeeded. The /was/OracleAS/jdk/jre/lib/i386/server/libjennifer20.so file is copied successfully.
102
5) Do you want to customize an agent configuration file? [y/n] Input Agent Name [exactly 3 char] ex) W11 ===>> OR1
license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_OR1.log ] ? lwst_logfile [ /home/jennifer/agent/lwst_OR1.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 ] ? Agent configuration is completed...

Option
Description

103

Set the paths for the library and agent configuration files prepared from the pre instalation works in the Oracle Application Server Java option.
Oracle Application Server Java option setting

1. The default environment configuration file of Oracle Application Server is /was/ OracleAS/opmn/conf/opmn.xml. 2. Add the below options in the JAVA_OPTS of Oracle Application Server configureation file.
<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: For JDK 1.5 or higher, you must add-javaagent:/home/jennifer/agent/ lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).

If you restart Oracle Application Server, the JENNIFER agent will start operating. You must check following items.
104
--------------------------------------JENNIFER 4.0.0.2(2008-09-22) started. agent_name=OR1 jennifer.config=/home/jennifer/agent/OR1.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 ... Omitted... sun.boot.library.path=/was/OracleAS/jdk/jre/lib/i386 java.library.path=/was/OracleAS/jdk/jre/lib/i386/client:/was/OracleAS/ jdk/jre/lib/i386 The libjennifer20.so(sl) shared library is loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].

Notice: The following steps apply to the JENNIFER client screen.


1. Stop Oracle Application Server. 2. Delete the share.jar file in the /was/OracleAS/ javacache/cachedobjects directory.
105
3. Delete the JENNIFER agent configuration options in the /was/OracleAS/opmn/conf/ opmn.xml file. 4. Delete the JENNIFER native library file. 5. Restart Oracle Application Server.
7.2.
Windows
7.2.1. Installation Environment for Oracle Application Server

To help users understand how to install the JENNIFER agent, the following table presents the environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the JennfierAgent_installer.exe file into the server where the Oracle application server runs. This installation guide describes following environment values, and it is recommended to adjust settings customized for each server environment information Table 7-3: Environments for JENNIFER Agent Configuration
Classification
Oracle Application Server s home directory JENNIFER agent s home directory Java home directory JENNIFER server s IP address
Directory
c:/was/oracleas
c:/JenniferAgent c:/was/oracleas/jdk 192.168.0.139

For pre-installation works, run the preinstall.bat file.
106
1. Select a type of web application server where the JENNIFER agent is installed. Select 4 for Oracle Application Server.
Select : 4
107
2. Copy the jennifer.jar file into the j2ee\home\lib\api-ext directory of the Oracle Applciation Server. Set the home directory for Oracle Application Server. Input the c:\JavaApplicationServer\oraas in the preinstall.sh file and press the Enter.
################################################### Step 2. Type Java Application Server Home Directory ################################################### "This process is for configuring jennifer.jar." Example : c:\JavaApplicationServer\oraas Type the exact path of directory for selected Java Application Server: c:\JavaApplicationServer\oraas Java Application Server Home Directory : c:\JavaApplicationServer\oraas
c:\/JavaApplicationServer\oraas\oraas\j2ee\home\lib\api-ext jennifer.jar copy

successful"
3. After checking the JAVA HOME directory of Oracle Application Server, you need to create the lwst.jdk.jar file. Assign the JAVA HOME directory for Oracle Application Server. Input the c:\JavaApplicationServer\oraas\jdk in the preinstall.sh file and press the Enter.
################################################### Step 3. Type JAVA Home Directory ################################################### Input [JAVA_HOME] which is used for JavaApplicationServer : C:\JavaApplicationServer\oraas\jdk c:\JavaApplicationServer\oraas\jdk is set as JAVA_HOME "Creating lwst.jdk.jar..." "LWST build success"
108
5. Now you must set the JENNIFER agent setting files. You need to assign an agent name, and it must be three letters long. The setting file will be named as you wish. For other setting information, press the Enter key. Then the default setting will be used. If you dont want to this working(In case of choosing n), the new setting file is not created. In this case, modify the w11.conf or jennifer.conf file based on the environment and use them.

Option
agent_name
Description
An agent name. A combination of Alphabets and numbers (3 digits).
109
Option
license_filename logfile lwst_logfile agent_tcp_port udp_server_host
Description
Set the license file and its path to store the license key. Set the JENNIFER agent s log file and its path. Set the JENNIFER transaction analysis module (LWST) s log file and path Set the bining port for the JENNIFER agent. Set the IP address for the JENNIFER server

"Pre-Installation is finished" [Pre-Installation Summary] WAS TYPE : OracleAS 10gR3 WAS HOME DIRECTORY : c:\JavaApplicationServer\oraas JAVA HOME DIRECTORY : c:\JavaApplicationServer\oraas\jdk JENNIFER AGENT DIRECROTY : C:\jennifer\jenniferagent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\jenniferagent\A11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : c:\JavaApplicationServer\oraas\jdk\bin\jennifer20.dll

Set the paths for the library and agent configuration files prepared from the pre instalation works in the Oracle Application Server Java option. 1. The default environment configuration file of Oracle Application Server is %ORACLE_WAS%\opmn\conf\opmn.xml. 2. Add the below options in the JAVA_OPTS of Oracle Application Server configureation file.
<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> Notice: For JDK 1.5 or higher, you must add-javaagent:/home/jennifer/agent/lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).
110

If you restart Oracle Application Server, the JENNIFER agent will start operating. You must check following items.
Notice: To register the JENNIFER agent, the user must submit a request. Activate the agent_boot_class in the ajent configuration file to start the Resin in the starting process.
--------------------------------------Jennifer 4.0.5.0(2009-06-05) started. agent_name=A11 jennifer.config=c:/jennifer/jenniferagent/A11.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 ... Omitted... java.library.path= The libjennifer20.dll shared library is loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].

111

1. Stop Oracle Application Server. 2. Delete the share.jar file in the %ORACLE_WAS%\j2ee\home\lib\api-ext directory. 3. Delete the JENNIFER agent configuration options in the %ORACLE_WAS%\opmn\conf\opmn.xml file. 4. Delete the JENNIFER native library file. 5. Restart Oracle Application Server.
112
8
Setup for GlassFish
8.1.
UNIX
8.1.1. Installation Environment for GlassFish

To help users understand how to install the JENNIFER agent, the following table presents the sample environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the file and directory that is under the JENNIFER agent directory into the directory(/home/jennifer/agent) of the server where the GlassFish runs. This installation guide describes the following environment values, and it is recommended to adjust settings customized for each server environment information before proceeding with installation Table 8-1: Environment for JENNIFER Agent Configuration
Classification
GlassFish s home directory JENNIFER directory agent s home
Directory
/was/glassfish /home/jennifer/agent
113

Classification
Directory
/jdk/sun/java15 192.168.0.139

Run the preinstall.sh file in the JENNIFER agent directory. 1. Select a type of web application server where the JENNIFER agent is installed. Select 11 for GlassFish.
114
2. Copy the jennifer.jar file into the $GLASSFISH_HOME//lib directory of the GlassFish. Set the home directory for GlassFish. Input the /was/glassfish in the preinstall.sh file and press the Enter.
######################################################## Step 2. Type Java Application Server Home Directory ######################################################## This process is for configuring the jennifer.jar . Type the exact path of directory for the selected Sun Glassfish.
Do you want to use the default Java Application Server HOME [ /usr/ local/glassfish ]? /was/glassfish Sun Glassfish Home Directory : /was/glassfish /was/glassfish/lib/jennifer.jar is copied successfully
8. Setup for GlassFish
115
3. After checking the JAVA HOME directory of GlassFish, you need to create the lwst.jdk.jar file. Assign the JAVA HOME directory for GlassFish. Input the /jdk/sun/ java15 in the preinstall.sh file and press the Enter.
######################################## ##### JDK Home Directory ######## ######################################## 2) Specify the JAVA_HOME directory which is currently used by Web Application Server. There is no default JAVA_HOME. Input JAVA_HOME of WAS Directory. /jdk/sun/java15 [JDK HOME] : /jdk/sun/java15 3) Preinstaller is creating the JENNIFER LWST file. /jdk/sun/java15/jre/lib/rt.jar The lwst.jdk.jar file is created successfully Add the JVM Option. -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar Add the JVM Option. -javaagent:/home/jennifer/agent/lwst.javaagent.jar
4) Set the JENNIFER Native Library. Is Web Application Server running with -d64 option ? [y/n] The libjennifer20_linux_32_32.so test is succeeded. /was/glassfish/lib/libjennifer20.so file is copied successfully.
116
used. If you dont want to this working(In case of choosing n), the new setting file is not created. In this case, modify the w11.conf or jennifer.conf file based on the environment and use them..
######################################################## Step 5. Jennifer Agent Configuration setting ######################################################## Do you want to customize an agent configuration file ? [y/n] Input the Agent Name [exactly 3 char] ex) W11 ===>> G01
license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_G01.log ] ? lwst_logfile [ /home/jennifer/agent/lwst_G01.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 192.168.0.139 server_udp_runtime_port [ 6901 ] ? server_udp_listen_port [ 6902 ] ? server_udp_lwst_call_stack_port [ 6703 ] ? The Agent configuration is completed... Please, proceed with Post Installation tasks

Option
Description
117

re-Installation Summary WAS Type WAS Home Directory JDK Home Directory JENNIFER Agent Directory Agent config file build lwst file : WS56 : /was/WebSphere61/AppServer : /was/WebSphere61/AppServer/java : /home/jennifer/agent : /home/jennifer/agent/W11.conf : lwst.jdk.jar

Set the paths for the library and agent configuration files prepared from the pre instalation works in the GlassFish Java option.
GlassFish Java option setting

1. In the GlassFish management console, select the [ Application Server | JVM Setting | JVM Options ] menu. 2. Add the below options in the management console ans save them.
-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: For JDK 1.5 or higher used by GlassFish, you must add -javaagent:/home/jennifer/ agent/lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).

If you restart GlassFish, the JENNIFER agent will start operating. You must check following items.
118
--------------------------------------JENNIFER 4.0.0.2(2008-09-22) started. agent_name=G01 jennifer.config=/home/jennifer/agent/G01.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 Omitted sun.boot.library.path=/jdk/sun/java15/jre/lib/i386 java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/ jre/lib/i386:/jdk/sun/java15/jre/../lib/i386 The libjennifer20.so(sl) shared library is loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].


1. In the GlassFish management console, select the [ Application Server | JVM Setting | JVM Setting | JVM Options ] menu. Delete the JENNIFER agent configurations and save them. 1. Stop GlassFish.
119
2. Delete the jennifer.jar file in the /was/GlassFish/lib directory. 3. Delete the JENNIFER native library file. 4. Restart GlassFish.
8.2.
Windows
8.2.1. Installation Environment for GlassFish

To help users understand how to install the JENNIFER agent, the following table presents the environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the JennfierAgent_installer.exe file into the server where the GlassFish runs. This installation guide describes following environment values, and it is recommended to adjust settings customized for each server environment information Table 8-3: Environments for JENNIFER Agent Configuration
Classification
GlassFish s home directory JENNIFER directory agent s home
Directory
c:\was\glassfish c:\JenniferAgent
c:\jdk\sun\java15 192.168.0.139

120
1. Select a type of web application server where the JENNIFER agent is installed. Select 11 for GlassFish.
Select : 11
121
2. Copy the jennifer.jar file into the $GLASSFISH_HOME//lib directory of the GlassFish. Set the home directory for GlassFish. Input the c:\JavaApplicationServer\glassfish in the preinstall.sh file and press the Enter.
################################################### Step 2. Type Java Application Server Home Directory ################################################### "This process is for configuring jennifer.jar." Example : c:\JavaApplicationServer\glassfish Type the exact path of directory for selected Java Application Server: c:\JavaApplicationServer\glassfish Java Application Server Home Directory : c:\JavaApplicationServer\glassfish
c:\JavaApplicationServer\glassfish \lib jennifer.jar copy successful" 3. After checking the JAVA HOME directory of GlassFish, you need to create the lwst.jdk.jar file. Assign the JAVA HOME directory for GlassFish. Input theC:\Java\jdk16u13 in the preinstall.sh file and press the Enter..
122
123
Table 8-4: Descriptions of Options

Option
Description
Set the agent name. A combination of Alphabets and numbers. Set the license file path where the license key is stored. Set the JENNIFER agent s log file and path.
124
Option
lwst_logfile udp_server_host
Description
Set the JENNIFER transaction analysis module s (LWST) log file and path. Set the IP address for the JENNIFER server where the JENNIFER agent is installed.
6. Proceed with the pre-installation works.

Now, you must set the paths for the library and agent configuration files prepared from the pre- installation work in the GlassFish Java option.
GlassFish Java option setting

1. In the GlassFish management console(http://localhost:4848/), select the [ Application Server | JVM Setting | JVM Options ] menu. 2. In the GlassFish management console, enter the following options and save them.
-Xbootclasspath/ p:c:\JenniferAgent\lwst.boot.jar;c:\JenniferAgent\lwst.jdk.jar -Djennifer.config=c:\JenniferAgent\A11.conf -javaagent:c:\JenniferAgent\lwst.javaagent.jar Warning: For JDK 1.5 or higher used by GlassFish, you must add -javaagent:c:\JenniferAgent\lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).

If you restart GlassFish, the JENNIFER agent will start operating. You must check following items.
Notice: To register the JENNIFER agent, a user must submit a request.
125
--------------------------------------JENNIFER 4.0.0.2(2008-09-22) started. agent_name=A11 jennifer.config=c:/JenniferAgent/A11.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 ... Omitted... java.library.path= The libjennifer20.dll shared library is loaded successfully. --------------------------------------Notice: .As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].

1. When a user asks a service request, check whether dots are displayed on the X-View. 2.Check if the profile and SQL data is displayed properly when a dot on the X-View is selected.
3.See if the cllases loaded in the [ Problem Determination | Utility | Loading Class List] menu appears properly.

1. In the GlassFish management console(http://localhost:4848/), select the [ Application Server | JVM Setting | JVM Options ] menu. 2. Stop GlassFish. 3. Delete the jennifer.jar file in the c:\was\glassfish\lib directory. 4. Delete the JENNIFER native library file.
126
5. Restart GlassFish.
127
128
9
Setup for SUN Application Server
9.1.
UNIX
9.1.1. Installation Environment for SUN Application Server

To help users understand how to install the JENNIFER agent, the following table presents the sample environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the file and directory that is under the JENNIFER agent directory into the directory(/home/jennifer/agent) of the server where the SUN Application Server runs. This installation guide describes the following environment values, and it is recommended to adjust settings customized for each server environment information before proceeding with installation Table 9-1: Environment for JENNIFER Agent Configuration
Classification
SUNWAS s home directory JENNIFER directory agent s home
Directory
/was/SUNWappserver9 /home/jennifer/agent
129

Classification
Directory
/jdk/sun/java15 192.168.0.139

Run the preinstall.sh file in the JENNIFER agent directory. 1. Select a type of web application server where the JENNIFER agent is installed. SUN Select 10 for Application Server.
130
2. Copy the jennifer.jar file into the /was/SUNWappserver9/lib directory of the SUN Application Server. Set the home directory for SUN Application Server. Input the / was/SUNWappserver9 in the preinstall.sh file and press the Enter.
######################################## ##### WAS Home Directory ######## ######################################## This process is for configuring the jennifer.jar file. Type the exact path of the directory for the WAS that you selected. 1) Do you want use default WAS HOME [ /usr/local/SunAppServer ] was/SUNWappserver9 WAS Home Directory : /was/SUNWappserver9 The /was/SUNWappserver9/lib/jennifer.jar file is copied successfully. ? /
9. Setup for SUN Application Server
131
3. After checking the JAVA HOME directory of SUN Application Server, you need to create the lwst.jdk.jar file. Assign the JAVA HOME directory for SUN Application Server. Input the /jdk/sun/java15 in the preinstall.sh file and press the Enter.
######################################## ##### JDK Home Directory ######## ######################################## 2) Specify the JAVA_HOME directory which is currently used by Web Application Server. There is no default JAVA_HOME. Input JAVA_HOME of WAS Directory. /jdk/sun/java15 [JDK HOME] : /jdk/sun/java15 3) Preinstaller is creating the JENNIFER LWST file. /jdk/sun/java15/jre/lib/rt.jar The lwst.jdk.jar file is created successfully Add the JVM Option. -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar Add the JVM Option. -javaagent:/home/jennifer/agent/lwst.javaagent.jar
4) Set the JENNIFER Native Library. Is Web Application Server running with -d64 option? [y/n] The libjennifer20_linux_32_32.so test is succeeded. The /was/SUNWappserver9/lib/libjennifer20.so file is copied successfully.
132
5) Do you want to customize an agent configuration file? [y/n] Input Agent Name [exactly 3 char] ex) W11 ===>> SW1
license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_SW1.log ] ? lwst_logfile [ /home/jennifer/agent/lwst_SW1.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 192.168.0.139 server_udp_runtime_port [ 6901 ] ? server_udp_listen_port [ 6902 ] ? server_udp_lwst_call_stack_port [ 6703 ] ? Agent configuration is completed...

Option
Description

re-Installation Summary WAS Type WAS Home Directory JDK Home Directory JENNIFER Agent Directory Agent config file build lwst file : WS56 : /was/WebSphere61/AppServer : /was/WebSphere61/AppServer/java : /home/jennifer/agent : /home/jennifer/agent/W11.conf : lwst.jdk.jar
133

Set the paths for the library and agent configuration files prepared from the pre instalation works in the SUN Application Server Java option.
SUN Application Server 8.x / 9.x Java option setting

1. In the SUN Application Server management console, select the [ Application Server | JVM Setting | JVM Setting | JVM Options ] menu. 2. Add the below options in the management console ans save them..
-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/ agent/lwst.boot.jar -Djennifer.config=/home/jennifer/agent/SW1.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar Warning: For JDK 1.5 or higher used by SUN Application Server, you must add -javaagent:/ home/jennifer/agent/lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).
SUN Application Server 7 Java option setting

1. The default environment configuration file of SUN Application Server is the /was/ SUNWappserver7/domains/domain1/server1/config/server.xml. 2. Add the below options in the SUN Application Server configuration file...
<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: For JDK 1.5 or higher used by SUN Application Server, you must add -javaagent:/ home/jennifer/agent/lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).
134

If you restart SUN Application Server, the JENNIFER agent will start operating. You must check following items.
--------------------------------------JENNIFER 4.0.0.2(2008-09-22) started. agent_name=SW1 jennifer.config=/home/jennifer/agent/SW1.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 Omitted sun.boot.library.path=/jdk/sun/java15/jre/lib/i386 java.library.path=/jdk/sun/java15/jre/lib/i386/client:/jdk/sun/java15/ jre/lib/i386:/jdk/sun/java15/jre/../lib/i386 The libjennifer20.so(sl) shared library is loaded successfully. --------------------------------------Notice: As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].


135

1. Stop SUN Application Server. 2. Delete the jennifer.jar file in the /was/SUNWappserver9/lib directory. 3. In the SUN Application Server management console, select the [ Application Server | JVM Setting | JVM Options ] menu. Delete the JENNIFER agent configurations and save them.
Notice: For SUN Application Server 7, delete the JENNIFER agent configuration options in the /was/SUNWappserver7/domains/domain1/config/server.xml
4. Delete the JENNIFER native library file. 5. Restart SUN Application Server.
9.2.
Windows
9.2.1. Installation Environment for SUN Application Server

To help users understand how to install the JENNIFER agent, the following table presents the environment information for the JENNIFER server where the JENNIFER agent is installed. Copy the JennfierAgent_installer.exe file into the server where the SUN Application Server runs.
136
This installation guide describes following environment values, and it is recommended to adjust settings customized for each server environment information Table 9-3: Environments for JENNIFER Agent Configuration
Classification
SUN AS s home directory JENNIFER directory agent s home
Directory
c:/was/sunas8 c:/JenniferAgent
c:/jdk/sun/java15 192.168.0.139

137
1. Select a type of web application server where the JENNIFER agent is installed. SUN Select 10 for Application Server.
Select : 10
138
2. Copy the jennifer.jar file into the %SUN_WAS%\lib directory of the SUN Application Server. Set the home directory for SUN Application Server. Input the c:\JavaApplicationServer\sunas8 in the preinstall.sh file and press the Enter. .
################################################### Step 2. Type Java Application Server Home Directory ################################################### "This process is for configuring jennifer.jar." Example : c:\JavaApplicationServer\sunas Type the exact path of directory for selected Java Application Server: c:\JavaApplicationServer\sunas8 Java Application Server Home Directory : c:\JavaApplication Server\sunas8
c:\JavaApplicationServer\sunas8 \lib jennifer.jar copy successful" 3. After checking the JAVA HOME directory of SUN Application Server, you need to create the lwst.jdk.jar file. Assign the JAVA HOME directory for SUN Application Server. Input the C:\Java\jdk16u13 in the preinstall.sh file and press the Ente Sun Application Server..
139
################################################### Step 4. JENNIFER NATIVE LIBRARY SETTING ################################################## Does your system have 2GB or more MEMORY? (Y/N) : n
140
Table 9-4: Descriptions of Options

Option
Description
Set the agent name. A combination of Alphabets and numbers. Set the license file path where the license key is stored. Set the JENNIFER agent s log file and path.
141
Option
lwst_logfile udp_server_host
Description
Set the JENNIFER transaction analysis module s (LWST) log file and path. Set the IP address for the JENNIFER server where the JENNIFER agent is installed.
6. Proceed with the pre-installation works.

Now, you must set the paths for the library and agent configuration files prepared from the pre- installation work in the SUN Application Server Java option.
Sun Application Server 8.x/9.x Java option setting

1. In the management console(http://localhost:4848/), select the [ Application Server | JVM Setting | JVM Options ] menu. 2. Enter the following options and save them..
--Xbootclasspath/ p:c:\JenniferAgent\lwst.boot.jar;c:\JenniferAgent\lwst.jdk.jar -Djennifer.config=c:\JenniferAgent\A11.conf -javaagent:c:\JenniferAgent\lwst.javaagent.jar Warning: For JDK 1.5 or higher used by Sun Application Server, you must add -javaagent:c:\JenniferAgent\lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).
Sun Application Server 7.x Java option setting

Now, you must set the paths for the library and agent configuration files prepared from the pre- installation work in the environment configuration file for SUN Application Server. 1. The default environment configuration file of SUN Application Server is c:\was\sunas7\domains\domain1\server1\config\server.xml.
142
2. Enter the following options in the configuration file for SUN Application Server.][
<jvm-options>-Xms128m -Xmx256m</jvm-options> <jvm-options>-Djennifer.config=c:\JenniferAgent\A11.conf</jvm-options> <jvm-options>-Xbootclasspath/ p:c:\JenniferAgent\lwst.boot.jar;c:\JennfierAgent\lwst.jdk.jar</ jvm-options> <jvm-options>-javaagent:c:\JenniferAgent\lwst.javaagent.jar</jvm-options> Warning: For JDK 1.5 or higher used by Sun Application Server, you must add -javaagent:c:\JenniferAgent\lwst.javaagent.jar but don t set this option for the JDK 1.4 or lower).

If you restart SUN Application Server, the JENNIFER agent will start operating. You must check following items.
Notice: To register the JENNIFER agent, a user must submit a request.
--------------------------------------JENNIFER 4.0.0.2(2008-09-22) started. agent_name=A11 jennifer.config=c:/JenniferAgent/A11.conf agent_tcp_port=7750 udp_server_host=192.168.0.139 ... Omitted... java.library.path= The libjennifer20.dll shared library is loaded successfully. --------------------------------------Notice: .As shown above, if the libjennifer20.so(sl) shared library loaded successfully. message does not appear, refer to [Troubleshotting for Installation].
143

1. When a user asks a service request, check whether dots are displayed on the X-View. 2.Check if the profile and SQL data is displayed properly when a dot on the X-View is selected.
3.See if the cllases loaded in the [ Problem Determination | Utility | Loading Class List] menu appears properly.

Sun Application Server 8.x/9.x
1. In the SUN Application Server management console(http://localhost:4848/), select the [ Application Server | JVM Setting | JVM Options ] menu. 2. Delete the JENNIFER agent configuration options in the management console. 3. Delete the jennifer.jar file in the c:\was\sunas8\lib directory. 4. Delete the JENNIFER native library file. 5. Restart SUN Application Server.
Sun Application Server 7.x

1. Delete the JENNIFER agent configuration options in the c:\was\sunas7\domains\domain1\server1\config\server.xml file.] 2. Delete the jennifer.jar file in the c:\was\sunas7\lib directory. 3. Delete the JENNIFER native library file. 4. Restart SUN Application Server.
144
10
Troubleshooting for Installation
10.1. Troubleshooting for Installation

If you have difficulties in registering the JENNIFER agent in the JENNIFER server (such as the license input window cannot be found), even when the JENNIFER server and agent are configured according to this document, it is recommended to follow the procedures for troubleshooting as follows:
10.1.1.Using the env.jsp Program

The env.jsp file is a program to check the agent environment, and it is located in the / home/jennifer/agent/tuning directory. In the following example, the env.jsp file is copied into the application home directory of the Web Application Server. 1. Call the env.jsp program and check the content. - In your web browser, call the env.jsp program. -Check if lwst.jdk.jar and lwst.boot.jar are set in the sun.boot.classpath path.
145
- Check if the jennifer.config option exists. Check if the path for the agent setting file is correctly set. -Check if the libjennifer20.so(sl) file is copied into the directory registered in java.library.path.
10.1.2.Checking the JENNIFER Native Library

The JENNIFER agents libjennifer20.so(sl) file demonstrates the system/Java process CPU and memory utilization. Even if the library is not installed, the JENNIFER agent can operate successfully because only the above four utilization parameters and the individual transaction CPU utilization are affected. To check if the JENNIFER native library is properly installed, you must look for the following messages in the JENNIFER agent log file:
libjennifer20.so(sl) shared library loaded successfully.
If the JENNIFER native library is abnormal, then the following message will be shown in the JENNIFER agent log file. In this case, you must select the agent in the [Problem Determination | Utilities | System Env.] menu, and check if the key is assigned to the ava.library.path directory and the libjennifer20.so(sl) file is copied into the directory..
libjennifer20.so(sl) shared library loaded failed: java.lang.UnsatisfiedLinkError: no jennifer20 in java.library.path
If you failed to copy the JENNIFER agents native directory into your pre-installation works, or the message says that you do not have an authority, you can log in as a user who has the authority to copy the directory.
4) Jennifer Native Library Settings. Does Web Application Server run with -d64 option ? [y/n] libjennifer20_linux_32_32.so test success cp: cannot create regular file `/jdk/sun/java15/jre/lib/i386/server/ libjennifer20.so': Permission denied MESSAGE: Check if you have permission at the /jdk/sun/java15/jre/lib/ i386/server directory
146
10.1.3.Checking the Firewall

If there is a firewall between the JENNIFER client (web browser), the JENNIFER agent and servers, you must check whether the JENNIFER communication port is open.. Table 10-1: JENNIFER Communication Ports
Communication
JENNIFER server JENNIFER agent -->
Protocols and ports

TCP: At the JENNIFER server where the JENNIFER agent is installed, the unique port set in the agent_tcp_port (ex: 7750) option should be open. UDP: 6901, 6902, 6703
JENNIFER agent JENNIFER server
-->
Web browser --> JENNIFER server
TCP : 7900, 6701
Notice: Using the udptest.sh command in the JENNIFER agent directory, you can check whether the UDP port is opened properly.
ex) udptest.sh [JENNIFER server IP address] [UDP port] [Data size]
10.1.4.Request for On-line Supports for Installation

The JenniferSoft technical support team provides technical support for installation free of charge. If a problem occurs during installation, you must collect the WAS and DBMS data and the basic information of the JENNIFER server/agent along with the results of troubleshooting for installation, and send it to tech@jennifersoft.com. For your information, you can use the version.sh command in the JENNIFER agent direction to obtain the JENNIFER version information.
10. Troubleshooting for Installation
147
148

ZOO Install Guide 4

Загружено:

Сведения о документе

Исходное описание:

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

ZOO Install Guide 4

Загружено:

Авторское право:

Доступные форматы

JENNIFER v4 Installation Guide

JENNIFER v4 Installation Guide

Recent Edition January, 3st 2011

Document Number JS-0810-04

JENNIFER Server Installation .............................................................. 1

JENNIFER Client Setting .................................................................................................. 5

Setup for WebSphere ......................................................................... 13

Setup for WebLogic ............................................................................ 29

Setup for Tomcat................................................................................. 45

Setup for Resin.................................................................................... 63

JENNIFER v4 Installation Guide

Setup for JBoss .................................................................................. 81

Setup for Oracle Application Server ................................................. 99

Setup for GlassFish .......................................................................... 113

Windows ........................................................................................................................ 120

10. Setup for SUN Application Server ................................................... 129

Windows ........................................................................................................................ 136

11. Troubleshooting for Installation ...................................................... 145

JENNIFER v4 Installation Guide

JENNIFER v4 Installation Guide

Justin Kim Pre-sales consultant at JenniferSoft

JENNIFER v4 Installation Guide

[Dashboard | JENNIFER Dashboard]

Delimiter Ex) [,]

[Transaction Data(32 page)]

JENNIFER v4 Installation Guide

Element Package for JENNIFER

JENNIFER Directory Structure

JENNIFER Network Structure

JENNIFER v4 Installation Guide

Figure 1-1:Network and Java Thread Structure in JENNIFER

Setting of the TCP Communication Option

Setting of the JENNIFER IP

JENNIFER v4 Installation Guide

Applet Communication Port

1.3.0.3. Cautions for Network Organization

JENNIFER v4 Installation Guide

JENNIFER Server Specification

JENNIFER Server Installation

3. Set the JAVA_HOME environment variables.

4. Move to /home/jennifer/server/bin(cd /home/jennifer/server/bin).

JENNIFER v4 Installation Guide

1. JENNIFER Server Installation

JENNIFER v4 Installation Guide

JENNIFER Client Setting

1. JENNIFER Server Installation

Installing and Uninstalling

JENNIFER v4 Installation Guide

Picture 1-1:Java Control Panel

1. JENNIFER Server Installation

Picture 1-2:Java Runtime Setting

Web Browser Setting-Java Applet

JENNIFER v4 Installation Guide

Picture 1-3:Internet Explorer 8.0 Java Plug-in Setting

1. JENNIFER Server Installation

Picture 1-4:Firefox Java Plug-in Setting

Web Browser Setting-Java Script

JENNIFER v4 Installation Guide

1.3.0.1. Window Service Registration

1. JENNIFER Server Installation

JENNIFER v4 Installation Guide

2.1.1. Installation Environment for WebSphere

Java home directory JENNIFER server s IP address