JENNIFER 4.5 Installation Guide
JenniferSoft
Table of Contents
Table of Contents ...... iii
1. JENNIFER Server Installation ...... 1
1.1 JENNIFER Server Specification ...... 1
1.2 Install JENNIFER on UNIX ...... 1
1.3 Install JENNIFER Server on WINDOWS ...... 3
1.4 Configure JENNIFER Client ...... 5
1.4.1 Web Browser ...... 5
1.4.2 JAVA Pluggin ...... 5
1.4.2.1 Installing and Uninstalling JENNIFER ...... 5
1.4.3 Memory Setting ...... 6
1.4.4 Web Browser Setting ...... 7
1.4.4.1 Java Applet ...... 7
1.4.4.2 Javascript ...... 8
1.4.4.3 Flash Player ...... 9
1.4.5 Window Service Registry ...... 9
2. Standard JENNIFER Agent Installation ...... 11
2.1 pre-installation Steps ...... 11
2.1.1 Build lwst ...... 11
2.1.2 Find JNI library files appropriate for each system...... 12
2.1.3 Install JENNIFER Agent ...... 12
2.2 post-installation Step ...... 12
2.2.1 Add Java Options in each Java Application Server...... 12
2.2.2 Copy libjennifer20.so(sl) File ...... 12
2.2.3 Changes needed in agent config ...... 12
2.2.4 Configure JDBC ...... 13
iii iv | Table of Contents
2.2.5 Configure License ...... 13
3. Install JENNIFER Agent on WebSphere ...... 15
3.1 UNIX Environment ...... 15
3.1.1 Install on WebSphere Environment ...... 15
3.1.2 Pre-Installation Steps ...... 15
3.1.2.1 Set JAVA_HOME ...... 15
3.1.2.2 Configure Native Library ...... 16
3.1.2.3 Agent Configuration ...... 16
3.1.2.4 Options to Consider ...... 17
3.1.3 Post-Installation Steps ...... 18
3.1.3.1 Copy JNI Files ...... 18
3.1.3.2 Set WebSphere Java Option ...... 18
3.1.3.3 Restart WebSphere and verify configuration ...... 19
3.1.3.4 Removing JENNIFER Agent Configuration ...... 20
3.2 Windows Environment ...... 20
3.2.1 Install on WebSphere Environment ...... 21
3.2.2 Pre-Installation Steps ...... 21
3.2.2.1 SET JAVA_HOME ...... 21
3.2.2.2 Set Native Library ...... 21
3.2.2.3 Configure JENNIFER Agent ...... 22
3.2.2.4 Options to Consider ...... 22
3.2.3 Post-Installation Steps ...... 23
3.2.3.1 Configure JAVA Options for WebSphere ...... 23
3.2.3.2 Restart WebSphere and verify configuration ...... 24
3.2.3.3 Removing JENNIFER Agent Configuration ...... 25
4. Install JENNIFER Agent on WebLogic ...... 27
4.1 UNIX Environment ...... 27
4.1.1 Install on WebLogic Environment ...... 27
4.1.2 Pre-Installation Steps ...... 27
4.1.2.1 Set JAVA_HOME ...... 27
4.1.2.2 Configure Native Library ...... 28
4.1.2.3 Agent Configuration ...... 28
4.1.2.4 Options to Consider ...... 29
4.1.3 Post-Installation Steps ...... 30
4.1.3.1 Copy JNI Files ...... 30 | v
4.1.3.2 WebLogic JAVA Option Configuration ...... 30
4.1.3.3 Restart WebLogic and verify configuration ...... 30
4.1.3.4 Removing JENNIFER Agent Configuration ...... 32
4.2 Windows Environment ...... 32
4.2.1 Install on WebLogic Environment ...... 32
4.2.2 Pre-Installation Steps ...... 32
4.2.2.1 Set JAVA_HOME ...... 32
4.2.2.2 Set Native Library ...... 33
4.2.2.3 Configure JENNIFER Agent ...... 33
4.2.2.4 Options to Consider ...... 34
4.2.3 Post-Installation Steps ...... 34
4.2.3.1 Configure JAVA Options for WebLogic ...... 34
4.2.3.2 Restart WebLogic and verify configuration ...... 35
4.2.3.3 Removing JENNIFER Agent Configuration ...... 36
5. Install JENNIFER Agent on Tomcat ...... 37
5.1 UNIX Environment ...... 37
5.1.1 Install on Tomcat Environment ...... 37
5.1.2 Pre-Installation Steps ...... 37
5.1.2.1 Set JAVA_HOME ...... 37
5.1.2.2 Set Native Library ...... 38
5.1.2.3 Agent Configuration ...... 38
5.1.2.4 Options to Consider ...... 39
5.1.3 Post-Installation Steps ...... 40
5.1.3.1 Copy JNI Files ...... 40
5.1.3.2 Set Tomcat Java Option ...... 40
5.1.3.3 Restart Tomcat and verify configuration ...... 40
5.1.3.4 Removing JENNIFER Agent Configuration ...... 42
5.2 Windows Environment ...... 42
5.2.1 Install on Tomcat Environment ...... 42
5.2.2 Pre-Installation Steps ...... 42
5.2.2.1 Set JAVA_HOME ...... 43
5.2.2.2 Set Native Library ...... 43
5.2.2.3 Configure JENNIFER Agents ...... 43
5.2.2.4 Options to Consider ...... 44
5.2.3 Post-Installation Steps ...... 45 vi | Table of Contents
5.2.3.1 Configure JAVA Options for Tomcat ...... 45
5.2.3.2 Restart Tomcat and verify configuration ...... 45
5.2.3.3 Removing JENNIFER Agent Configuration ...... 46
6. Install JENNIFER Agent Configuration on Resin ...... 47
6.1 UNIX Environment ...... 47
6.1.1 Install on Resin Environment ...... 47
6.1.2 Pre-Installation Steps ...... 47
6.1.2.1 Set JAVA_HOME ...... 47
6.1.2.2 Configure Native Library ...... 48
6.1.2.3 Agent Configuration ...... 48
6.1.2.4 Options to Consider ...... 49
6.1.3 Post-Installation Steps ...... 50
6.1.3.1 Copy JNI Files ...... 50
6.1.3.2 Resin 2.x/3.0.x JAVA Option Configuration ...... 50
6.1.3.3 Resin 3.1.x JAVA Option Configuration ...... 50
6.1.3.4 Resin 4.x JAVA Option Configuration ...... 51
6.1.3.5 Restart Resin and verify configuration ...... 51
6.1.3.6 Removing JENNIFER Agent Configuration ...... 53
6.2 Windows Environment ...... 53
6.2.1 Install on Resin Environment ...... 53
6.2.2 Pre-Installation Steps ...... 54
6.2.2.1 Set JAVA_HOME ...... 54
6.2.2.2 Set Native Library ...... 54
6.2.2.3 Configure JENNIFER Agent ...... 54
6.2.2.4 Options to Consider ...... 55
6.2.3 Post-Installation Steps ...... 56
6.2.3.1 Resin 2.x/3.0.x JAVA Options ...... 56
6.2.3.2 Resin 3.1.x JAVA Option Configuration ...... 56
6.2.3.3 Resin 4.x JAVA Option Configuration ...... 57
6.2.3.4 Restart Resin and verify configuration ...... 57
6.2.3.5 Removing JENNIFER Agent Configuration ...... 58
7. Install JENNIFER Agent on JEUS ...... 59
7.1 UNIX Environment ...... 59
7.1.1 Install on JEUS Environment ...... 59
7.1.2 Pre-Installation Steps ...... 59 | vii
7.1.2.1 Set JAVA_HOME ...... 59
7.1.2.2 Configure Native Library ...... 60
7.1.2.3 Agent Configuration ...... 60
7.1.2.4 Options to Consider ...... 61
7.1.3 Post-Installation Steps ...... 62
7.1.3.1 Copy JNI Files ...... 62
7.1.3.2 JEUS JAVA Option Configuration ...... 62
7.1.3.3 Restart JEUS and verify configuration ...... 62
7.1.3.4 Removing JENNIFER Agent Configuration ...... 64
7.2 Windows Environment ...... 64
7.2.1 Install on JEUS Environment ...... 64
7.2.2 Pre-Installation Steps ...... 64
7.2.2.1 Set JAVA_HOME ...... 65
7.2.2.2 Set Native Library ...... 65
7.2.2.3 Configure JENNIFER Agent ...... 65
7.2.2.4 Options to Consider ...... 66
7.2.3 Post-Installation Steps ...... 67
7.2.3.1 Configure JAVA Options for JEUS ...... 67
7.2.3.2 Restart JEUS and verify configuration ...... 67
7.2.3.3 Removing JENNIFER Agent Configuration ...... 68
8. Install JENNIFER Agent on JBoss ...... 69
8.1 UNIX Environment ...... 69
8.1.1 Install on JBoss Environment ...... 69
8.1.2 Pre-Installation Steps ...... 69
8.1.2.1 Set JAVA_HOME ...... 69
8.1.2.2 Configure Native Library ...... 70
8.1.2.3 Agent Configuration ...... 70
8.1.2.4 Options to Consider ...... 71
8.1.3 Post-Installation Steps ...... 72
8.1.3.1 Copy JNI Files ...... 72
8.1.3.2 JBoss JAVA Option Configuration ...... 72
8.1.3.3 Restart JBoss and verify configuration ...... 72
8.1.3.4 Removing JENNIFER Agent Configuration ...... 74
8.2 Windows Environment ...... 74
8.2.1 Install on JBoss Environment ...... 74 viii | Table of Contents
8.2.2 Pre-Installation Steps ...... 75
8.2.2.1 Set JAVA_HOME ...... 75
8.2.2.2 Set Native Library ...... 75
8.2.2.3 Configure JENNIFER Agent ...... 75
8.2.2.4 Options to Consider ...... 76
8.2.3 Post-Installation Steps ...... 77
8.2.3.1 Configure JAVA Options for JBoss ...... 77
8.2.3.2 Restart JBoss and verify configuration ...... 77
8.2.3.3 Removing JENNIFER Agent Configuration ...... 78
9. Install JENNIFER Agent on Oracle Application Server ...... 79
9.1 UNIX Environment ...... 79
9.1.1 Install on Oracle Application Server Environment ...... 79
9.1.2 Pre-Installation Steps ...... 79
9.1.2.1 Set JAVA_HOME ...... 79
9.1.2.2 Configure Native Library ...... 80
9.1.2.3 Agent Configuration ...... 80
9.1.2.4 Options to Consider ...... 81
9.1.3 Post-Installation Steps ...... 82
9.1.3.1 Copy JNI Files ...... 82
9.1.3.2 Oracle Application Server JAVA Option Configuration ...... 82
9.1.3.3 Restart Oracle Application Server and verify configuration ...... 82
9.1.3.4 Removing JENNIFER Agent Configuration ...... 84
9.2 Windows Environment ...... 84
9.2.1 Install on Oracle Application Server Environment ...... 84
9.2.2 Pre-Installation Steps ...... 84
9.2.2.1 Set JAVA_HOME ...... 85
9.2.2.2 Set Native Library ...... 85
9.2.2.3 Configure JENNIFER Agent ...... 85
9.2.2.4 Options to Consider ...... 86
9.2.3 Post-Installation Steps ...... 87
9.2.3.1 Configure JAVA Options for Oracle Application Server ...... 87
9.2.3.2 Restart Oracle Application Server and verify configuration ...... 87
9.2.3.3 Removing JENNIFER Agent Configuration ...... 88
10. Install JENNIFER Agent on GlassFish ...... 89
10.1 UNIX Environment ...... 89 | ix
10.1.1 Install on GlassFish Environment ...... 89
10.1.2 Pre-Installation Steps ...... 89
10.1.2.1 JAVA_HOME ...... 89
10.1.2.2 Set Native Library ...... 90
10.1.2.3 Agent Configuration ...... 90
10.1.2.4 Options to Consider ...... 91
10.1.3 Post-Installation Steps ...... 92
10.1.3.1 Copy JNI File ...... 92
10.1.3.2 Set GlassFish Java Option ...... 92
10.1.3.3 Restart GlassFish and verify configuration ...... 93
10.1.3.4 Removing JENNIFER Agent Configuration ...... 94
10.2 Windows Environment ...... 94
10.2.1 Install on GlassFish Environment ...... 94
10.2.2 Pre-Installation Steps ...... 95
10.2.2.1 Set JAVA_HOME ...... 95
10.2.2.2 Set Native Library ...... 95
10.2.2.3 Configure JENNIFER Agent ...... 96
10.2.2.4 Options to Consider ...... 96
10.2.3 Post-Installation Steps ...... 97
10.2.3.1 Configure JAVA Options for GlassFish ...... 97
10.2.3.2 Restart GlassFish and verify configuration ...... 97
10.2.3.3 Removing JENNIFER Agent Configuration ...... 99
11. Install JENNIFER Agent on SUN Application Server ...... 101
11.1 UNIX Environment ...... 101
11.1.1 Install on SUN Application Server Environment ...... 101
11.1.2 Pre-Installation Steps ...... 101
11.1.2.1 Set JAVA_HOME ...... 101
11.1.2.2 Configure Native Library ...... 102
11.1.2.3 Agent Configuration ...... 102
11.1.2.4 Options to Consider ...... 103
11.1.3 Post-Installation Steps ...... 104
11.1.3.1 Copy JNI Files ...... 104
11.1.3.2 JAVA Option Configuration for SUN Application Server 7 ...... 104
11.1.3.3 JAVA Option Configuration for SUN Application Server 8.x / 9.x / 10. x ...... 104 x | Table of Contents
11.1.3.4 Restart SUN Application Server and verify configuration ...... 105
11.1.3.5 Removing JENNIFER Agent Configuration ...... 106
11.2 Windows Environment ...... 106
11.2.1 Install on SUN Application Server Environment ...... 106
11.2.2 Pre-Installation Steps ...... 107
11.2.3 Pre-Installation Steps ...... 107
11.2.3.1 Set JAVA_HOME ...... 107
11.2.3.2 Set Native Library ...... 107
11.2.3.3 Configure JENNIFER Agent ...... 108
11.2.3.4 Options to Consider ...... 108
11.2.4 Post-Installation Steps ...... 109
11.2.4.1 Configure JAVA Options for SUN Application Server 7 ...... 109
11.2.4.2 Configure JAVA Options for SUN Application Server 8.x/9.x/10.x . . 109
11.2.4.3 Restart SUN Application Server and verify configuration ...... 109
11.2.4.4 Removing JENNIFER Agent Configuration ...... 111
12. Install JENNIFER Agent on AS400 ...... 113
12.1 Install JENNIFER Agent on AS400 WebSphere ...... 113
12.1.1 WebSphere 6.0 ND, Express Version ...... 113
12.1.1.1 Prerequisite ...... 113
12.1.1.2 WebSphere Configuration Step ...... 114
12.1.2 Install on WebSphere 6.1 ...... 114
12.1.2.1 WebSphere Configuration Step ...... 114
12.1.3 Exceptions in monitoring AS400 WebSphere ...... 115
13. Install JENNIFER Agent in OS390 z/OS ...... 117
13.1 Install JENNIFER Agent on IBM WebSphere, z/OS ...... 117
13.1.1 LWST Build ...... 117
13.1.2 Execute wmond ...... 117
13.1.3 Java Option Configuration in WebSphere ...... 118
14. JENNIFER Agent Installation Troubleshooting ...... 119
14.1 Changing JENNIFER Server Configuration ...... 119
14.1.1 Change Configuration for Client ...... 119
14.1.2 Change Configuration for Agents ...... 120
14.1.3 Agent TCP Connection Options ...... 121
14.2 Install more than one JENNIFER Agent on same server ...... 121
14.3 JENNIFER Agent Installation Troubleshooting ...... 122 | xi
14.3.1 After Agent is installed, Web application won't start properly...... 122
14.3.2 JENNIFER Agent is not registered in JENNIFER Server ...... 123
14.3.3 JENNIFER Agent is registered but Application won't start ...... 123
14.3.4 Invalid License Key Message ...... 123
14.3.5 CPU / Memory monitoring data is not displayed...... 124
14.3.6 There are no data plots in X-View ...... 125
14.3.7 SQL data is not being displayed in X-View profile...... 125
14.3.7.1 Caution when configuring in type 3 method ...... 126
14.3.7.2 JDBC Confituation Steps for each Framework ...... 126
14.3.7.3 If JDBC Connection method is not known...... 127
14.3.7.4 When SQL parameter is now displayed in X-View profiling data . . . 127
14.3.7.5 IF after installing JENNIFER Agent, native Memory Leak occurs...... 127
14.3.7.6 If Application Cookie information cannot be found after installing JE NNIFER Agent...... 127
14.3.7.7 If JENNIFER Agents are installed in multiple processes with same con figuration option ...... 128
14.3.7.8 Request Remote Technical Support ...... 128
1. JENNIFER Server Installation
This chapter briefly describes how to install & configure JENNIFER server.
1.1 JENNIFER Server Specification
Table below describes minimum hardware specifications required for running the JE NNIFER Server while processing 1,000 TPS (Transaction Per Second).
Item Recommended Specification
CPU Intel Pentium 4 or Higher Memory 2GB and Above Hard Disk 10GB and Above - Depends on amount of d ata collection OS Windows, Linux, AIX, HP, Solaris JAVA Version 1.5 or Higher Database Derby(Default), Oracle, DB2, MS-SQL
The JENNIFER server can be installed on most systems which has the above hardwa re specification. Specification may change depending on the size of web system size and amount of data which is processed.
1.2 Install JENNIFER on UNIX
To help users understand how to install the JENNIFER server, this guide uses sample system information. Installation scenario describes in this guide uses sample system v alues as decribed in below table. During actual installation, user must use real syste m value from the user's server.
Environmental Variable Value
1 2 | JENNIFER Server Installation
Environmental Variable Value
JENNIFER Server HOME Directory /home/jennifer/server JAVA_HOME /usr/java15 IP Address 192.168.0.139
1. Create a new jennifer account and confirm creating home directory at /home/je nnifer directory. 2. Uncompress the Jennifer zip file in home directory.
# gzip -d jennifer4.5.2.tar.gz # tar -xvf jennifer4.5.2.tar
3. Set the JAVA_HOME environment variables. 4. Go to /home/jennifer/server/bin
cd /home/jennifer/server/bin
5. Execute startup.sh file, start the JENNIFER server and check the log.
Notice: When the JENNIFER server is started for the first time, the database tables associated with JENNIFER server is also created as seen below. This task may take mo re than few minutes depending on servier specification.
Confirm log in directory, /home/jennifer/server/logs. Log name is jennifer.log.yyyy mmdd
20110530/140340:Checking database..... 20110530/140342:S017:java.sql.SQLException: Schema 'JENNIFER' does not exist 20110530/140342:Checking Adm database..... 20110530/140343:S020:java.sql.SQLException: Schema 'JENNIFER' does not exist 20110530/140343:INF: Creating new tables with: 20110530/140343:INF:The database URL is jdbc:derby:jennifer 20110530/140343:INF:Apache Derby Embedded JDBC Driver Version 10.4.2.0 - (689064) 20110530/140343:INF:Database: Apache Derby 10.4.2.0 - (689064) ..... Notice: From second start of JENNIFER Server and forward, Database will be Install JENNIFER Server on WINDOWS | 3
initiated with following message.
starting the JENNIFER server. 20110530/140646:Checking database..... 20110530/140648:done 20110530/140648:Checking Adm database..... 20110530/140648:INF:done 20110530/140648:INF:XVProfileISAMManager ISAM index generated : 0 20110530/140648:INF:UdpRuntimeListener: udp listening on port 6901 20110530/140649:INF:UdpRuntimeWorkerPool started 10 20110530/140649:INF:UdpSummaryListener: udp listening on port 6902 20110530/140649:INF:UdpSummaryWorkerPool started : 10 20110530/140649:INF:UdpXViewProfileListener: udp listening on port 6703 20110530/140649:INF:UdpXViewProfileWorkerPool started 30 20110530/140650:INF:TcpSocketServer: listening port: 6701 20110530/140650:INF:Jennifer4.5.2(2011-03-03) started. 20110530/140650:INF:http.startup.port=7900 20110530/140650:INF:TcpServerWorkerPool started 80
6. Log-in to JENNIFER Server
Enter the IP Address or domain address of JENNIFER server along with the JENNIFE R port number and navigate to JENNIFER server log-in page. All of the JENNIFER's fe atures can be used after loggin in.
The default port number for the JENNIFER server is 7900.
http://192.168.0.139:7900
When loggin on for the first time, enter the default login ID and password then cli ck the [Log-in] button. The default administrator’ s ID and password is “admin/admin” . After logging in for the first time, changing the log-in ID and password is strongly r ecommended.
In addition, since part of JENNIFER client developed in Flash, Adobe Flash Player 9. 0 or higher is requird.
1.3 Install JENNIFER Server on WINDOWS
The JENNIFER server is based on Tomcat5.5. Like any normal Tomcat, JENNIFER serve r can be used after setting the JAVA_HOME environment variables. 4 | JENNIFER Server Installation
Environmental Variable Value
JENNIFER Server HOME Directory c:\jennifer\server JAVA_HOME C:\Java\jdk16u13 IP Address 192.168.0.139
1. Uncompress the Jennifer zip file in the JENNIFER installation directory (e.g. c:\je nnifer). 2. Execute in cmd, [ Start |Run | cmd input and execute] 3. Confirm that JAVA_HOME is set
C:\Java>echo %JAVA_HOME% C:\Java\jdk16u13
4. If JAVA_HOME is not set, set it manually, [Clicking the right mouse button on th e MY Computer icon| Properties |Advanced | Environment Variables]. 5. Open cmd, go to the JENNIFER server directory (ex:c:\jennifer\server\bin)and execute the startup.bat file. If you have inputed the new environment variables, re-open the cmd first. You can execute the startup.bat directly from the Windo ws Explorer file manager. When the JENNIFER server is started for the first time, the database table is created also so this may take more than few minutes depe nding on the server specifications. 6. Log-in to JENNIFER Server
Enter the IP Address or domain address of JENNIFER server along with the JENNIFE R port number and navigate to JENNIFER server log-in page. All of the JENNIFER's fe atures can be used after loggin in.
The default port number for the JENNIFER server is 7900.
http://192.168.0.139:7900
When loggin on for the first time, enter the default login ID and password then cli ck the [Log-in] button. The default administrator’ s ID and password is “admin/admin” . After logging in for the first time, changing the log-in ID and password is strongly r ecommended.
In addition, since part of JENNIFER client developed in Flash, Adobe Flash Player 9. 0 or higher is requird. Configure JENNIFER Client | 5
1.4 Configure JENNIFER Client
The JENNIFER client is web-based, and therefore the user accesses the JENNIFER
user interface through a web browser. Because JENNIFER Client uses JAVA Applet to draw the charts and Flash to draw the grids, JENNIFER Clients requires that JAVA Plug-in and Flash Player is installed prior to use.
The JENNIFER client supports Microsoft windows XP and Vista. If you choose to us e Windows classic theme on the windows XP, JENNIFER's Black skin style will not dis played properly. Check the theme of Windows by going to [Properties] menu of the by clicking the right mouse button on the desktop.
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 J ava plug-in 1.6.0_10 or higher, you can use the JENNIFER client.
1.4.1 Web Browser
Microsoft IE 7.0, 8.0, and 9.0 and Mozilla Firefox 3.5 is supported by JENNIFER Clien t.
Warning: IE 6.0 will not be supported. IE 6.0 does not fully meet the web 2.0 stan dard including CSS and cannot properly handle PNG image file. Therefore, JENNIFER does not support IE 6.0. We recommend using Firefox 3.5 or upgrade to IE 7.0 or ab ove.
Before using JENNIFER, set the web browser to use cookies and Java scripts. Most of web browsers are by default already set to use these features.
1.4.2 JAVA Pluggin
Sun Java plug-in1.6.0_10 or higher is required for JENNIFER. JENNIFER 4.0 and abov e does not support Microsoft Java VM.
1.4.2.1 Installing and Uninstalling JENNIFER
For instructions on installing or uninstalling the Java plug-in, refer to the Sun Micro-s ystems website at (http://java.sun.com/javase/downloads/index.jsp). 6 | JENNIFER Server Installation
1.4.3 Memory Setting
The default amount of maximum Java heap memory that Java applets can use is 96 MB. You have to set the max/min value of the Java heap memory in order to make J ENNIFER client more stable. In most cases, the default setting is sufficient, but if ther e are too many agents managed by server or if the amount of data processing is mor e than recommended, then set the maximum Java heap memory to a higher amount. 1. Go to Control Panel 2. Double-click on the Java icon to open the control panel. Then click the Java tab.
3. Click the [View] button to open the Java applet runtime setting menu. If there ar e multiple Java installed, select the java version to use. Configure JENNIFER Client | 7
For instance, if you want to set the minimum and maximum Java heap me mory to 100MB and 150MB, you should enter the following value in the Ja va run-time variable column.
-Xms100m -Xmx150m
The maximum amount of Java heap memory which can be set is depended on serv er specifications and environment variables. If set value exceeds the maximum allow ed, the web browser may shut down and/or error message may display. Since there i s no direct way of knowing maximum permissible Java heap memory, user must find the optimum setting for Java heap memory through a process of trial-and-error.
1.4.4 Web Browser Setting
1.4.4.1 Java Applet
When using Microsoft IE 7.0, IE 8.0, or IE 9.0, activate the Java plug-in by going to [Tools | Internet options] from the main menu, then click the [Advanced] tab, scroll t o the bottom of the list, and you will be able to see the Java plug-in information. Fro m here, activate the Java plug-in. 8 | JENNIFER Server Installation
When using Mozilla Firefox 3.x, activate the use of Java plug-in by selecting [Optio ns|Content] from the main menu. By default, this option should be already activated.
1.4.4.2 Javascript
When using Microsoft IE 7.0, IE 8.0, or IE 9.0, activate the JavaScript access by select ing [Tool|Internet Option| Security|Custom Level] from the main menu. By default, th is option should be already activated. Configure JENNIFER Client | 9
When using Mozilla Firefox 3.x, activate the JavScript access by selecting [options| Content] from the main menu. By default, this option should be already activated.
1.4.4.3 Flash Player
JENNIFER uses Flash to render part of its display . Thus installation of Adobe Flash Pla yer 9.0 or higher is necessary for JENNIFER Client to work properly.
1.4.5 Window Service Registry
Use the service.bat to register the JENNIFER server in the Window Service.
Run cmd then go to JENNIFER server directory.
C:\jennifer\server\bin>service.bat install JenniferServer Installing the service 'JenniferServer' ... Using CATALINA_HOME: C:\jennifer\server Using CATALINA_BASE: C:\jennifer\server Using JAVA_HOME: C:\Java\jdk16u13 Using JVM: C:\Java\jdk16u13\jre\bin\server\jvm.dll The service 'JenniferServer' has been installed.
C:\jennifer\server\bin> 10 | JENNIFER Server Installation
The third parameter is service name.
Go to the [ Control pannel | Tool | Service ] menu and check that the JENNIFER ser ver is registered in Window server. restart Jennfier server.
In order to registered in Windows Services, JAVA_HOME must be set. 2. Standard JENNIFER Agent Installation
This document decribes JENNIFER installation instruction for JENNIFER Agent. JENNIF ER agent installation process has three steps: Pre-installation, Post-installation and In stallation-verfication.
2.1 pre-installation Steps
Before installing JENNIFER Agent, gather or generation files necessary.
2.1.1 Build lwst
In order to monitor application performance without being intrusive or burdening th e system with unnecessary overhead, JENNIFER inserts lite yet high-performing data- mining codes into targeted class of Java application without actually altering the sou rce code itself. This technology is known as LWST, a unique brand of Byte-code Impl ementation technology developed by JenniferSoft. Reference JAVA rt.jar(SUN & IBM 1.6), core.jar(IBM 1.4,1.5) , and vm.jar(IBM1.5) within java application server in orde r to generate lwst.jdk.jar file.
JDK Version of 1.5 or above
lwst40.sh jdk15 $JAVA_HOME/jre/lib/rt.jar
For all version before JDK 1.5
lwst40.sh safe $JAVA_HOME/jre/lib/rt.jar
11 12 | Standard JENNIFER Agent Installation
2.1.2 Find JNI library files appropriate for each system.
Test the files in directory $JENNIFER_AGENT_HOME/jni/OS, identify appropriate libra ry files and copy them in directory $JENNIFER_AGENT_HOME .
2.1.3 Install JENNIFER Agent
Configure Agent name, JENNIFER Server's IP/Port in in each agents.
2.2 post-installation Step
Configure options according to applicable JAS(java) type and copy the appropriate fi les
2.2.1 Add Java Options in each Java Application Server.
-Djennifer.config=/home/jennifer/agent/w11.conf -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/l wst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -javaagent:/home/jennifer/agent/lwst.javaagent.jar
2.2.2 Copy libjennifer20.so(sl) File
● Verify with ${agent_home}/tuning/env.jsp
In JAS, execute env.jsp file, then copy ${agent_home}/libjennifer20.so(sl) file to su n.boot.library.path directory in JAS.
● Verfiy after registering Agent
From JENNIFER Client, Problem Determination → Copy ${agent_home}/libjennifer2 0.so(sl) file into directory registered in sun.boot.library.path.
2.2.3 Changes needed in agent config
Change the last part of agent config file as below. post-installation Step | 13
When configured for TX_SERVER, do not make this change
2.2.4 Configure JDBC
Use JNDI(Java Naming and Directory Interface) to identify javax.sql.DataSource objec t within Java applications and retrieve java.sql.Connection object. With this method, JDBC monitoring is possible without additional configuration.
Another way is to use java.sql.DriverManager class within Java application in order to retrieve java.sql.Connection object. In this method, JDBC connection is not pooled, thus JDBC connection count is not monitored.
Third option is to use custom class within Java application which is responsible for managing connection pool, which will retrieve java.sql.Connection object. Connecti on pool library such as Apache DBCP or Redhat Hibernate, Apache iBATIS would fall into this category.
If all options above is not applicable, JDBC Driver의 connect() can be used to monit or JDBC connection activity.
2.2.5 Configure License
License can be configured within agent configuration file and also in Properties → Li cense Key Management in JENNIFER menu.
3. Install JENNIFER Agent on WebSphere
3.1 UNIX Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
3.1.1 Install on WebSphere Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 3-1 Sample Agent Installation Configuration
Sample Environment Directory
JENNIFER Agent Home Directory /home/jennifer/agent JAVA HOME Directory /was/WebSphere/AppServer/java JENNIFER Server IP Address 192.168.0.139
3.1.2 Pre-Installation Steps
Run the preinstall.sh file in the JENNIFER agent directory.
3.1.2.1 Set JAVA_HOME
Set JAVA_HOME directory used by Websphere. After checking the JAVA_HOME use d by WebSphere, generate lwst.jdk.jar file.
15 16 | Install JENNIFER Agent on WebSphere
######################################################## Step 1. Build LWST ########################################################
Type the JAVA_HOME directory which is used by Java Application Server.
Input [JAVA_HOME] which is used for Java Application Server. ===>> /was/WebSphere/AppServer/java [/was/WebSphere/AppServer/java] is set as JAVA_HOME
Creating lwst.jdk.jar ....
LWST(lwst.jdk.jar) build successful
3.1.2.2 Configure Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify appropriate native library for installed system then execut e test.sh to verify it. Copy libjennifer20.so(sl) which has passed the test sucessfully to Agent Home directory.
######################################################## Step 2. JENNIFER NATIVE LIBRARY SETTING ########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/home/jennifer/agent/libjennifer20.so file is copied successfully
3.1.2.3 Agent Configuration
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi UNIX Environment | 17
fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
######################################################## Step 3. JENNIFER AGENT CONFIGURATION SETTING ######################################################## Do you want to customize agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char] ex) W11 ===>> X11 license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_X11.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 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 [Pre-Installation is finished]
표 3-2 Options for JENNIFER Configuration Files
Option Description
agent_name Agent name composed in 3 alpha-numeric c haracters license_filename Set name and directory of file which stores JE NNIFER License Key logfile Set name and directory of file which stores JE NNIFER Log files agent_tcp_port Set Port which will bind to JENNIFER Agent udp_server_host Set IP Address of server machine where JENN IFER Server is installed
3.1.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where WebSphere option is applied.
[ Pre-Installation Summary ] JDK Home Directory : /was/WebSphere/AppServer/java Jennifer Agent Home Directory : /home/jennifer/agent Agent config file : /home/jennifer/agent/X11.conf 18 | Install JENNIFER Agent on WebSphere
Jennifer LWST file : lwst.jdk.jar Jennifer Native library file : /home/jennifer/agent/libjennifer20.so(sl)
####################################################################### Please add the following configuration to your web application Server ####################################################################### -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/ lwst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -Djennifer.config=/home/jennifer/agent/X11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
3.1.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in WebSphere, JAVA option.
3.1.3.1 Copy JNI Files
Copy /home/jennifer/agent/libjennifer20.so(sl) file which has successfully passed JNI test in sun.boot.library.path directory of JDK in use.
3.1.3.2 Set WebSphere Java Option
In the WebSphere management console, select the [Select Application Server | Defin e Process | Java Virtual System ] menu. 1. Enter below value in boot class path.
/home/jennifer/agent/jennifer.boot.jar /home/jennifer/agent/lwst.jdk.jar /home/jennifer/agent/lwst.boot.jar
2. Enter below value in JVM
-Djennifer.config=/home/jennifer/agent/W11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
For JAVA version below JDK 1.5, DO NOT use option javaagent:/home/jen nifer/agent/ UNIX Environment | 19
lwst.javaagent.jar.
3. Save the inputted values.
3.1.3.3 Restart WebSphere and verify configuration
1. Register License Key
Restarting WebSphere triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=/home/jennifer/agent/X11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=/home/jennifer/agent/license.txt :ExpireDate: 2011-06-28 logfile=/home/jennifer/agent/jennifer_X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ------jvm.current.directory=/was/WebSphere/AppServer/bin OS/Java=Linux,,Java(TM) SE Runtime Environment,Java HotSpot(TM) Server VM,10.0-b23 sun.boot.class.path==/home/jennifer/agent/jennifer.boot.jar:/home/jennifer/ agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar ... sun.boot.library.path=/was/WebSphere/AppServer/java/jre/lib/i386 ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes 20 | Install JENNIFER Agent on WebSphere
sage does not appear, refer to [Troubleshooting for Installation] in installation guide.
● Register the valid license number in the [Properties | License Key Management] menu.
1. Verify Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
3.1.3.4 Removing JENNIFER Agent Configuration
1. In the WebSphere management console, select the [Select Application Server | D efine Process | Java Virtual System ] menu. 2. Delete lwst.boot.jar, jennifer.boot.jar and lwst.jdk.jar files from boot class. 3. Delete the -Djennifer.conf file and -javaagnt from JVM. 4. Delete JENNIFER Native library (e.g. /was/WebSphere/AppServer/java/jre/lib/i38 6/libjennifer20.so) 5. Restart WebSphere.
3.2 Windows Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion
and Checking process. Windows Environment | 21
3.2.1 Install on WebSphere Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 3-3 Sample JENNIFER Agent Configuration
Sample Environment Directory
JENNIFER Agent Home Directory c:\jennifer\agent JAVA Home Directory c:\was\WebSphere\AppServer\java JENNIFER Server IP Address 192.168.0.139
3.2.2 Pre-Installation Steps
From JENNIFER Agent Directory, execute preinstall.bat file under administrator privil ege
3.2.2.1 SET JAVA_HOME
Set JAVA HOME directory used by WebSphere then generate lwst.jdk.jar file.
################################################### Step 1. Build LWST ###################################################
Input [JAVA_HOME] which is used for Java Application Server (Enter "q" to quit):c:\was\WebSphere\AppServer\java c:\was\WebSphere\AppServer\java is set as JAVA_HOME "Creating lwst.jdk.jar..."
"LWST build successful"
lwst.jdk.jar is created successfully
3.2.2.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify the native library file suitable for installed system, then te 22 | Install JENNIFER Agent on WebSphere
st it. If the memory size is over 2GB, select ‘y’ key, otherwise, select ‘n’ key.
################################################### Step 2. JENNIFER NATIVE LIBRARY SETTING ################################################### Does your system have more than 2GB ?(Y/N) : y jennifer20.dll has been copied to c:\was\WebSphere\AppServer\java\bin successfully.
3.2.2.3 Configure JENNIFER Agent
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
################################################### Step 3. JENNIFER AGENT CONFIGURATION SETTING ###################################################
Do you want to customize agent configuration file at this time? (Y/N) : y license_filename [ex: C:\jennifer\agent\license.txt] : Pleaes enter AGENT name. AGENT name must be 3 characters long, first charater must be alphabet anemaining characters must be numbers e.g. [W11] : X11 logfile [ex: C:\jennifer\agent\X11.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] :
Do you have any option(s) that you want to change?(Y/N)n
3.2.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where WebSphere option is applied. Windows Environment | 23
[Pre-Installation Summary] JAVA HOME DIRECTORY : C:\was\WebSphere\AppServer\java JENNIFER AGENT DIRECROTY : C:\jennifer\agent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\agent\X11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\was\WebSphere\AppServer\java\bin\jennifer20.dll
[Post-Installation options] -Xbootclasspath/p:C:\jennifer\agent\lwst.boot.jar;C:\jennifer\agent\jennife r.boot.jar;C:\jennifer\agent\lwst.jdk.jar -Djennifer.config=C:\jennifer\agent\X11.conf -javaagent:C:\jennifer\agent\lwst.javaagent.jar
3.2.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in WebSphere, JAVA option.
3.2.3.1 Configure JAVA Options for WebSphere
1. In the WebSphere management console, select the [Select Application Server | D efine Process | Java Virtual System ] menu. 2. Enter below value in boot class path
c:\jennifer\agent\lwst.boot.jar c:\jennifer\agent\lwst.jdk.jar c:\jennifer\agent\jennifer.boot.jar
3. Enter below value in JVM
-Djennifer.config=c:\jennifer\jenniferagent\X11.conf -javaagent:c:\jennifer\jenniferagent\lwst.javaagent.jar
For JAVA version below JDK 1.5, DO NOT use option javaagent:/home/jen nifer/agent/ lwst.javaagent.jar. 24 | Install JENNIFER Agent on WebSphere
4. Save the entered value
3.2.3.2 Restart WebSphere and verify configuration
1. Register License Key
Restarting WebSphere triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-06-16) started. agent_name=X11 jennifer.config=C:\jennifer\agent\X11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=C:\jennifer\agent\license.txt :ExpireDate: 2011-06-28 logfile=c:\jennifer\agent\X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true
As shown above, if the “libjennifer20.so(sl) shared library loaded successful ly.” message does not appear, refer to [Troubleshooting for Installation].
1. Verify Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer. Windows Environment | 25
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
3.2.3.3 Removing JENNIFER Agent Configuration
1. In WebSphere management console, select the [Select Application Server | Defin e Process | Java Virtual System ] menu. 2. Delete lwst.boot.jar, jennifer.boot.jar and lwst.jdk.jar files from boot class. 3. Delete the -Djennifer.conf file and -javaagnt from JVM. 4. Delete JENNIFER Native library (e.g. /was/WebSphere/AppServer/java/jre/lib/i38 6/libjennifer20.so) 5. Restart WebSphere
4. Install JENNIFER Agent on WebLogic
4.1 UNIX Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
4.1.1 Install on WebLogic Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 4-1 Sample JENNIFER Agent Installation Configuration
Sample Environment Directory
JENNIFER Agent Home Directory /home/jennifer/agent JAVA HOME Directory /usr/java JENNIFER Server IP Address 192.168.0.139
4.1.2 Pre-Installation Steps
Run the preinstall.sh file in the JENNIFER agent directory.
4.1.2.1 Set JAVA_HOME
Set JAVA_HOME directory used by WebLogic. After checking the JAVA_HOME used by WebLogic, generate lwst.jdk.jar file.
27 28 | Install JENNIFER Agent on WebLogic
######################################################## Step 1. Build LWST ########################################################
Type the JAVA_HOME directory which is used by Java Application Server.
Input [JAVA_HOME] which is used for Java Application Server. ===>> /usr/java [/usr/java] is set as JAVA_HOME
Creating lwst.jdk.jar ....
LWST(lwst.jdk.jar) build successful
4.1.2.2 Configure Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify appropriate native library for installed system then execut e test.sh to verify it. Copy libjennifer20.so(sl) which has passed the test sucessfully to Agent Home directory.
######################################################## Step 2. JENNIFER NATIVE LIBRARY SETTING ########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/home/jennifer/agent/libjennifer20.so file is copied successfully
4.1.2.3 Agent Configuration
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi UNIX Environment | 29
fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
######################################################## Step 3. JENNIFER AGENT CONFIGURATION SETTING ######################################################## Do you want to customize agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char] ex) W11 ===>> X11 license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_X11.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 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 [Pre-Installation is finished]
표 4-2 Options for JENNIFER Configuration Files
Option Description
agent_name Agent name composed in 3 alpha-numeric characters license_filename Set name and directory of file which stores JENNIFER License Key logfile Set name and directory of file which stores JENNIFER Log files agent_tcp_port Set Port which will bind to JENNIFER Agent udp_server_host Set IP Address of server machine where JENNIFER Server is installed
4.1.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where WebLogic option is applied.
[ Pre-Installation Summary ] Java Application Server Home Directory : JDK Home Directory : /usr/java Jennifer Agent Directory : /home/jennifer/agent Jennifer LWST file : /home/jennifer/agent/lwst.jdk.jar Jennifer Native library file : /home/jennifer/agent/libjennifer20.so(sl) 30 | Install JENNIFER Agent on WebLogic
####################################################################### Please add the following configuration to your web application Server ####################################################################### -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/ lwst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -Djennifer.config=/home/jennifer/agent/X11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
4.1.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in WebLogic, JAVA option.
4.1.3.1 Copy JNI Files
Copy /home/jennifer/agent/libjennifer20.so(sl) file which has successfully passed JNI test in sun.boot.library.path directory of JDK in use.
4.1.3.2 WebLogic JAVA Option Configuration
● WebLogic configuration file is located in $DOMAIN_HOME/bin/startWebLogic.sh
● For JAVA_OPTIONS in WebLogic configuration file, set options as described in In stallation Guide section 1.2.4.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
4.1.3.3 Restart WebLogic and verify configuration
1. Register License Key
Restarting WebLogic triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 UNIX Environment | 31
jennifer.config=/home/jennifer/agent/W11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=/home/jennifer/agent/license.txt :ExpireDate: 2011-06-28 logfile=/home/jennifer/agent/jennifer_X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ------OS/Java=Linux,,Java(TM) SE Runtime Environment,Java HotSpot(TM) Server VM,10.0-b23 sun.boot.class.path==/home/jennifer/agent/jennifer.boot.jar:/home/jennifer/ agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar ... sun.boot.library.path=/usr/java/jre/lib/i386 ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation] in installation guide.
● Register the valid license number in the [Properties | License Key Management] menu.
1. Verify Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring" 32 | Install JENNIFER Agent on WebLogic
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
4.1.3.4 Removing JENNIFER Agent Configuration
1. Stop WebLogic. 2. Delete JENNIFER related options from WebLogic's file, $DOMAIN_HOME/bin/sta rtWebLogic.sh 3. Delete JENNIFER Native Library files. 4. Restart WebLogic.
4.2 Windows Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
4.2.1 Install on WebLogic Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 4-3 Sample JENNIFER Agent Configuration
Sample Environment Directory
JENNIFER Agent Home Directory c:\jennifer\agent JAVA Home Directory C:\Program Files\Java\jdk1.6.0_15 JENNIFER Server IP Address 192.168.0.139
4.2.2 Pre-Installation Steps
From JENNIFER Agent Directory, execute preinstall.bat file under administrator privil ege
4.2.2.1 Set JAVA_HOME
Set JAVA HOME directory used by WebLogic then generate lwst.jdk.jar file. Windows Environment | 33
################################################### Step 1. Build LWST ###################################################
Input [JAVA_HOME] which is used for Java Application Server (Enter "q" to quit):C:\Program Files\Java\jdk1.6.0_15 C:\Program Files\Java\jdk1.6.0_15 is set as JAVA_HOME "Creating lwst.jdk.jar..."
"LWST build successful"
lwst.jdk.jar is created successfully
4.2.2.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify the native library file suitable for installed system, then te st it. If the memory size is over 2GB, select ‘y’ key, otherwise, select ‘n’ key.
################################################### Step 2. JENNIFER NATIVE LIBRARY SETTING ###################################################
Does your system have more than 2GB ?(Y/N) : y jennifer20.dll has been copied to C:\Program Files\Java\jdk1.6.0_15 successfully.
4.2.2.3 Configure JENNIFER Agent
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
################################################### Step 3. JENNIFER AGENT CONFIGURATION SETTING ###################################################
Do you want to customize agent configuration file at this time? (Y/N) : y 34 | Install JENNIFER Agent on WebLogic
license_filename [ex: C:\jennifer\agent\license.txt] : Pleaes enter AGENT name. AGENT name must be 3 characters long, first charater must be alphabet anemaining characters must be numbers e.g. [W11] : X11 logfile [ex: C:\jennifer\agent\X11.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] :
Do you have any option(s) that you want to change?(Y/N)n
4.2.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where WebLogic option is applied.
[Pre-Installation Summary] JAVA HOME DIRECTORY : C:\Program Files\Java\jdk1.6.0_15 JENNIFER AGENT DIRECROTY : C:\jennifer\agent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\agent\X11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Program Files\Java\jdk1.6.0_15\bin\jennifer20.dll
[Post-Installation options] -Xbootclasspath/p:C:\jennifer\agent\lwst.boot.jar;C:\jennifer\agent\jennife r.boot.jar;C:\jennifer\agent\lwst.jdk.jar -Djennifer.config=C:\jennifer\agent\X11.conf -javaagent:C:\jennifer\agent\lwst.javaagent.jar
4.2.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in WebLogic's JAVA option.
4.2.3.1 Configure JAVA Options for WebLogic Windows Environment | 35
● WebLogic configuration file is located in %WEBLOGIC_HOME%\bin\startWeb Logic.cmd
● For JAVA_OPTIONS in WebLogic configuration file, set options as described in In stallation Guide section 2.2.4.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
4.2.3.2 Restart WebLogic and verify configuration
1. Register License Key
● Restarting WebLogic triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=C:\jennifer\agent\X11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=C:\jennifer\agent\license.txt :ExpireDate: 2011-06-28 logfile=c:\jennifer\agent\X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation]. 36 | Install JENNIFER Agent on WebLogic
● In [Properties | License Management] menu, Registered License Key.
1. Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
4.2.3.3 Removing JENNIFER Agent Configuration
1. Stop WebLogic 2. Delete JENNIFER related options from WebLogic's file $DOMAIN_HOME\bin\s tartWebLogic.cmd 3. Delete JENNIFER Native Library. 4. Restart WebLogic. 5. Install JENNIFER Agent on Tomcat
5.1 UNIX Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
5.1.1 Install on Tomcat Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 5-1 Sample Agent Installation Configuration
Sample Environment Directory
JENNIFER Agent Home Directory /home/jennifer/agent JAVA HOME Directory /usr/java JENNIFER Server IP Address 192.168.0.139
5.1.2 Pre-Installation Steps
Run the preinstall.sh file in the JENNIFER agent directory.
5.1.2.1 Set JAVA_HOME
Set JAVA_HOME directory used by Tomcat. After checking the JAVA_HOME used by Tomcat, generate lwst.jdk.jar file.
37 38 | Install JENNIFER Agent on Tomcat
######################################################## Step 1. Build LWST ########################################################
Type the JAVA_HOME directory which is used by Java Application Server.
Input [JAVA_HOME] which is used for Java Application Server. ===>> /usr/java [/usr/java] is set as JAVA_HOME
Creating lwst.jdk.jar ....
LWST(lwst.jdk.jar) build successful
5.1.2.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify appropriate native library for installed system then execut e test.sh to verify it. Copy libjennifer20.so(sl) which has passed the test sucessfully to Agent Home directory.
######################################################## Step 2. JENNIFER NATIVE LIBRARY SETTING ########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/home/jennifer/agent/libjennifer20.so file is copied successfully
5.1.2.3 Agent Configuration
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi UNIX Environment | 39
fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
######################################################## Step 3. JENNIFER AGENT CONFIGURATION SETTING ######################################################## Do you want to customize agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char] ex) W11 ===>> X11 license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_X11.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 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 [Pre-Installation is finished]
표 5-2 Options for JENNIFER Configuration Files
Option Description
agent_name Agent name composed in 3 alpha-numeric characters license_filename Set name and directory of file which stores JENNIFER License Key logfile Set name and directory of file which stores JENNIFER Log files agent_tcp_port Set Port which will bind to JENNIFER Agent udp_server_host Set IP Address of server machine where JENNIFER Server is installed
5.1.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where Tomcat option is applied.
[ Pre-Installation Summary ] Java Application Server Home Directory : JDK Home Directory : /usr/java Jennifer Agent Directory : /home/jennifer/agent Jennifer LWST file : /home/jennifer/agent/lwst.jdk.jar Jennifer Native library file : /home/jennifer/agent/libjennifer20.so(sl) 40 | Install JENNIFER Agent on Tomcat
####################################################################### Please add the following configuration to your web application Server ####################################################################### -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/ lwst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -Djennifer.config=/home/jennifer/agent/X11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
5.1.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in Tomcat, JAVA option.
5.1.3.1 Copy JNI Files
Copy /home/jennifer/agent/libjennifer20.so(sl) file which has successfully passed JNI test in sun.boot.library.path directory of JDK in use.
5.1.3.2 Set Tomcat Java Option
● Tomcat configuration file is located in ${TOMCAT_HOME}/bin/catalina.sh
● For JAVA_Option of Tomcat Configuration files, refer to Installation guide 1.2.4 t o find instructions to set options.
For JAVA version below JDK 1.4, DO NOT use option javaagent:/home/jen nifer/agent/ lwst.javaagent.jar.
5.1.3.3 Restart Tomcat and verify configuration
● Register License Key
● Restarting Tomcat triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent. UNIX Environment | 41
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=/home/jennifer/agent/W11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=/home/jennifer/agent/license.txt :ExpireDate: 2011-06-28 logfile=/home/jennifer/agent/jennifer_X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ------OS/Java=Linux,,Java(TM) SE Runtime Environment,Java HotSpot(TM) Server VM,10.0-b23 sun.boot.class.path==/home/jennifer/agent/jennifer.boot.jar:/home/jennifer/ agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar ... sun.boot.library.path=/usr/java/jre/lib/i386 ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation] in installation guide.
● Register the valid license number in the [Properties | License Key Management] menu.
● Verify Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer. 42 | Install JENNIFER Agent on Tomcat
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
5.1.3.4 Removing JENNIFER Agent Configuration
1. Stop Tomcat. 2. Delete JENNIFER related options from Tomcat's file, ${TOMCAT_HOME}/bin/cat alina.sh 3. Delete JENNIFER Native Library files. 4. Restart Tomcat.
5.2 Windows Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
5.2.1 Install on Tomcat Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 5-3 Sample JENNIFER Agent Configuration
Sample Environment Directory
JENNIFER Agent Home Directory c:\jennifer\agent JAVA Home Directory C:\Program Files\Java\jdk1.6.0_15 JENNIFER Server IP Address 192.168.0.139
5.2.2 Pre-Installation Steps
From JENNIFER Agent Directory, execute preinstall.bat file under administrator privil ege Windows Environment | 43
5.2.2.1 Set JAVA_HOME
Set JAVA HOME directory used by Tomcat then generate lwst.jdk.jar file.
################################################### Step 1. Build LWST ###################################################
Input [JAVA_HOME] which is used for Java Application Server (Enter "q" to quit):C:\Program Files\Java\jdk1.6.0_15 C:\Program Files\Java\jdk1.6.0_15 is set as JAVA_HOME "Creating lwst.jdk.jar..."
"LWST build successful"
lwst.jdk.jar is created successfully
5.2.2.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify the native library file suitable for installed system, then te st it. If the memory size is over 2GB, select ‘y’ key, otherwise, select ‘n’ key.
################################################### Step 2. JENNIFER NATIVE LIBRARY SETTING ###################################################
Does your system have more than 2GB ?(Y/N) : y jennifer20.dll has been copied to C:\Program Files\Java\jdk1.6.0_15 successfully.
5.2.2.3 Configure JENNIFER Agents
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi fy the w11.conf or jennifer.conf provided by JENNIFER then used them. 44 | Install JENNIFER Agent on Tomcat
################################################### Step 3. JENNIFER AGENT CONFIGURATION SETTING ###################################################
Do you want to customize agent configuration file at this time? (Y/N) : y license_filename [ex: C:\jennifer\agent\license.txt] : Pleaes enter AGENT name. AGENT name must be 3 characters long, first charater must be alphabet anemaining characters must be numbers e.g. [W11] : X11 logfile [ex: C:\jennifer\agent\X11.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] :
Do you have any option(s) that you want to change?(Y/N)n
5.2.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where Tomcat option is applied.
[Pre-Installation Summary] JAVA HOME DIRECTORY : C:\Program Files\Java\jdk1.6.0_15 JENNIFER AGENT DIRECROTY : C:\jennifer\agent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\agent\X11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Program Files\Java\jdk1.6.0_15\bin\jennifer20.dll
[Post-Installation options] -Xbootclasspath/p:C:\jennifer\agent\lwst.boot.jar;C:\jennifer\agent\jennife r.boot.jar;C:\jennifer\agent\lwst.jdk.jar -Djennifer.config=C:\jennifer\agent\X11.conf -javaagent:C:\jennifer\agent\lwst.javaagent.jar Windows Environment | 45
5.2.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in Tomcat's JAVA option.
5.2.3.1 Configure JAVA Options for Tomcat
● Tomcat configuration file is located in %TOMCAT_HOME%\bin\catalina.bat
● For JAVA_Option of Tomcat Configuration files, refer to Installation guide 2.2.4 t o find instructions to set options.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
5.2.3.2 Restart Tomcat and verify configuration
● Register License Key
● Restarting Tomcat triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=C:\jennifer\agent\X11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=C:\jennifer\agent\license.txt :ExpireDate: 2011-06-28 logfile=c:\jennifer\agent\X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ... 46 | Install JENNIFER Agent on Tomcat
JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation]..
● In [Properties | License Management] menu, Registered License Key.
● Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
5.2.3.3 Removing JENNIFER Agent Configuration
1. Stop Tomcat 2. Delete JENNIFER related options from Tomcat's file %TOMCAT_HOME%\bin \catalina.bat. 3. Delete JENNIFER Native Library. 4. Restart Tomcat. 6. Install JENNIFER Agent Configuration on Resin
6.1 UNIX Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
6.1.1 Install on Resin Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 6-1 Sample JENNIFER Agent Installation Configuration
Sample Environment Directory
JENNIFER Agent Home Directory /home/jennifer/agent JAVA HOME Directory /usr/java NNIFER Server IP Address 192.168.0.139
6.1.2 Pre-Installation Steps
Pre-Installation Steps
6.1.2.1 Set JAVA_HOME
Set JAVA_HOME directory used by Resin. After checking the JAVA_HOME used by R esin, generate lwst.jdk.jar file
47 48 | Install JENNIFER Agent Configuration on Resin
######################################################## Step 1. Build LWST ########################################################
Type the JAVA_HOME directory which is used by Java Application Server.
Input [JAVA_HOME] which is used for Java Application Server. ===>> /usr/java [/usr/java] is set as JAVA_HOME
Creating lwst.jdk.jar ....
LWST(lwst.jdk.jar) build successful
6.1.2.2 Configure Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify appropriate native library for installed system then execut e test.sh to verify it. Copy libjennifer20.so(sl) which has passed the test sucessfully to Agent Home directory.
######################################################## Step 2. JENNIFER NATIVE LIBRARY SETTING ########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/home/jennifer/agent/libjennifer20.so file is copied successfully
6.1.2.3 Agent Configuration
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi UNIX Environment | 49
fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
######################################################## Step 3. JENNIFER AGENT CONFIGURATION SETTING ######################################################## Do you want to customize agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char] ex) W11 ===>> X11 license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_X11.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 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 [Pre-Installation is finished]
표 6-2 Options for JENNIFER Configuration Files
Option Description
agent_name Agent name composed in 3 alpha-numeric characters license_filename Set name and directory of file which stores JENNIFER License Key logfile Set name and directory of file which stores JENNIFER Log files agent_tcp_port Set Port which will bind to JENNIFER Agent udp_server_host Set IP Address of server machine where JENNIFER Server is installed
6.1.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where Resin option is applied.
[ Pre-Installation Summary ] Java Application Server Home Directory : JDK Home Directory : /usr/java Jennifer Agent Directory : /home/jennifer/agent Jennifer LWST file : /home/jennifer/agent/lwst.jdk.jar Jennifer Native library file : /home/jennifer/agent/libjennifer20.so(sl) 50 | Install JENNIFER Agent Configuration on Resin
####################################################################### Please add the following configuration to your web application Server ####################################################################### -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/ lwst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -Djennifer.config=/home/jennifer/agent/X11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
6.1.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in Resin, JAVA option.
6.1.3.1 Copy JNI Files
Copy /home/jennifer/agent/libjennifer20.so(sl) file which has successfully passed JNI test in sun.boot.library.path directory of JDK in use.
6.1.3.2 Resin 2.x/3.0.x JAVA Option Configuration
● Resin 2.x/3.0.x configuration file is usually found in $RESIN_HOME/bin/httpd.sh
● For JAVA_Option of Resin configuration files, refer to Installation guide 1.2.4 to f ind instructions to set options.
In Java Option -Xbootclasspath/p and -javaagent, option -J must be added.
ex: -J-Xbootclasspat/p -J-javaagent
If using JAVA version JDK 1.4 for older, do not set javaagent option.
6.1.3.3 Resin 3.1.x JAVA Option Configuration
● Resin 3.1.x configuration file is usually found in /was/resin315/conf/resin.conf
● For JAVA_Option of Resin configuration files, refer to Installation guide 1.2.4 to f ind instructions to set options. UNIX Environment | 51
As shown below, set 2 or 3 options in the tag.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
6.1.3.4 Resin 4.x JAVA Option Configuration
● Resin 4.x Resin configuration file is usually found in $RESIN_HOME/conf/resin.x ml
● For JAVA_Option of Resin configuration files, refer to Installation guide 1.2.4 to f ind instructions to set options.
As shown below, set 2 or 3 options in the tag.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
6.1.3.5 Restart Resin and verify configuration
1. Register License Key
Restarting Resin triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent. 52 | Install JENNIFER Agent Configuration on Resin
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=/home/jennifer/agent/W11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=/home/jennifer/agent/license.txt :ExpireDate: 2011-06-28 logfile=/home/jennifer/agent/jennifer_X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ------OS/Java=Linux,,Java(TM) SE Runtime Environment,Java HotSpot(TM) Server VM,10.0-b23 sun.boot.class.path==/home/jennifer/agent/jennifer.boot.jar:/home/jennifer/ agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar ... sun.boot.library.path=/usr/java/jre/lib/i386 ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation] in installation guide.
● Register the valid license number in the [Properties | License Key Management] menu.
2. Verify Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer. Windows Environment | 53
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● [ See if the classes loaded in the [ Problem Determination | Utility | Loading Class List ] menu appear properly.
6.1.3.6 Removing JENNIFER Agent Configuration
1. Stop Resin. 2. For Resin 2.1.x, 3.0.x delete the JENNIFER Agent option from the start script. 3. For Resin 3.1.x, delete JENNIFER Agent option from $RESIN_HOME/conf/resin.c onf 4. For Resin 4.x, delete JENNIFER Agent option from $RESIN_HOME/conf/resin.xml 5. Delete JENNIFER Native Library files. 6. Restart Resin.
6.2 Windows Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
6.2.1 Install on Resin Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 6-3 Sample JENNIFER Agent Configuration
Sample Environment Directory
JENNIFER Agent Home Directory c:\jennifer\agent JAVA Home Directory C:\Program Files\Java\jdk1.6.0_15 JENNIFER Server IP Address 192.168.0.139 54 | Install JENNIFER Agent Configuration on Resin
6.2.2 Pre-Installation Steps
From JENNIFER Agent Directory, execute preinstall.bat file under administrator privil ege.
6.2.2.1 Set JAVA_HOME
Set JAVA HOME directory used by Resin then generate lwst.jdk.jar file.
################################################### Step 1. Build LWST ###################################################
Input [JAVA_HOME] which is used for Java Application Server (Enter "q" to quit):C:\Program Files\Java\jdk1.6.0_15 C:\Program Files\Java\jdk1.6.0_15 is set as JAVA_HOME "Creating lwst.jdk.jar..."
"LWST build successful"
lwst.jdk.jar is created successfully
6.2.2.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify the native library file suitable for installed system, then te st it. If the memory size is over 2GB, select ‘y’ key, otherwise, select ‘n’ key.
################################################### Step 2. JENNIFER NATIVE LIBRARY SETTING ###################################################
Does your system have more than 2GB ?(Y/N) : y jennifer20.dll has been copied to C:\Program Files\Java\jdk1.6.0_15 successfully.
6.2.2.3 Configure JENNIFER Agent
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select Windows Environment | 55
value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
################################################### Step 3. JENNIFER AGENT CONFIGURATION SETTING ###################################################
Do you want to customize agent configuration file at this time? (Y/N) : y license_filename [ex: C:\jennifer\agent\license.txt] : Pleaes enter AGENT name. AGENT name must be 3 characters long, first charater must be alphabet anemaining characters must be numbers e.g. [W11] : X11 logfile [ex: C:\jennifer\agent\X11.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] :
Do you have any option(s) that you want to change?(Y/N)n
6.2.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where Resin option is applied.
[Pre-Installation Summary] JAVA HOME DIRECTORY : C:\Program Files\Java\jdk1.6.0_15 JENNIFER AGENT DIRECROTY : C:\jennifer\agent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\agent\X11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Program Files\Java\jdk1.6.0_15\bin\jennifer20.dll
[Post-Installation options] -Xbootclasspath/p:C:\jennifer\agent\lwst.boot.jar;C:\jennifer\agent\jennife r.boot.jar;C:\jennifer\agent\lwst.jdk.jar -Djennifer.config=C:\jennifer\agent\X11.conf -javaagent:C:\jennifer\agent\lwst.javaagent.jar 56 | Install JENNIFER Agent Configuration on Resin
6.2.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in Resin's JAVA option.
6.2.3.1 Resin 2.x/3.0.x JAVA Options
● Input JENNIFER Agent option in Resin run command then start Resin
● Resin run command is %RESIN_HOME%\httpd.exe
● For JAVA_Option of Resin configuration files, refer to Installation guide 1.2.4 to f ind instructions to set options.
In Java Option -Xbootclasspath/p and -javaagent, option -J must be added.
ex: -J-Xbootclasspat/p -J-javaagent
If using JAVA version JDK 1.4 for older, do not set javaagent option.
6.2.3.2 Resin 3.1.x JAVA Option Configuration
● JAVA Option configuration file for Resin 3.1 is %RESIN_HOME%\conf\resin.c onf
● For JAVA_Option of Resin configuration files, refer to Installation guide 1.2.4 to f ind instructions to set options.
As shown below, set 2 or 3 options in the tag.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
6.2.3.3 Resin 4.x JAVA Option Configuration
● JAVA option configuration file for Resin 4.x is %RESIN_HOME%\conf\resin.x ml
● For JAVA_Option of Resin configuration files, refer to Installation guide 1.2.4 to f ind instructions to set options.
As shown below, set 2 or 3 options in the tag.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
6.2.3.4 Restart Resin and verify configuration
1. Register License Key
Restarting Resin triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=C:\jennifer\agent\X11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true 58 | Install JENNIFER Agent Configuration on Resin
license_filename=C:\jennifer\agent\license.txt :ExpireDate: 2011-06-28 logfile=c:\jennifer\agent\X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation].
● In [Properties | License Management] menu, Registered License Key.
2. Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
6.2.3.5 Removing JENNIFER Agent Configuration
1. Stop Resin 2. For Resin 2.1.x, 3.0.x delete the JENNIFER Agent option from the start script 3. For Resin 3.1.x, delete JENNIFER Agent option from $RESIN_HOME/conf/resin.c onf 4. For Resin 4.x, delete JENNIFER Agent option from $RESIN_HOME/conf/resin.xml 5. Delete JENNIFER Native Library files. 6. Restart Resin 7. Install JENNIFER Agent on JEUS
7.1 UNIX Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
7.1.1 Install on JEUS Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 7-1 Sample JENNIFER Agent Installation Configuration
Sample Environment Sample Environment
JENNIFER Agent Home Directory /home/jennifer/agent JENNIFER Agent Home Directory /usr/java JENNIFER Server IP Address 192.168.0.139
7.1.2 Pre-Installation Steps
Run the preinstall.sh file in the JENNIFER agent directory.
7.1.2.1 Set JAVA_HOME
Set JAVA_HOME directory used by JEUS. After checking the JAVA_HOME used by JE US, generate lwst.jdk.jar file.
59 60 | Install JENNIFER Agent on JEUS
######################################################## Step 1. Build LWST ########################################################
Type the JAVA_HOME directory which is used by Java Application Server.
Input [JAVA_HOME] which is used for Java Application Server. ===>> /usr/java [/usr/java] is set as JAVA_HOME
Creating lwst.jdk.jar ....
LWST(lwst.jdk.jar) build successful
7.1.2.2 Configure Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify appropriate native library for installed system then execut e test.sh to verify it. Copy libjennifer20.so(sl) which has passed the test sucessfully to Agent Home directory.
######################################################## Step 2. JENNIFER NATIVE LIBRARY SETTING ########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/home/jennifer/agent/libjennifer20.so file is copied successfully
7.1.2.3 Agent Configuration
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi UNIX Environment | 61
fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
######################################################## Step 3. JENNIFER AGENT CONFIGURATION SETTING ######################################################## Do you want to customize agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char] ex) W11 ===>> X11 license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_X11.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 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 [Pre-Installation is finished]
표 7-2 Options for JENNIFER Configuration Files
Option Description
agent_name Agent name composed in 3 alpha-numeric characters license_filename Set name and directory of file which stores JENNIFER License Key logfile Set name and directory of file which stores JENNIFER Log files agent_tcp_port Set Port which will bind to JENNIFER Agent udp_server_host Set IP Address of server machine where JENNIFER Server is installed
7.1.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where JEUS option is applied.
[ Pre-Installation Summary ] Java Application Server Home Directory : JDK Home Directory : /usr/java Jennifer Agent Directory : /home/jennifer/agent Jennifer LWST file : /home/jennifer/agent/lwst.jdk.jar Jennifer Native library file : /home/jennifer/agent/libjennifer20.so(sl) 62 | Install JENNIFER Agent on JEUS
####################################################################### Please add the following configuration to your web application Server ####################################################################### -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/ lwst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -Djennifer.config=/home/jennifer/agent/X11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
7.1.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in JEUS, JAVA option.
7.1.3.1 Copy JNI Files
Copy /home/jennifer/agent/libjennifer20.so(sl) file which has successfully passed JNI test in sun.boot.library.path directory of JDK in use.
7.1.3.2 JEUS JAVA Option Configuration
● JEUS configuration file is usually found in $WAS_HOME/config/hostname/JEUS Main.xml
● Add options within tag
● For JAVA_Option of JEUS configuration files, refer to Installation guide 1.2.4 to fi nd instructions to set options.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
7.1.3.3 Restart JEUS and verify configuration
1. Register License Key
Restarting JEUS triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent. UNIX Environment | 63
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=/home/jennifer/agent/W11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=/home/jennifer/agent/license.txt :ExpireDate: 2011-06-28 logfile=/home/jennifer/agent/jennifer_X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ------OS/Java=Linux,,Java(TM) SE Runtime Environment,Java HotSpot(TM) Server VM,10.0-b23 sun.boot.class.path==/home/jennifer/agent/jennifer.boot.jar:/home/jennifer/ agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar ... sun.boot.library.path=/usr/java/jre/lib/i386 ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation] in installation guide.
● Register the valid license number in the [Properties | License Key Management] menu.
2. Verify Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer. 64 | Install JENNIFER Agent on JEUS
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
7.1.3.4 Removing JENNIFER Agent Configuration
1. Stop JEUS. 2. Delete JENNIFER related options from JEUS's file, $JEUS_HOME/config/hostnam e/JEUSMain.xm 3. Delete JENNIFER Native Library files. 4. Restart JEUS.
7.2 Windows Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
7.2.1 Install on JEUS Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 7-3 Sample JENNIFER Agent Configuration
Sample Environment Directory
JENNIFER Agent Home Directory c:\jennifer\agent JAVA Home Directory C:\Program Files\Java\jdk1.6.0_15 JENNIFER Server IP Address 192.168.0.139
7.2.2 Pre-Installation Steps
From JENNIFER Agent Directory, execute preinstall.bat file under administrator privil ege Windows Environment | 65
7.2.2.1 Set JAVA_HOME
Set JAVA HOME directory used by JEUS then generate lwst.jdk.jar file.
################################################### Step 1. Build LWST ###################################################
Input [JAVA_HOME] which is used for Java Application Server (Enter "q" to quit):C:\Program Files\Java\jdk1.6.0_15 C:\Program Files\Java\jdk1.6.0_15 is set as JAVA_HOME "Creating lwst.jdk.jar..."
"LWST build successful"
lwst.jdk.jar is created successfully
7.2.2.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify the native library file suitable for installed system, then te st it. If the memory size is over 2GB, select ‘y’ key, otherwise, select ‘n’ key.
################################################### Step 2. JENNIFER NATIVE LIBRARY SETTING ###################################################
Does your system have more than 2GB ?(Y/N) : y jennifer20.dll has been copied to C:\Program Files\Java\jdk1.6.0_15 successfully.
7.2.2.3 Configure JENNIFER Agent
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi fy the w11.conf or jennifer.conf provided by JENNIFER then used them. 66 | Install JENNIFER Agent on JEUS
################################################### Step 3. JENNIFER AGENT CONFIGURATION SETTING ###################################################
Do you want to customize agent configuration file at this time? (Y/N) : y license_filename [ex: C:\jennifer\agent\license.txt] : Pleaes enter AGENT name. AGENT name must be 3 characters long, first charater must be alphabet anemaining characters must be numbers e.g. [W11] : X11 logfile [ex: C:\jennifer\agent\X11.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] :
Do you have any option(s) that you want to change?(Y/N)n
7.2.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where JEUS option is applied.
[Pre-Installation Summary] JAVA HOME DIRECTORY : C:\Program Files\Java\jdk1.6.0_15 JENNIFER AGENT DIRECROTY : C:\jennifer\agent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\agent\X11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Program Files\Java\jdk1.6.0_15\bin\jennifer20.dll
[Post-Installation options] -Xbootclasspath/p:C:\jennifer\agent\lwst.boot.jar;C:\jennifer\agent\jennife r.boot.jar;C:\jennifer\agent\lwst.jdk.jar -Djennifer.config=C:\jennifer\agent\X11.conf -javaagent:C:\jennifer\agent\lwst.javaagent.jar Windows Environment | 67
7.2.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in JEUS's JAVA option.
7.2.3.1 Configure JAVA Options for JEUS
● JEUS configuration file is usually found in %JEUS_HOME%\config\hostname \JEUSMain.xml
● Add options within tag
● For JAVA_Option of JEUS configuration files, refer to Installation guide 2.2.4 to fi nd instructions to set options.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
7.2.3.2 Restart JEUS and verify configuration
1. Register License Key
● Restarting JEUS triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=C:\jennifer\agent\X11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=C:\jennifer\agent\license.txt :ExpireDate: 2011-06-28 logfile=c:\jennifer\agent\X11.log LWST enabled=true 68 | Install JENNIFER Agent on JEUS
enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation].
● In [Properties | License Management] menu, Registered License Key.
2. Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● e if the classes loaded in the [ Problem Determination | Utility | Loading Class List ] menu appear properly.
7.2.3.3 Removing JENNIFER Agent Configuration
1. Stop JEUS 2. Delete JENNIFER related options from JEUS's file, %JEUS_HOME%\config\ho stname\JEUSMain.xml 3. Delete JENNIFER Native Library. 4. Delete JENNIFER Native Library. 8. Install JENNIFER Agent on JBoss
8.1 UNIX Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
8.1.1 Install on JBoss Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 8-1 Sample JENNIFER Agent Installation Configuration
Sample Environment Directory
JENNIFER Agent Home Directory /home/jennifer/agent JAVA HOME Directory /usr/java JENNIFER Server IP Address 192.168.0.139
8.1.2 Pre-Installation Steps
Run the preinstall.sh file in the JENNIFER agent directory.
8.1.2.1 Set JAVA_HOME
Set JAVA_HOME directory used by JBoss. After checking the JAVA_HOME used by J Boss, generate lwst.jdk.jar file
69 70 | Install JENNIFER Agent on JBoss
######################################################## Step 1. Build LWST ########################################################
Type the JAVA_HOME directory which is used by Java Application Server.
Input [JAVA_HOME] which is used for Java Application Server. ===>> /usr/java [/usr/java] is set as JAVA_HOME
Creating lwst.jdk.jar ....
LWST(lwst.jdk.jar) build successful
8.1.2.2 Configure Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify appropriate native library for installed system then execut e test.sh to verify it. Copy libjennifer20.so(sl) which has passed the test sucessfully to Agent Home directory.
######################################################## Step 2. JENNIFER NATIVE LIBRARY SETTING ########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/home/jennifer/agent/libjennifer20.so file is copied successfully
8.1.2.3 Agent Configuration
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi UNIX Environment | 71
fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
######################################################## Step 3. JENNIFER AGENT CONFIGURATION SETTING ######################################################## Do you want to customize agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char] ex) W11 ===>> X11 license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_X11.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 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 [Pre-Installation is finished]
표 8-2 Options for JENNIFER Configuration Files
Option Description
agent_name Agent name composed in 3 alpha-numeric characters license_filename Set name and directory of file which stores JENNIFER License Key logfile Set name and directory of file which stores JENNIFER Log files agent_tcp_port Set Port which will bind to JENNIFER Agent udp_server_host Set IP Address of server machine where JENNIFER Server is installed
8.1.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where JBoss option is applied.
[ Pre-Installation Summary ] Java Application Server Home Directory : JDK Home Directory : /usr/java Jennifer Agent Directory : /home/jennifer/agent Jennifer LWST file : /home/jennifer/agent/lwst.jdk.jar Jennifer Native library file : /home/jennifer/agent/libjennifer20.so(sl) 72 | Install JENNIFER Agent on JBoss
####################################################################### Please add the following configuration to your web application Server ####################################################################### -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/ lwst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -Djennifer.config=/home/jennifer/agent/X11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
8.1.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in JBoss, JAVA option.
8.1.3.1 Copy JNI Files
Copy /home/jennifer/agent/libjennifer20.so(sl) file which has successfully passed JNI test in sun.boot.library.path directory of JDK in use.
8.1.3.2 JBoss JAVA Option Configuration
● JBoss configuration file is usually found in $JBOSS_HOME/bin/run.sh
● For JAVA_Option of JBOSS configuration files, refer to Installation guide 1.2.4 to find instructions to set options.
In case of JBoss7, domain.conf or standalone.conf must be edited as below to support OSGI class loader.
-Djboss.modules.system.pkgs=org.jboss.byteman;com.javaservice
If using JAVA version JDK 1.4 for older, do not set javaagent option.
8.1.3.3 Restart JBoss and verify configuration
1. Register License Key
Restarting JBoss triggers JENNIFER Agent activation. Verify below output. UNIX Environment | 73
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=/home/jennifer/agent/W11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=/home/jennifer/agent/license.txt :ExpireDate: 2011-06-28 logfile=/home/jennifer/agent/jennifer_X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ------OS/Java=Linux,,Java(TM) SE Runtime Environment,Java HotSpot(TM) Server VM,10.0-b23 sun.boot.class.path==/home/jennifer/agent/jennifer.boot.jar:/home/jennifer/ agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar ... sun.boot.library.path=/usr/java/jre/lib/i386 ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation] in installation guide.
● Register the valid license number in the [Properties | License Key Management] menu.
2. Verify Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen. 74 | Install JENNIFER Agent on JBoss
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
8.1.3.4 Removing JENNIFER Agent Configuration
1. Stop JBoss. 2. Delete JENNIFER related options from JBoss's file run.sh 3. Delete JENNIFER Native Library files. 4. Restart JBoss.
8.2 Windows Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
8.2.1 Install on JBoss Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 8-3 Sample JENNIFER Agent Configuration
Sample Environment Directory
JENNIFER Agent Home Directory c:\jennifer\agent JAVA Home Directory C:\Program Files\Java\jdk1.6.0_15 JENNIFER Server IP Address 192.168.0.139 Windows Environment | 75
8.2.2 Pre-Installation Steps
From JENNIFER Agent Directory, execute preinstall.bat file under administrator privil ege.
8.2.2.1 Set JAVA_HOME
Set JAVA HOME directory used by JBoss then generate lwst.jdk.jar file.
################################################### Step 1. Build LWST ###################################################
Input [JAVA_HOME] which is used for Java Application Server (Enter "q" to quit):C:\Program Files\Java\jdk1.6.0_15 C:\Program Files\Java\jdk1.6.0_15 is set as JAVA_HOME "Creating lwst.jdk.jar..."
"LWST build successful"
lwst.jdk.jar is created successfully
8.2.2.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify the native library file suitable for installed system, then te st it. If the memory size is over 2GB, select ‘y’ key, otherwise, select ‘n’ key.
################################################### Step 2. JENNIFER NATIVE LIBRARY SETTING ###################################################
Does your system have more than 2GB ?(Y/N) : y jennifer20.dll has been copied to C:\Program Files\Java\jdk1.6.0_15 successfully.
8.2.2.3 Configure JENNIFER Agent
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select 76 | Install JENNIFER Agent on JBoss
value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
################################################### Step 3. JENNIFER AGENT CONFIGURATION SETTING ###################################################
Do you want to customize agent configuration file at this time? (Y/N) : y license_filename [ex: C:\jennifer\agent\license.txt] : Pleaes enter AGENT name. AGENT name must be 3 characters long, first charater must be alphabet anemaining characters must be numbers e.g. [W11] : X11 logfile [ex: C:\jennifer\agent\X11.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] :
Do you have any option(s) that you want to change?(Y/N)n
8.2.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where JBoss option is applied.
[Pre-Installation Summary] JAVA HOME DIRECTORY : C:\Program Files\Java\jdk1.6.0_15 JENNIFER AGENT DIRECROTY : C:\jennifer\agent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\agent\X11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Program Files\Java\jdk1.6.0_15\bin\jennifer20.dll
[Post-Installation options] -Xbootclasspath/p:C:\jennifer\agent\lwst.boot.jar;C:\jennifer\agent\jennife r.boot.jar;C:\jennifer\agent\lwst.jdk.jar -Djennifer.config=C:\jennifer\agent\X11.conf -javaagent:C:\jennifer\agent\lwst.javaagent.jar Windows Environment | 77
8.2.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in JBoss's JAVA option.
8.2.3.1 Configure JAVA Options for JBoss
● JBoss configuration file is usually found in %JBOSS_HOME%\bin\run.bat
● For JAVA_Option of JBoss configuration files, refer to Installation guide 2.2.4 to f ind instructions to set options.
In case of JBoss7, domain.conf or standalone.conf must be edited as below to support OSGI class loader.
-Djboss.modules.system.pkgs=org.jboss.byteman;com.javaservice
If using JAVA version JDK 1.4 for older, do not set javaagent option.
8.2.3.2 Restart JBoss and verify configuration
1. Register License Key
Restarting JBoss triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=C:\jennifer\agent\X11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=C:\jennifer\agent\license.txt :ExpireDate: 2011-06-28 78 | Install JENNIFER Agent on JBoss
logfile=c:\jennifer\agent\X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation].
● In [Properties | License Management] menu, Registered License Key.
2. Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
8.2.3.3 Removing JENNIFER Agent Configuration
1. Stop JBoss 2. Delete JENNIFER related options from JBoss's file, %JBOSS_HOME%\bin\run. bat 3. Delete JENNIFER Native Library. 4. Restart JBoss. 9. Install JENNIFER Agent on Oracle Application Server
9.1 UNIX Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
9.1.1 Install on Oracle Application Server Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 9-1 Sample JENNIFER Agent Installation Configuration
Sample Environment Directory
JENNIFER Agent Home Directory /home/jennifer/agent JAVA HOME Directory /usr/java JENNIFER Server IP Address 192.168.0.139
9.1.2 Pre-Installation Steps
Run the preinstall.sh file in the JENNIFER agent directory.
9.1.2.1 Set JAVA_HOME
Set JAVA_HOME directory used by Oracle Application Server. After checking the JAV A_HOME used by Oracle Application Server, generate lwst.jdk.jar file
79 80 | Install JENNIFER Agent on Oracle Application Server
######################################################## Step 1. Build LWST ########################################################
Type the JAVA_HOME directory which is used by Java Application Server.
Input [JAVA_HOME] which is used for Java Application Server. ===>> /usr/java [/usr/java] is set as JAVA_HOME
Creating lwst.jdk.jar ....
LWST(lwst.jdk.jar) build successful
9.1.2.2 Configure Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify appropriate native library for installed system then execut e test.sh to verify it. Copy libjennifer20.so(sl) which has passed the test sucessfully to Agent Home directory.
######################################################## Step 2. JENNIFER NATIVE LIBRARY SETTING ########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/home/jennifer/agent/libjennifer20.so file is copied successfully
9.1.2.3 Agent Configuration
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi UNIX Environment | 81
fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
######################################################## Step 3. JENNIFER AGENT CONFIGURATION SETTING ######################################################## Do you want to customize agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char] ex) W11 ===>> X11 license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_X11.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 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 [Pre-Installation is finished]
표 9-2 Options for JENNIFER Configuration Files
Option Description
agent_name Agent name composed in 3 alpha-numeric characters license_filename Set name and directory of file which stores JENNIFER License Key logfile Set name and directory of file which stores JENNIFER Log files agent_tcp_port Set Port which will bind to JENNIFER Agent udp_server_host Set IP Address of server machine where JENNIFER Server is installed
9.1.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where Oracle Application Server option is applied.
[ Pre-Installation Summary ] Java Application Server Home Directory : JDK Home Directory : /usr/java Jennifer Agent Directory : /home/jennifer/agent Jennifer LWST file : /home/jennifer/agent/lwst.jdk.jar Jennifer Native library file : /home/jennifer/agent/libjennifer20.so(sl) 82 | Install JENNIFER Agent on Oracle Application Server
####################################################################### Please add the following configuration to your web application Server ####################################################################### -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/ lwst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -Djennifer.config=/home/jennifer/agent/X11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
9.1.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in Oracle Application Server, JAVA option.
9.1.3.1 Copy JNI Files
Copy /home/jennifer/agent/libjennifer20.so(sl) file which has successfully passed JNI test in sun.boot.library.path directory of JDK in use.
9.1.3.2 Oracle Application Server JAVA Option Configuration
● Oracle Application Server's JAVA option configuration file is $ORACLE_WAS/op mn/conf/opmn.xml
● For JAVA_Option of Oracle Application Server configuration files, refer to Installa tion guide 1.2.4 to find instructions to set options in opmn.xml,
If using JAVA version JDK 1.4 for older, do not set javaagent option.
9.1.3.3 Restart Oracle Application Server and verify configuration
1. Restart Oracle Application Server and verify configuration
Restarting Oracle Application Server triggers JENNIFER Agent activation. Verify bel ow output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent. UNIX Environment | 83
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=/home/jennifer/agent/W11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=/home/jennifer/agent/license.txt :ExpireDate: 2011-06-28 logfile=/home/jennifer/agent/jennifer_X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ------OS/Java=Linux,,Java(TM) SE Runtime Environment,Java HotSpot(TM) Server VM,10.0-b23 sun.boot.class.path==/home/jennifer/agent/jennifer.boot.jar:/home/jennifer/ agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar ... sun.boot.library.path=/usr/java/jre/lib/i386 ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation] in installation guide.
● Register the valid license number in the [Properties | License Key Management] menu.
2. Verify Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer. 84 | Install JENNIFER Agent on Oracle Application Server
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
9.1.3.4 Removing JENNIFER Agent Configuration
1. Stop Oracle Application Server 2. Delete JENNIFER Agent options from file, $ORACLE_WAS/opmn/conf/opmn.xml 3. Delete JENNIFER Native Library 4. Restart Oracle Application Server
9.2 Windows Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
9.2.1 Install on Oracle Application Server Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 9-3 Sample JENNIFER Agent Configuration
Sample Environment Directory
JENNIFER Agent Home Directory c:\jennifer\agent JAVA HOME Directory C:\Program Files\Java\jdk1.6.0_15 JENNIFER Server IP Address 192.168.0.139
9.2.2 Pre-Installation Steps
From JENNIFER Agent Directory, execute preinstall.bat file under administrator privil ege. Windows Environment | 85
9.2.2.1 Set JAVA_HOME
Set JAVA HOME directory used by Oracle Application Server then generate lwst.jdk.j ar file.
################################################### Step 1. Build LWST ###################################################
Input [JAVA_HOME] which is used for Java Application Server (Enter "q" to quit):C:\Program Files\Java\jdk1.6.0_15 C:\Program Files\Java\jdk1.6.0_15 is set as JAVA_HOME "Creating lwst.jdk.jar..."
"LWST build successful"
lwst.jdk.jar is created successfully
9.2.2.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify the native library file suitable for installed system, then te st it. If the memory size is over 2GB, select ‘y’ key, otherwise, select ‘n’ key.
################################################### Step 2. JENNIFER NATIVE LIBRARY SETTING ###################################################
Does your system have more than 2GB ?(Y/N) : y jennifer20.dll has been copied to C:\Program Files\Java\jdk1.6.0_15 successfully.
9.2.2.3 Configure JENNIFER Agent
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi fy the w11.conf or jennifer.conf provided by JENNIFER then used them. 86 | Install JENNIFER Agent on Oracle Application Server
################################################### Step 3. JENNIFER AGENT CONFIGURATION SETTING ###################################################
Do you want to customize agent configuration file at this time? (Y/N) : y license_filename [ex: C:\jennifer\agent\license.txt] : Pleaes enter AGENT name. AGENT name must be 3 characters long, first charater must be alphabet anemaining characters must be numbers e.g. [W11] : X11 logfile [ex: C:\jennifer\agent\X11.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] :
Do you have any option(s) that you want to change?(Y/N)n
9.2.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where Oracle Application Server option is applied.
[Pre-Installation Summary] JAVA HOME DIRECTORY : C:\Program Files\Java\jdk1.6.0_15 JENNIFER AGENT DIRECROTY : C:\jennifer\agent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\agent\X11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Program Files\Java\jdk1.6.0_15\bin\jennifer20.dll
[Post-Installation options] -Xbootclasspath/p:C:\jennifer\agent\lwst.boot.jar;C:\jennifer\agent\jennife r.boot.jar;C:\jennifer\agent\lwst.jdk.jar -Djennifer.config=C:\jennifer\agent\X11.conf -javaagent:C:\jennifer\agent\lwst.javaagent.jar Windows Environment | 87
9.2.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in Oracle Application Server's JAVA option.
9.2.3.1 Configure JAVA Options for Oracle Application Server
● Oralce Application Server's JAVA option configuration file is %ORACLE_HOME %\opmn\conf\opmn.xml
● For JAVA_Option of Oracle Application Server configuration files, refer to Installa tion guide 1.2.4 to find instructions to set options in opmn.xml,
For Windows, must set option -Xbootclasspath/p instead of -Xbootclasspat h^/p
If using JAVA version JDK 1.4 for older, do not set javaagent option
9.2.3.2 Restart Oracle Application Server and verify configuration
1. Register License Key
Restarting Oracle Application Server triggers JENNIFER Agent activation. Verify bel ow output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=C:\jennifer\agent\X11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true 88 | Install JENNIFER Agent on Oracle Application Server
license_filename=C:\jennifer\agent\license.txt :ExpireDate: 2011-06-28 logfile=c:\jennifer\agent\X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation].
● In [Properties | License Management] menu, Registered License Key.
2. Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
Check if the profile data such as method and SQL is displayed properly whe n a dot on the X-View is selected and detail information is displayed in X-Vi ewer.
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
9.2.3.3 Removing JENNIFER Agent Configuration
1. Stop Oracle Application Server 2. Delete JENNIFER Agent options from file, %ORACLE_HOME%\opmn\conf\ opmn.xml 3. Delete JENNIFER Native Library 4. Restart Oracle Application Server 10. Install JENNIFER Agent on GlassFish
10.1UNIX Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
10.1.1Install on GlassFish Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 10-1 Sample Agent Installation Configuration
Sample Environment Directory
JENNIFER Agent Home Directory /home/jennifer/agent JAVA HOME Directory /usr/java 192.168.0.139 192.168.0.139
10.1.2Pre-Installation Steps
Run the preinstall.sh file in the JENNIFER agent directory.
10.1.2.1 JAVA_HOME
Set JAVA_HOME directory used by GlassFish. After checking the JAVA_HOME used by GlassFish, generate lwst.jdk.jar file.
89 90 | Install JENNIFER Agent on GlassFish
######################################################## Step 1. Build LWST ########################################################
Type the JAVA_HOME directory which is used by Java Application Server.
Input [JAVA_HOME] which is used for Java Application Server. ===>> /usr/java [/usr/java] is set as JAVA_HOME
Creating lwst.jdk.jar ....
LWST(lwst.jdk.jar) build successful
10.1.2.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify appropriate native library for installed system then execut e test.sh to verify it. Copy libjennifer20.so(sl) which has passed the test sucessfully to Agent Home directory.
######################################################## Step 2. JENNIFER NATIVE LIBRARY SETTING ########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/home/jennifer/agent/libjennifer20.so file is copied successfully
10.1.2.3 Agent Configuration
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi UNIX Environment | 91
fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
######################################################## Step 3. JENNIFER AGENT CONFIGURATION SETTING ######################################################## Do you want to customize agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char] ex) W11 ===>> X11 license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_X11.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 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 [Pre-Installation is finished]
표 10-2 Options for JENNIFER Configuration Files
Option Description
agent_name Agent name composed in 3 alpha-numeric characters license_filename Set name and directory of file which stores JENNIFER License Key logfile Set name and directory of file which stores JENNIFER Log files agent_tcp_port Set Port which will bind to JENNIFER Agent udp_server_host Set IP Address of server machine where JENNIFER Server is installed
10.1.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where GlassFish option is applied.
[ Pre-Installation Summary ] Java Application Server Home Directory : JDK Home Directory : /usr/java Jennifer Agent Directory : /home/jennifer/agent Jennifer LWST file : /home/jennifer/agent/lwst.jdk.jar Jennifer Native library file : /home/jennifer/agent/libjennifer20.so(sl) 92 | Install JENNIFER Agent on GlassFish
####################################################################### Please add the following configuration to your web application Server ####################################################################### -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/ lwst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -Djennifer.config=/home/jennifer/agent/X11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
10.1.3Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in GlassFish, JAVA option.
10.1.3.1 Copy JNI File
Copy /home/jennifer/agent/libjennifer20.so(sl) file which has successfully passed JNI test in sun.boot.library.path directory of JDK in use.
10.1.3.2 Set GlassFish Java Option
● Select from GlassFish Console, menu [ Application Server | JVM Setting | JVM Set ting | JVM Options ].
● For JAVA_Option of GlassFish configuration files, refer to Installation guide 1.2.4 to find instructions to set options.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
For GlassFish 3, set option for JENNIFER Agent library in $GLASSFISH_HOM E/osgi/felix/conf as described below
org.osgi.framework.bootdelegation=javax.transaction, javax.transaction.*, \ org.omg.CORBA, \ ${eclipselink.bootdelegation}, \ com.sun.btrace, com.sun.btrace.*, \ com.javaservice, com.javaservice.*, \ org.netbeans.lib.profiler, UNIX Environment | 93
org.netbeans.lib.profiler.*
10.1.3.3 Restart GlassFish and verify configuration
1. Register License Key
Restarting GlassFish triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=/home/jennifer/agent/W11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=/home/jennifer/agent/license.txt :ExpireDate: 2011-06-28 logfile=/home/jennifer/agent/jennifer_X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ------OS/Java=Linux,,Java(TM) SE Runtime Environment,Java HotSpot(TM) Server VM,10.0-b23 sun.boot.class.path==/home/jennifer/agent/jennifer.boot.jar:/home/jennifer/ agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar ... sun.boot.library.path=/usr/java/jre/lib/i386 ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation] in installation guide.
● Register the valid license number in the [Properties | License Key Management] 94 | Install JENNIFER Agent on GlassFish
menu.
2. Verify Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
10.1.3.4 Removing JENNIFER Agent Configuration
1. from GlassFish management console, [ Application Server | JVM Setting | JVM Se tting | JVM Options ], Delete JENNIFER Agent configuration option. 2. For GlassFish 3, delete JENNIFER Agent Option from ($GLASSFISH_HOME/osgi/f elix/conf) 3. Stop GlassFish 4. Delete JENNIFER Native Library files 5. Restart GlassFish.
10.2Windows Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
10.2.1Install on GlassFish Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation. Windows Environment | 95
표 10-3 Sample JENNIFER Agent Configuration
Sample Environment Directory
JENNIFER Agent Home Directory c:\jennifer\agent JAVA Home Directory C:\Program Files\Java\jdk1.6.0_15 JENNIFER Server IP Address 192.168.0.139
10.2.2Pre-Installation Steps
From JENNIFER Agent Directory, execute preinstall.bat file under administrator privil ege
10.2.2.1 Set JAVA_HOME
Set JAVA HOME directory used by GlassFish then generate lwst.jdk.jar file.
################################################### Step 1. Build LWST ###################################################
Input [JAVA_HOME] which is used for Java Application Server (Enter "q" to quit):C:\Program Files\Java\jdk1.6.0_15 C:\Program Files\Java\jdk1.6.0_15 is set as JAVA_HOME "Creating lwst.jdk.jar..."
"LWST build successful"
lwst.jdk.jar is created successfully
10.2.2.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify the native library file suitable for installed system, then te st it. If the memory size is over 2GB, select ‘y’ key, otherwise, select ‘n’ key.
################################################### Step 2. JENNIFER NATIVE LIBRARY SETTING ###################################################
Does your system have more than 2GB ?(Y/N) : y jennifer20.dll has been copied to C:\Program Files\Java\jdk1.6.0_15 96 | Install JENNIFER Agent on GlassFish
successfully.
10.2.2.3 Configure JENNIFER Agent
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
################################################### Step 3. JENNIFER AGENT CONFIGURATION SETTING ###################################################
Do you want to customize agent configuration file at this time? (Y/N) : y license_filename [ex: C:\jennifer\agent\license.txt] : Pleaes enter AGENT name. AGENT name must be 3 characters long, first charater must be alphabet anemaining characters must be numbers e.g. [W11] : X11 logfile [ex: C:\jennifer\agent\X11.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] :
Do you have any option(s) that you want to change?(Y/N)n
10.2.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where GlassFish option is applied.
[Pre-Installation Summary] JAVA HOME DIRECTORY : C:\Program Files\Java\jdk1.6.0_15 JENNIFER AGENT DIRECROTY : C:\jennifer\agent JENNIFER AGENT CONFIGURATION FILE : C:\jennifer\agent\X11.conf Windows Environment | 97
JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Program Files\Java\jdk1.6.0_15\bin\jennifer20.dll
[Post-Installation options] -Xbootclasspath/p:C:\jennifer\agent\lwst.boot.jar;C:\jennifer\agent\jennife r.boot.jar;C:\jennifer\agent\lwst.jdk.jar -Djennifer.config=C:\jennifer\agent\X11.conf -javaagent:C:\jennifer\agent\lwst.javaagent.jar
10.2.3Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in GlassFish's JAVA option.
10.2.3.1 Configure JAVA Options for GlassFish
● From GlassFish management console, choose [ Application Server | JVM Setting | JVM Options ]
● From GlassFish management console, set option as described in Installation Guid e section 2.2.4
If using JAVA version JDK 1.4 for older, do not set javaagent option.
In case of GlassFish 3 Set JENNIFER Agent library in %GLASSFISH_HOME% \osgi\felix\conf as described below.
org.osgi.framework.bootdelegation=javax.transaction, javax.transaction.*, \ org.omg.CORBA, \ ${eclipselink.bootdelegation}, \ com.sun.btrace, com.sun.btrace.*, \ com.javaservice, com.javaservice.*, \ org.netbeans.lib.profiler, org.netbeans.lib.profiler.*
10.2.3.2 Restart GlassFish and verify configuration
1. Register License Key 98 | Install JENNIFER Agent on GlassFish
Restarting GlassFish triggers JENNIFER Agent activation. Verify below output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=C:\jennifer\agent\X11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=C:\jennifer\agent\license.txt :ExpireDate: 2011-06-28 logfile=c:\jennifer\agent\X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation].
● In [Properties | License Management] menu, Registered License Key.
2. Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring" Windows Environment | 99
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
10.2.3.3 Removing JENNIFER Agent Configuration
1. In GlassFish management console, [ Application Server | JVM Setting | JVM Opti ons ], delete option for JENNIFER Agent configuration. 2. For GlassFish 3, Delete JENNIFER Agent Configuration options from (%GLASSFI SH_HOME%\osgi\felix\conf) 3. Stop GlassFish 4. Removing JENNIFER Agent Configuration 5. Removing JENNIFER Agent Configuration
11. Install JENNIFER Agent on SUN Application Server
11.1 UNIX Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process
11.1.1 Install on SUN Application Server Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation.
표 11-1 Sample JENNIFER Agent Installation Configuration
Sample Environment Directory
JENNIFER Agent Home Directory /home/jennifer/agent JAVA HOME Directory /usr/java JENNIFER Server IP Address 192.168.0.139
11.1.2 Pre-Installation Steps
Run the preinstall.sh file in the JENNIFER agent directory.
11.1.2.1 Set JAVA_HOME
Set JAVA_HOME directory used by SUN Application Server. After checking the JAVA _HOME used by SUN Application Server, generate lwst.jdk.jar file.
101 102 | Install JENNIFER Agent on SUN Application Server
######################################################## Step 1. Build LWST ########################################################
Type the JAVA_HOME directory which is used by Java Application Server.
Input [JAVA_HOME] which is used for Java Application Server. ===>> /usr/java [/usr/java] is set as JAVA_HOME
Creating lwst.jdk.jar ....
LWST(lwst.jdk.jar) build successful
11.1.2.2 Configure Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify appropriate native library for installed system then execut e test.sh to verify it. Copy libjennifer20.so(sl) which has passed the test sucessfully to Agent Home directory.
######################################################## Step 2. JENNIFER NATIVE LIBRARY SETTING ########################################################
Is Web Application Server running with the -d64 option? [y/n]
libjennifer20_AMDx86.64.so test fail libjennifer20_ibm_ppc64.so test fail
libjennifer20_linux_32_32.so test success
/home/jennifer/agent/libjennifer20.so file is copied successfully
11.1.2.3 Agent Configuration
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi UNIX Environment | 103
fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
######################################################## Step 3. JENNIFER AGENT CONFIGURATION SETTING ######################################################## Do you want to customize agent configuration file ? [y/n]
Input the Agent Name [exactly 3 char] ex) W11 ===>> X11 license_filename [ /home/jennifer/agent/license.txt ] ? logfile [ /home/jennifer/agent/jennifer_X11.log ] ? agent_tcp_port [ 7750 ] ? udp_server_host [ localhost ] ? 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 [Pre-Installation is finished]
표 11-2 Options for JENNIFER Configuration Files
Option Description
agent_name Agent name composed in 3 alpha-numeric characters license_filename Set name and directory of file which stores JENNIFER License Key logfile Set name and directory of file which stores JENNIFER Log files agent_tcp_port Set Port which will bind to JENNIFER Agent udp_server_host Set IP Address of server machine where JENNIFER Server is installed
11.1.2.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where SUN Application Server option is applied.
[ Pre-Installation Summary ] Java Application Server Home Directory : JDK Home Directory : /usr/java Jennifer Agent Directory : /home/jennifer/agent Jennifer LWST file : /home/jennifer/agent/lwst.jdk.jar Jennifer Native library file : /home/jennifer/agent/libjennifer20.so(sl) 104 | Install JENNIFER Agent on SUN Application Server
####################################################################### Please add the following configuration to your web application Server ####################################################################### -Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/ lwst.boot.jar:/home/jennifer/agent/jennifer.boot.jar -Djennifer.config=/home/jennifer/agent/X11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
11.1.3 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in SUN Application Server, JAVA option.
11.1.3.1 Copy JNI Files
Copy /home/jennifer/agent/libjennifer20.so(sl) file which has successfully passed JNI test in sun.boot.library.path directory of JDK in use.
11.1.3.2 JAVA Option Configuration for SUN Application Server 7
● SUN Application Server configuration file is usually found in $SUNWAS_HOME/d omains/domain1/server1/config/server.xml
● For JAVA_Option of SUN Application Server configuration files, refer to Installati on guide 1.2.4 to find instructions to set options.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
11.1.3.3 JAVA Option Configuration for SUN Application Server 8.x / 9.x / 10.x
● From management console menu, choose [ Application Server | JVM Setting | JV M Setting | JVM Options ]
● For JAVA_Option of SUN Application Server configuration files, refer to Installati on guide 1.2.4 to find instructions to set options.
If using JAVA version JDK 1.4 for older, do not set javaagent option. UNIX Environment | 105
11.1.3.4 Restart SUN Application Server and verify configuration
1. Register License Key
Restarting SUN Application Server triggers JENNIFER Agent activation. Verify belo w output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=/home/jennifer/agent/W11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=/home/jennifer/agent/license.txt :ExpireDate: 2011-06-28 logfile=/home/jennifer/agent/jennifer_X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ------OS/Java=Linux,,Java(TM) SE Runtime Environment,Java HotSpot(TM) Server VM,10.0-b23 sun.boot.class.path==/home/jennifer/agent/jennifer.boot.jar:/home/jennifer/ agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar ... sun.boot.library.path=/usr/java/jre/lib/i386 ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation] in installation guide.
● Register the valid license number in the [Properties | License Key Management] menu. 106 | Install JENNIFER Agent on SUN Application Server
2. Verify Monitoring Data
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer.
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
11.1.3.5 Removing JENNIFER Agent Configuration
1. Stop SUN Application Server. 2. For SUN Application Server 8.x/9.x/10.x, from management console menu, dele te JENNIFER Agent configuration from [ Application Server | JVM Setting | JVM S etting | JVM Options ] 3. For SUN Application Server 7, delete JENNIFER Agent configuration option from $SUNWAS_HOME/domains/domain1/config/server.xml 4. Delete JENNIFER Native Library files. 5. Restart SUN Application Server.
11.2 Windows Environment
The JENNIFER agent installation process has three steps: Pre-installation, Post-installa tion and Checking process.
11.2.1 Install on SUN Application Server Environment
To help users understand how to install the JENNIFER agent, the following table pres ents the sample environment information for the JENNIFER server where the JENNIF ER agent is installed. User must use appropriate information according to their syste m environment during actual installation. Windows Environment | 107
표 11-3 Sample JENNIFER Agent Configuration
Sample Environment Directory
JENNIFER Agent Home Directory c:\jennifer\agent JAVA Home Directory C:\Program Files\Java\jdk1.6.0_15 JAVA Home Directory 192.168.0.139
11.2.2 Pre-Installation Steps
11.2.3 Pre-Installation Steps
11.2.3.1 Set JAVA_HOME
Set JAVA HOME directory used by SUN Application Server then generate lwst.jdk.jar file.
################################################### Step 1. Build LWST ###################################################
Input [JAVA_HOME] which is used for Java Application Server (Enter "q" to quit):C:\Program Files\Java\jdk1.6.0_15 C:\Program Files\Java\jdk1.6.0_15 is set as JAVA_HOME "Creating lwst.jdk.jar..."
"LWST build successful"
lwst.jdk.jar is created successfully
11.2.3.2 Set Native Library
The native library is used to collect the system CPU and memory information from th e JENNIFER Agent. Identify the native library file suitable for installed system, then te st it. If the memory size is over 2GB, select ‘y’ key, otherwise, select ‘n’ key.
################################################### Step 2. JENNIFER NATIVE LIBRARY SETTING ###################################################
Does your system have more than 2GB ?(Y/N) : y 108 | Install JENNIFER Agent on SUN Application Server
jennifer20.dll has been copied to C:\Program Files\Java\jdk1.6.0_15 successfully.
11.2.3.3 Configure JENNIFER Agent
Edit JENNIFER agent Configuration files. Agent name must be assigned and it must b e three characters long. For all values except Agent name, if not input value has bee n entered, the default value will be used. If Agent configuration is not desired(select value ‘n’ ), JENNIFER Configuration file is not generated. In such case, user may modi fy the w11.conf or jennifer.conf provided by JENNIFER then used them.
################################################### Step 3. JENNIFER AGENT CONFIGURATION SETTING ###################################################
Do you want to customize agent configuration file at this time? (Y/N) : y license_filename [ex: C:\jennifer\agent\license.txt] : Pleaes enter AGENT name. AGENT name must be 3 characters long, first charater must be alphabet anemaining characters must be numbers e.g. [W11] : X11 logfile [ex: C:\jennifer\agent\X11.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] :
Do you have any option(s) that you want to change?(Y/N)n
11.2.3.4 Options to Consider
Lastly, check the inputted in values in configuration file setting data then add below options in where SUN Application Server option is applied.
[Pre-Installation Summary] JAVA HOME DIRECTORY : C:\Program Files\Java\jdk1.6.0_15 JENNIFER AGENT DIRECROTY : C:\jennifer\agent JENNIFER AGENT CONFIGURATION FILE : Windows Environment | 109
C:\jennifer\agent\X11.conf JENNIFER NATIVE LIBRARY INSTALLATION DIRECTORY : C:\Program Files\Java\jdk1.6.0_15\bin\jennifer20.dll
[Post-Installation options] -Xbootclasspath/p:C:\jennifer\agent\lwst.boot.jar;C:\jennifer\agent\jennife r.boot.jar;C:\jennifer\agent\lwst.jdk.jar -Djennifer.config=C:\jennifer\agent\X11.conf -javaagent:C:\jennifer\agent\lwst.javaagent.jar
11.2.4 Post-Installation Steps
During Post-installation steps, set the paths for the library and agent configuration fil es prepared during pre-installation steps in SUN Application Server's JAVA option.
11.2.4.1 Configure JAVA Options for SUN Application Server 7
● SUN Application Server configuration file is usually found in %SUN_WAS_HOME %\domains\domain1\server1\config\server.xml
● For JAVA_Option of SUN Application Server configuration files, refer to Installati on guide 2.2.4 to find instructions to set options.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
11.2.4.2 Configure JAVA Options for SUN Application Server 8.x/9.x/10.x
● from management console menu, choose [ Application Server | JVM Setting | JV M Options]
● For JAVA_Option of JBOSS configuration files, refer to Installation guide 2.2.4 to find instructions to set options.
If using JAVA version JDK 1.4 for older, do not set javaagent option.
11.2.4.3 Restart SUN Application Server and verify configuration
1. Register License Key 110 | Install JENNIFER Agent on SUN Application Server
● Restarting SUN Application Server triggers JENNIFER Agent activation. Verify bel ow output.
● Check whether the JENNIFER agent log is generated in the designated directory/f ile. Look the following messages in log file which verifies the activation of JENNIF ER Agent.
JENNIFER 4.5.3(2011-10-04) started. agent_name=X11 jennifer.config=C:\jennifer\agent\X11.conf agent_tcp_port=7751 udp_server_host=192.168.0.139 server_udp_runtime_port=6901 server_udp_listen_port=6902 server_udp_lwst_call_stack_port=6703 enable=true license_filename=C:\jennifer\agent\license.txt :ExpireDate: 2011-06-28 logfile=c:\jennifer\agent\X11.log LWST enabled=true enable_jdbc_sql_trace=true enable_jdbc_oracle_dependency_used=false enable_extra_agent=true ... JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully. ------
As shown above, if the “libjennifer20.so(sl) shared library loaded successfully.” mes sage does not appear, refer to [Troubleshooting for Installation].
● In [Properties | License Management] menu, Registered License Key.
2. * In [Properties | License Management] menu, Registered License Key.
● Perform or wait for submission of service request then verify whether new dots a re displayed on the X-View screen.
● Check if the profile data such as method and SQL is displayed properly when a d ot on the X-View is selected and detail information is displayed in X-Viewer. Windows Environment | 111
If no SQL is displayed, refer to JENNIFER Manual, "Resource and JDBC Moni toring"
● See if the classes loaded in the [ Problem Determination | Utility | Loading Class Li st ] menu appear properly.
11.2.4.4 Removing JENNIFER Agent Configuration
1. Stop SUN Application Server 2. For SUN Application Server 8.x/9.x/10.x, delete JENNIFER Agent Configuration f rom [ Application Server | JVM Setting | JVM Setting | JVM Options ] 3. For SUN Application Server 7, delete JENNIFER Agent Configuration option from %SUNWAS_HOME%\domains\domain1\config\server.xml 4. Delete JENNIFER Native Library. 5. Restart SUN Application Server.
12. Install JENNIFER Agent on AS400
12.1 Install JENNIFER Agent on AS400 WebSphere
For AS400 WebSphere 6.0, instruction for installing JENNIFER Agent is provided in t his document. For version 6.1, instruction is same as WebSphere on UNIX, but there are few exceptions which is also described here.
12.1.1 WebSphere 6.0 ND, Express Version
12.1.1.1 Prerequisite
WebSphere 6.0 use JDK1.4, thus below system patch must be applied before installi ng JENNIFER.
V5R3M0 ( SI27807 , MF41376 ) V5R3M5 ( SI27807 , MF41469 ) V5R4M0 ( SI27808 , MF41505 )
● Below two files must be available in Java application server.
/QIBM/ProdData/Java400/jt400ntv.jar /QIBM/ProdData/Java400/jdk14/lib/instrumentation.jar
Mentioned system patch must be installed for above files to be available.
113 114 | Install JENNIFER Agent on AS400
without jt400ntv.jar, CPU monitoring is not possible.
12.1.1.2 WebSphere Configuration Step
1. In boot class path of WebSphere management console, set options as described below.
/QIBM/ProdData/Java400/jt400ntv.jar /QIBM/UserData/WebSphere/jennifer40/agent/jennifer.jar /QIBM/ProdData/Java400/jdk14/lib/instrumentation.jar /QIBM/UserData/WebSphere/jennifer40/agent/lwst.boot.jar
2. In WebSphere management console, for JVM options, set options as described below.
-agentlib:QJVAIAGENT=/QIBM/UserData/WebSphere/jennifer40/agent/lwst.javaage nt.jar -Dos400.jvmti.force.jitc -Djennifer.confing=/QIBM/UserData/WebSphere/jennifer40/agent/w11.conf
3. Configure agent to retrieve CPU monitoring data.
sysprof=As400
4. Check Jennifer AS400 sysprof initialized message in jennifer.log
12.1.2 Install on WebSphere 6.1
12.1.2.1 WebSphere Configuration Step
1. In boot class path of WebSphere management console, set options as described below
/QIBM/UserData/WebSphere/jennifer40/agent/lwst.boot.jar /QIBM/UserData/WebSphere/jennifer40/agent/jennifer.boot.jar
2. In WebSphere management console, for JVM options, set options as described Install JENNIFER Agent on AS400 WebSphere | 115
below.
-javaagent:/QIBM/UserData/WebSphere/jennifer40/agent/lwst.javaagent.jar -Djennifer.confing=/QIBM/UserData/WebSphere/jennifer40/agent/w11.conf
3. Configure agent to retrieve CPU monitoring data.
sysprof=As400
4. Check Jennifer AS400 sysprof initialized message in jennifer.log
12.1.3 Exceptions in monitoring AS400 WebSphere
● System cpu usage cannot be monitored
● System memory, process memory usage cannot be monitored
● File / Socket / Collection monitoring is not possible.
13. Install JENNIFER Agent in OS390 z/OS
13.1 Install JENNIFER Agent on IBM WebSphere, z/OS
Installing JENNIFER Agent on z/OS is different from UNIX environment. JENNIFER Ag ent cannot be installed using preinstall.sh, but it must be installed manually. First, co py JENNIFER Agent files in z/OS system where WebSphere is installed.
13.1.1 LWST Build
In UNIX or Windows environment, lwst40.sh(bat) command can be used to generat e lwst.jdk.jar file but this is not possible in z/OS environment. 1. Download $WEBSPHERE_HOME/java/jre/lib/rt.jar file. 2. From c:\jennifer\agent directory, using below option to build lwst then uploa d the generated lwst.jdk.jar file.
lwst40.bat jdk15 rt.jar
13.1.2 Execute wmond
In z/OS environment, JNI cannot be used to monitor cpu or memory usage data. wm ond is used to monitor cpu usage in z/OS environment.
From agent directory of system, run the command as described below.
nohup ./wmond_zos_v1.1 192.168.0.139 6901 Z01 &
117 118 | Install JENNIFER Agent in OS390 z/OS
When executed successfully, there will be two equalizer graph for monitori ng CPU uwage, "0" is for General CPU of mainframe and "1" is zAAP CPU only used by java
13.1.3 Java Option Configuration in WebSphere
From WebSphere management console, choose [Select Application Server | Define P rocess | Java Virtual System ] 1. Enter below values in book class path
/home/jennifer/agent/jennifer.boot.jar /home/jennifer/agent/lwst.jdk.jar /home/jennifer/agent/lwst.boot.jar
2. Enter below values in JVM option
-Djennifer.config=/home/jennifer/agent/W11.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar
3. Save the entered value 4. Set below values in Agent configuration files
using_adaptable_http_agent=true http_agent_classpath=/home/jennifer/agent/jennifer.http.jar 14. JENNIFER Agent Installation Troubleshooting
14.1 Changing JENNIFER Server Configuration
In this chapter, changing configuration for network communication port for JENNIFE R Agent and JENNIFER Server is discussed.
14.1.1 Change Configuration for Client
JENNIFER Server and JENNIFER Client use web-based display to provide user interfac e by using HTTP protocol. Default HTTP port number for Server-Client communicatio n is 7900. Also, default port number JENNIFER Server Stop is 7999. To change com munication port number, run $JENNIFER_HOME/server/bin/catalina.sh(bat) file. in c ase of Linux, change the below portion of catalina.sh file.
JAVA_HOME="$JAVA_HOME"
if [ -z "${STARTUP_PORT}" ] then export STARTUP_PORT="7900" fi
if [ -z "${SHUTDOWN_PORT}" ] then export SHUTDOWN_PORT="7999" fi
For Windows, change the below portion of catalina.bat file.
119 120 | JENNIFER Agent Installation Troubleshooting
set JAVA_HOME=%JAVA_HOME%
if "%STARTUP_PORT%" == "" SET STARTUP_PORT=7900 if "%SHUTDOWN_PORT%" == "" SET SHUTDOWN_PORT=7999
Java applet receives the data necessary for organizing the charts through TCP com munication from the JENNIFER server. The default TCP port number for the JENNIFE R server is 6701, and it is set by the server_tcp_port option in jennifer.properties file.
server_tcp_port = 6701
14.1.2 Change Configuration for Agents
The JENNIFER agent transmits the data related to the beginning and the end of all th e transactions through the UDP port, which is set using the server_udp_runtime_por t option of the JENNIFER server. This data is very small, and it is mostly used for an X- view charts. The default port number is 6901.
server_udp_runtime_port = 6901
The JENNIFER agent transmits general performance data, such as the arrival rate a nd the average response time, through the UDP port, which is set in the server_udp_ listen_port option of the JENNIFER server once every second. The default port numb er is 6902.
server_udp_listen_port = 6902
The JENNIFER agent transmits transaction frofile data of X-View through the UDP port, which is set in the server_udp_lwst_call_stack_port option of the JENNIFER serv er once every two-second. The default port number is 6903.
server_udp_lwst_call_stack_port = 6703
When modifying the UDP port number, make the change on the JENNIFER agent as well as the JENNIFER server. Install more than one JENNIFER Agent on same server | 121
It is necessary to assign the IP binding address that is used when the JENNIFER serv er receives the performance data transmitted by the JENNIFER agent via UDP. This va lue corresponds to the second parameter IP address of the new java.net.Datagram- Socket(port, ip) creator in the Java TCP socket programming. If there are multiple ne twork cards in the hardware, only the requests coming into each network card are a ccepted. However, if you set the udp_server_host attribute to "0.0.0.0", then you ca n receive the packets coming into all network cards.
udp_server_host = 0.0.0.0
14.1.3 Agent TCP Connection Options
If there is a firewall between the JENNIFER server and the JENNIFER agent or client, c hange its configuration, so that the port number can successfully pass through it.
● A user should be able to access the JENNIFER server through the HTTP 7900 and TCP 6701 ports from the user’ s computer.
● The JENNIFER agent should be able to access the JENNIFER server through the U DP 6901, 6902 and 6703 ports.
● A user should be able to access the JENNIFER agent through the TCP 7705 ports from the JENNIFER server.
Run firewall tests on the UDP network if JENNIFER Server registration is faili ng
14.2 Install more than one JENNIFER Agent on same server
During JENNIFER Installation, there are times when administrator install more than o ne JENNIFER agents on a single physical server with multiple instances. Following ch apter describes instruction for configuring JENNIFER Agent in under such condition. Asuming that all JENNIFER Agents installed reports to same JENNIFER Server, perfor m Agent Pre-Installation Steps just once. Once fist agent configuration is generated (ex w11.conf) copy and edit additional agent configuration files for each monitored 122 | JENNIFER Agent Installation Troubleshooting
instances. For example, copy w11.conf and rename to w12.conf. then change the o ption of newly created agent configuration file as described below.
표 14-1 Options to Change
Option Description
agent_name 3 letter agent name using alpha-numeric characters logfile directory path of JENNIFER Agent log files. agent_tcp_port TCP communication port which binds JENNIFER Server and JENNIFER Agent
For Java Application Server's Java option, change the directory path of appropriate Agent configuration file and native library.
14.3 JENNIFER Agent Installation Troubleshooting
In this chapter, problem which can arise during JENNIFER Agent Installation and poss ible solutions for these problems are discussed.
14.3.1 After Agent is installed, Web application won't start pro perly.
1. Make sure that there are no typos in entered JENNIFER configuration 2. If typo is not the cause, next likely cause is corrupted or ill-generated lwst file. R un lwst40.sh(bat) command to regenerate lwst file.
When generating lwst, it must use rt.jar(Sun JDK), core.jar(IBM JDK), vm.ja r(IBM JDK), jndi.jar(IBM JDK 1.6) file provided by JVM which JENNIFER Age nt is running on.
lwst build command : lwst40.sh(bat) [command option] [rt.jar(core.jar)]
For JAS which use JDK가 1.4, use safe in [commnad option]. For JDK 1.5, u se jdk15. JENNIFER Agent Installation Troubleshooting | 123
14.3.2 JENNIFER Agent is not registered in JENNIFER Server
1. check for typo in application server option, [-Djennifer.config], also if read acces s is also allowed. 2. For JENNIFER Agent option file, check if values for udp_server_host, server_udp _runtime_port, server_udp_listen_port, server_udp_lwst_call_stack_port is same as values entered in JENNIFER Server. 3. Sometimes, the restrictions imposed by the network equipment, such as a firew all, can hinder network communication. To resolve this problem, check whether or not the network is normal. For a TCP connection, use a simple telnet program to determine whether the port is open. for UDP ports, udptest.sh(bat) utility is p rovided to test connection as shown below.
RECV(6703) from=127.0.0.1 data=100 bytes
4. While testing server_udp_lwst_call_stack_port, if size of UDP data sent during te st is too big, then test may experience failure. In this case, the packet size of tran smitted data may be restricted at network or system level. JENNIFER also provide s option to limit packet size of test data. Lower the value for option xview_profil e_udp_packet_size and test to see if data is being transmitted properly.
14.3.3 JENNIFER Agent is registered but Application won't start
In JAS log-in screen, below message may be seen.
java.lang.NoClassDefFoundError: com/javaservice/jennifer/agent/HttpServiceTrace javax.servlet.http.HttpServlet.service(HttpServlet.java)
Confirm that below option has been properly configured in Agent configuration o ption.
using_adaptable_http_agent=true http_agent_classpath=c:/tmp/agent/jennifer.http.jar
14.3.4 Invalid License Key Message 124 | JENNIFER Agent Installation Troubleshooting
● Confirm that read access is set for the license file.
● Confirm from JENNIFER server that it can reach JENNIFER Agent via TCP connecti on. For default installation, port number is 7750 and this can be changed in JEN NIFER Agent option, ent_tcp_port.
If agent_tcp_port option is not set properly in JENNIFER Agent, menu item such as Problem Determination, Properties, and Real-Time Active Service lis t will not work.
14.3.5 CPU / Memory monitoring data is not displayed.
JENNIFER Agent' libjennifer20.so(sl) (jennifer20.dll for Windows) file is used for mon itoring system and Java Process CPU & Memory usage. If this library is not installed p roperly, then CPU and memory usage will not be displayed, however, this does not a ffect JENNIFER Agent's other operations.
If JENNIFER native library is not working properly, below error message will show in JENNIFER Agent log file. In this case, from JENNIFER client, go to [ Problem Determination | Utilities | System ENV ], select application Agent, t he confirm entered value for option sun.boot.library.path. Verify that libjen nifer20.so(sl) (jennifer20.dll for Windows) is copied.
● JENNIFER native library can be tested in JENNIFER Agent's jni/[OS] directory. Cha nge the file name to libjennifer20.so(sl) (jennifer20.dll for Windows) then run te st.sh(bat) then confirm if below message is displayed.
JENNIFER SysProf libjennifer20.so(sl) shared library loaded successfully.
In test.sh file, value for option java -Djava.library.path= must be set with ja va file which is used by Java application server.
● In case of Linux, if currentThreadCpuTime cannot be retrieved from JNI, Use belo w option to retrieve it. This only works for JDK 1.5 and above. JENNIFER Agent Installation Troubleshooting | 125
sysprof=ThreadCpuJava5
14.3.6 There are no data plots in X-View
If there is no data displayed in X-View despite the fact that JENNIFER agent is registe red with JENNIFER Server and there is no connection problem between server and a gent, use the below method to look for cause.
● Confirm that Framework struts2 is being used. If struts2 is used, perform below s etting in JENNIFER Configuration file.
http_service_class =org.apache.struts2.dispatcher.FilterDispatcher http_service_method=doFilter
● Confirm if there is class which overrides service method of javax.servlet.http.Http Servlet class. if so, input the overriding class name in JENNIFER Agent option, htt p_service_class
14.3.7 SQL data is not being displayed in X-View profile.
JDBC connection tracing indicates wrapping java.sql.Connection object to JenniferC onnection object. JENNIFER provides 3 methods for JDBC Connection tracing. 1. Type 1 is using JNDI and javax.sql.DataSource to trace connection object and thi s does not require additional configuration within JENNIFER Agent.
Only JDBC requests from Servlet/JSP Thread are displayed. If monitoring re quests from Non Servlet/JSP Thread is needed, enable option enable_non_ servlet_thread_jdbc_trace = true manually.
2. From application, using java.sql.DriverManager class to identify java.sql.Connect ion object is type 2. 3. Using custom class, which used to manage application's connection pools, to als o manage java.sql.Connection object is known as type 3.
In case of type 2 JDBC connection object, if conn = DriverManager.getConnection (“jdbc:apache:commons:dbcp:/poolname”) is used in source code, use below option in JENNIFER Configuration file. 126 | JENNIFER Agent Installation Troubleshooting
user_defined_jdbc_connectionpool_prefixes=jdbc:apache:commons:dbcp
For type 3 JDBC connection object, use below option in JENNIFER Agent configura tion option for method which returns java.sql.connection.
jdbc_connection_get=db.DBConnectionManager.getConnection(String)
14.3.7.1 Caution when configuring in type 3 method
● Use class name which include package name. For method parameter use class na me or without package name.
● The return value for methods configured for jdbc_connection_get or jdbc_conne ction_justget option must be in java.sql.Connection form.
● At least one parameter for methods configured for jdbc_connection_close optio n must be in java.sql.Connection form Hoever, the location of parameter is not i mportant.
● For all options, use semi-columne to enter more than one values.
Java application server instance must be restarted before changes in config urations take effect.
14.3.7.2 JDBC Confituation Steps for each Framework
● Using Hibernate
jdbc_connection_justget = org.hibernate.jdbc.ConnectionManager.getConnection()
● Using iBatis
jdbc_connection_get=com.ibatis.sqlmap.engine.transaction.jdbcJdbcTransactio n.getConnection()
● Using Apache DBCP JENNIFER Agent Installation Troubleshooting | 127
jdbc_connection_get = org.apache.commons.dbcp.PoolingDataSource.getConnection()
14.3.7.3 If JDBC Connection method is not known...
1. In Agent configuration file, input DB port number for lwst_trace_remote_port o ption. (Delete # at the start). 2. Restart Application Server 3. In JENNIFER management console, go to 「Problem Determination」→「File/Socket」 and check the stacktrace data for when connection to the applicable port is bein g made. 4. After verifying Connection, configure it in jdbc_connection_get or jdbc_connect ion_justget in agent option.
14.3.7.4 When SQL parameter is now displayed in X-View profiling data
If file.encoding for JENNIFER Agent and Server are different from eachother, certain monitoring data may not display properly in JENNIFER dashboard. In this case, copy t he file.encoding value from JENNIFER server to JENNIFER Agent.
14.3.7.5 IF after installing JENNIFER Agent, native Memory Leak occurs...
If Native Memory Leak occurs in Sun java 1.5, 6.0, add the below option in applicati on server's java option.
-XX:CompileCommand=exclude,org/apache/jennifer/bcel/classfile/Attribute,rea dAttribute
14.3.7.6 If Application Cookie information cannot be found after installing JEN NIFER Agent...
JENNIFER uses cookie in order to monitor number of unique visitors and concurrent users. Since there are limits to the size and number of available cookies, if existing ja va application(s) is using many cookies, visitor count and concurrent user count may not display properly. In this case, use the below option.
hotfix_remote_address_for_wmonid = true 128 | JENNIFER Agent Installation Troubleshooting
14.3.7.7 If JENNIFER Agents are installed in multiple processes with same confi guration option
JENNIFER must be configured for each java process. For each java process, option "- Djennifer.config" must be inputted with different settings.
However, for some JAS or java daemon, multiple java processes may be triggered by same command. In those instances, -Djennifer.config options cannot be different from one to another.
In the case where multiple java processes are triggered by same command, use opt ion -Dconfig.auto=true for shared java process configuration
For more detail, please refer in JENNIFER User Guide, section "Install JENNIFER in Multiple Process under chapter "JENNIFER Agent Management"
14.3.7.8 Request Remote Technical Support
Before contacting technical support personel, please go to JenniferSoft website and check Document or Q&A page first. Many latest user guides and documents, answer s to frequently asked technical questions are available here.
If any part of this document is unclear or when experiencing technical problem dur ing installation and configuration of JENNIFER, our support team provides technical s upport services as free-of-charge.
When experiencing problem during installation, please gather Java application serv er, DBMS, JENNIFER Server/Agent information along with description of problem at hand and send it as attached to [email protected].
JENNIFER Version information can be identified by runnning version.sh in JENNIFE R Agent directory.