Академический Документы
Профессиональный Документы
Культура Документы
The customer acknowledges and agrees that (a) the System and all related documentation are confidential
trade secrets of DevStream Corporation and (b) title to and intellectual property rights in the System and
related documentation (including without limitation all copyright, trademark, trade secret and patent
rights) are and shall remain the confidential proprietary property and information of DevStream
Corporation.
The customer shall use the system only in accordance with this Agreement. The customer shall not
disclose, copy, or reproduce any portion of the system or documentation in any form to any third person
without the prior written consent of DevStream Corporation, nor allow third parties to do the same. The
customer shall keep the System and all confidential information in the strictest confidence.
1 Introduction.......................................................... 5
1.1 JView 2004 Enterprise Edition ..........................................5
1.2 JView 2004 Documentation ..............................................7
1.2.1 JView 2004 Installation Guide ........................................7
1.2.2 JView 2004 Agent Installation Guide for Application Servers 7
1.2.3 JView 2004 Users Guide................................................8
1.3 Purpose and Scope .........................................................8
1.4 Supporting Documents ....................................................8
1.5 Other DevStream Resources ............................................9
2 Overview of Installation ...................................... 10
2.1 JView 2004 Application Overview ...................................10
2.1.1 JView 2004 Agent ...................................................... 11
2.1.2 JView 2004 Nucleus Server (NS)................................... 11
2.1.3 JView 2004 Performance Console (PConsole) .................. 11
2.2 JView Terms and Definitions ..........................................12
2.3 System Requirements ...................................................14
2.3.1 Agent Requirements................................................... 14
2.4 Supported Platforms, Application Servers, JDKs, and
Databases ..........................................................................14
2.5 Order of Installation ......................................................15
3 Preparing for Installation .................................... 16
3.1 Information required before Install.................................16
3.2 Upgrading from Previous Versions ..................................16
4 Agent Installation Instructions for Windows ........ 17
4.1 Pre-Install ....................................................................17
4.2 JView Agent Installation ................................................17
5 Agent Installation Instructions for Solaris............ 19
5.1 Pre-Install ....................................................................19
5.2 JView Agent Installation ................................................19
6 Agent Installation Instructions for Linux.............. 21
6.1 Pre-Install ....................................................................21
6.2 JView Agent Installation ................................................21
7 Agent Installation Instructions for HP-UX ............ 23
7.1 Pre-Install ....................................................................23
7.2 JView Agent Installation ................................................23
8 Agent Installation Instructions for AIX................. 25
8.1 Pre-Install ....................................................................25
8.2 JView Agent Installation ................................................25
9 Agent Installation Instructions for Tru64 ............. 27
1 Introduction
DevStream delivers J2EE performance tuning solutions, from JView 2004 Enterprise
Edition to professional service consulting for performance tuning.
JView 2004 is the industry's only Production Ready native code Java Performance
Monitor, allowing for in-depth Production Java performance monitoring due to its low
overhead. JView 2004 delivers full spectrum analysis of method metric transaction
time and method CPU time, along with thread stack views and SQL runtime
statistics.
You can benefit from JView 2004 Enterprise Edition in the following ways:
• Meet your SLA's. Companies can feel confident that they can meet their
Service Level Agreements by using JView's configurable SLA Monitoring View.
DevStream provides additional Agent Installation Guides for the following Application
Servers: WebLogic, WebSphere, Oracle 9iAS/10iAS and Orion Servers, JBoss,
SunOne, JRun, Tomcat, and Caucho Resin.
• JView 2004 Product Brief – download the JView 2004 Product Brief to
easily distribute and summarize the benefits and features of JView to the rest
of your team members.
http://www.devstream.com/JView2004/JView2004Brief.pdf
2 Overview of Installation
This document describes the procedures to successfully install the JView 2004 Agent
on a WebLogic Application Server. For detailed instructions on Nucleus Server and
Performance Console installation, please read the JView 2004 Installation Guide for
BEFORE completing these instructions.
NOTE: If you are upgrading from a previous version of JView, please refer to
“Upgrading from a Previous Installation” under the “Preparing for Installation”
section of this document.
Additionally, the agent obtains hardware CPU and JVM memory data. Unique to
JView 2004 is the calculation of the agent's overhead, displayed in the Performance
Console, to assist you in instrumentation configuration decisions.
The NS can also be configured to store data in the JView Enterprise database. This
allows historical reports to be generated via JView MReports, providing metric data
reports in multiple formats including HTML, XML, and PDF.
Nucleus Server – The Nucleus Server is the middleware component of JView 2004
Enterprise Edition. The JView 2004 Nucleus Server (NS) is the central point for data
retrieval and storage in JView 2004. The NS receives data from JView 2004 Agents
and makes this data available to JView Performance Consoles, while also storing the
data in the MReports/Historical database.
JView Agent - The JView 2004 Agent runs within inside your Application Server's
JVM, obtaining performance metrics at low cost using dynamic Bytecode
instrumentation.
PConsole - The JView 2004 Performance Console (PConsole) is the main delivery
point of JView 2004 data. The JView 2004 PConsole connects directly to the JView
2004 NS to obtain method metric and SQL data, along with JVM and cluster node
information. The PConsole contains 7 views, defined below:
Transaction Scope View - The Transaction Scope View gives a detailed view
on each individual transaction that runs through your application. This will
allow you to trace specific users, IP addresses, and Request URL's, helping
you troubleshoot a specific issue by understanding the code path that a
particular request took.
Method Hot Spot View - The Method Hot Spot view lets you quickly take a
look at the biggest consumers in your application. The view can be sorted by
a number of data points. The Method Hot Spot view will enable you to
execute Java Performance tuning at ease, as you easily determine which
method is consuming your resources.
SQLyzer Hot Spot View - The SQLyzer Hot Spot view lets you quickly
pinpoint largest SQL consumers in your application, providing the SQL query
itself, runtime statistics, and whether or not the SQL statement was prepared.
MReports - JView 2004's internal method and SQL metric reporting tool. MReports
can produce reports such as: Agent Node CPU and/or Heap, Top Ten Methods, Top
Ten JSPs, Top Ten Servlets, etc.
Operational Awareness Alert - The JView 2004 Nucleus Server runs the
Operational Awareness Alert (OAA) Server, where your custom SLA's are monitored
and custom actions are initiated. The OAA Server can send alerts to email or pager,
log violations to a database and/or file, as well as execute custom commands.
• 100 MB of memory
• 5 MB of disk space
Database Oracle 9.x, 8.x (Oracle and Weblogic Oracle jDrivers are supported)
Servers DB2 8.x
MS SQL Server 7.0, 2000
MySQL 3.x, 4.x
For each Nucleus Server, you’ll need to identify how many agent licenses will be
required to support the expected number of Agent/Nodes/CPUs for your application.
Once you have determined which applications should be monitored, walk through the
following steps with the architecture group:
4.1 Pre-Install
• Determine which Application Servers to install the Agent on. We suggest you
follow the pre-installation steps under the “Preparing for Installation” section
above.
• Ensure that your selected hosts meet the System Requirements (see “System
Requirements” and “Supported Platforms, Application Servers, JDKs, and
Databases” above).
The JView 2004 Agent runs within inside your Application Server's JVM. In order to
do so, you must make available the JView 2004 agent library (both native and Java
library). Once the Agent has been installed correctly, it will automatically run next
time you start up your application’s JVM.
• Install the JView 2004 download onto your Java application’s host.
o You may also simply copy the agent directory from <Your JView 2004
Install Dir>/agent to your Java Application server's file system.
• Edit your JVM's startup .bat file’s java startup command:
o Add the location of the <JView Install Dir>\agent\windows to the PATH.
• If you are setting the Java system property -Djava.library.path environment, add
the location of the <JView Install Dir>/agent/windows to the -Djava.library.path
variable.
• Add "-Xbootclasspath/a:<JView Install Dir>/agent/lib/JViewAgent.jar -
XrunJView:server=<IP of Nucleus Server>,port=4445,agentname=<MyAgent>"
directly after the "java" command (Note: replace tags with real data).
##################################################
### JVIEW 2004 EXAMPLE FOR WEBLOGIC 8.X ON WINDOWS
### Please change variables as necessary
##################################################
echo on
set BEA_HOME=C:\bea
set WL_HOME=%BEA_HOME%\weblogic81
set JAVA_HOME=%BEA_HOME%\jdk141_02
set PATH=%PATH%;%WL_HOME%\server\bin\oci920_8
set CLASSPATH=%CLASSPATH%;%WL_HOME%\server\lib\xerces.jar;
%WL_HOME%\server\lib\weblogic.jar;
set JAVA_OPTIONS=-ms256m -mx1024m
set SERVER_NAME=examplesServer
set WLS_USER=weblogic
set WLS_PW=weblogic
"%JAVA_HOME%\bin\java" -
Xbootclasspath/a:%JVIEW_HOME%/agent/lib/JViewAgent.jar -
XrunJView:server=127.0.0.1,port=4445,agentname=examplesServer
%JAVA_OPTIONS% -Dweblogic.Name=%SERVER_NAME%
-Dweblogic.management.username=%WLS_USER%
-Dweblogic.management.password=%WLS_PW%
-Dweblogic.ProductionModeEnabled=%PRODUCTION_MODE%
-Djava.security.policy="%WL_HOME%\server\lib\weblogic.policy"
weblogic.Server
5.1 Pre-Install
• Determine which Application Servers to install the Agent on. We suggest you
follow the pre-installation steps under the “Preparing for Installation” section
above.
• Ensure that your selected hosts meet the System Requirements (see “System
Requirements” and “Supported Platforms, Application Servers, JDKs, and
Databases” above).
The JView 2004 Agent runs within inside your Application Server's JVM. In order to
do so, you must make available the JView 2004 agent library (both native and Java
library). Once the Agent has been installed correctly, it will automatically run next
time you start up your application’s JVM.
• Install the JView 2004 download onto your Java application’s host.
o You may also simply copy the agent directory from <Your JView 2004
Install Dir>/agent to your Java Application server's file system.
• Edit your JVM's startup shell file’s java startup command:
o Add the location of the <JView>/agent/solaris to the LD_LIBRARY_PATH.
• If you are setting the Java system property -Djava.library.path environment, add
the locat ion of the <JView Install Dir>/agent/solaris to the -Djava.library.path
variable.
• Add "-Xbootclasspath/a:<JView Install Dir>/agent/lib/JViewAgent.jar -
XrunJView:server=<IP of Nucleus Server>,port=4445,agentname=<MyAgent>"
directly after the "java" command (Note: replace tags with real data).
##################################################
### JVIEW 2004 EXAMPLE FOR WEBLOGIC 8.X ON SOLARIS
### Please change variables as necessary
##################################################
BEA_HOME=/opt/bea
WL_HOME=$BEA_HOME/weblogic81
JAVA_HOME=$BEA_HOME/jdk141_02
PATH=$PATH:$WL_HOME/server/bin/oci920_8
CLASSPATH=$CLASSPATH:$WL_HOME/server/lib/xerces.jar:$WL_HOME/server/lib
/weblogic.jar
JAVA_OPTIONS="-ms256m -mx1024m"
SERVER_NAME=examplesServer
WLS_USER=weblogic
WLS_PW=weblogic
$JAVA_HOME/bin/java -
Xbootclasspath/a:$JVIEW_HOME/agent/lib/JViewAgent.jar -
XrunJView:server=127.0.0.1,port=4445,agentname=examplesServer
$JAVA_OPTIONS -Dweblogic.Name=$SERVER_NAME
-Dweblogic.management.username=$WLS_USER
-Dweblogic.management.password=$WLS_PW
-Dweblogic.ProductionModeEnabled=$PRODUCTION_MODE
-Djava.security.policy="$WL_HOME/server/lib/weblogic.policy"
weblogic.Server
6.1 Pre-Install
• Determine which Application Servers to install the Agent on. We suggest you
follow the pre-installation steps under the “Preparing for Installation” section
above.
• Ensure that your selected hosts meet the System Requirements (see “System
Requirements” and “Supported Platforms, Application Servers, JDKs, and
Databases” above).
The JView 2004 Agent runs within inside your Application Server's JVM. In order to
do so, you must make available the JView 2004 agent library (both native and Java
library). Once the Agent has been installed correctly, it will automatically run next
time you start up your application’s JVM.
• Install the JView 2004 download onto your Java application’s host.
o You may also simply copy the agent directory from <Your JView 2004
Install Dir>/agent to your Java Application server's file system.
• Edit your JVM's startup shell file’s java startup command:
o Add the location of the <JView>/agent/linux to the LD_LIBRARY_PATH.
• If you are setting the Java system property -Djava.library.path environment, add
the location of the <JView Install Dir>/agent/linux to the -Djava.library.path
variable.
• Add "-Xbootclasspath/a:<JView Install Dir>/agent/lib/JViewAgent.jar -
XrunJView:server=<IP of Nucleus Server>,port=4445,agentname=<MyAgent>"
directly after the "java" command (Note: replace tags with real data).
##################################################
### JVIEW 2004 EXAMPLE FOR WEBLOGIC 8.X ON Linux
### Please change variables as necessary
##################################################
BEA_HOME=/opt/bea
WL_HOME=$BEA_HOME/weblogic81
JAVA_HOME=$BEA_HOME/jdk141_02
PATH=$PATH:$WL_HOME/server/bin/oci920_8
CLASSPATH=$CLASSPATH:$WL_HOME/server/lib/xerces.jar:$WL_HOME/server/lib
/weblogic.jar
JAVA_OPTIONS="-ms256m -mx1024m"
SERVER_NAME=examplesServer
WLS_USER=weblogic
WLS_PW=weblogic
$JAVA_HOME/bin/java -
Xbootclasspath/a:$JVIEW_HOME/agent/lib/JViewAgent.jar -
XrunJView:server=127.0.0.1,port=4445,agentname=examplesServer
$JAVA_OPTIONS -Dweblogic.Name=$SERVER_NAME
-Dweblogic.management.username=$WLS_USER
-Dweblogic.management.password=$WLS_PW
-Dweblogic.ProductionModeEnabled=$PRODUCTION_MODE
-Djava.security.policy="$WL_HOME/server/lib/weblogic.policy"
weblogic.Server
7.1 Pre-Install
• Determine which Application Servers to install the Agent on. We suggest you
follow the pre-installation steps under the “Preparing for Installation” section
above.
• Ensure that your selected hosts meet the System Requirements (see “System
Requirements” and “Supported Platforms, Application Servers, JDKs, and
Databases” above).
The JView 2004 Agent runs within inside your Application Server's JVM. In order to
do so, you must make available the JView 2004 agent library (both native and Java
library). Once the Agent has been installed correctly, it will automatically run next
time you start up your application’s JVM.
• Install the JView 2004 download onto your Java applic ation’s host.
o You may also simply copy the agent directory from <Your JView 2004
Install Dir>/agent to your Java Application server's file system.
• Edit your JVM's startup shell file’s java startup command:
o Add the location of the <JView>/agent/hpux11 to the SHLIB_PATH, in
addition to the /usr/lib.
• If you are setting the Java system property -Djava.library.path environment, add
the location of the <JView Install Dir>/agent/hpux to the -Djava.library.path
variable.
• Add "-Xbootclasspath/a:<JView Install Dir>/agent/lib/JViewAgent.jar -
XrunJView:server=<IP of Nucleus Server>,port=4445,agentname=<MyAgent>"
directly after the "java" command (Note: replace tags with real data).
##################################################
### JVIEW 2004 EXAMPLE FOR WEBLOGIC 8.X ON HPUX 11
### Please change variables as necessary
##################################################
BEA_HOME=/opt/bea
WL_HOME=$BEA_HOME/weblogic81
JAVA_HOME=$BEA_HOME/jdk141_02
export SHLIB_PATH=$SHLIB_PATH:$WL_HOME/server/bin/oci920_8
CLASSPATH=$CLASSPATH:$WL_HOME/server/lib/xerces.jar:$WL_HOME/server/lib
/weblogic.jar
JAVA_OPTIONS="-ms256m -mx1024m"
SERVER_NAME=examplesServer
WLS_USER=weblogic
WLS_PW=weblogic
$JAVA_HOME/bin/java -
Xbootclasspath/a:$JVIEW_HOME/agent/lib/JViewAgent.jar -
XrunJView:server=127.0.0.1,port=4445,agentname=examplesServer
$JAVA_OPTIONS -Dweblogic.Name=$SERVER_NAME
-Dweblogic.management.username=$WLS_USER
-Dweblogic.management.password=$WLS_PW
-Dweblogic.ProductionModeEnabled=$PRODUCTION_MODE
-Djava.security.policy="$WL_HOME/server/lib/weblogic.policy"
weblogic.Server
8.1 Pre-Install
• Determine which Application Servers to install the Agent on. We suggest you
follow the pre-installation steps under the “Preparing for Installation” section
above.
• Ensure that your selected hosts meet the System Requirements (see “System
Requirements” and “Supported Platforms, Application Servers, JDKs, and
Databases” above).
The JView 2004 Agent runs within inside your Application Server's JVM. In order to
do so, you must make available the JView 2004 agent library (both native and Java
library). Once the Agent has been installed correctly, it will automatically run next
time you start up your application’s JVM.
• Install the JView 2004 download onto your Java application’s host.
o You may also simply copy the agent directory from <Your JView 2004
Install Dir>/agent to your Java Application server's file system.
• Edit your JVM's startup shell file’s java startup command:
o Add the location of the <JView>/agent/aix5 to the LIBPATH.
• Add the "export AIXTHREAD_ENRUSG=ON" in your startServer script.
• If you are setting the Java system property -Djava.library.path environment, add
the location of the <JView Install Dir>/agent/aix to the -Djava.library.path
variable.
• Add "-Xbootclasspath/a:<JView Install Dir>/agent/lib/JViewAgent.jar -
XrunJView:server=<IP of Nucleus Server>,port=4445,agentname=<MyAgent>"
directly after the "java" command (Note: replace tags with real data).
##################################################
### JVIEW 2004 EXAMPLE FOR WEBLOGIC 8.X ON AIX
### Please change variables as necessary
##################################################
BEA_HOME=/opt/bea
WL_HOME=$BEA_HOME/weblogic81
JAVA_HOME=$BEA_HOME/jdk141_02
PATH=$PATH:$WL_HOME/server/bin/oci920_8
CLASSPATH=$CLASSPATH:$WL_HOME/server/lib/xerces.jar:$WL_HOME/server/lib
/weblogic.jar
JAVA_OPTIONS="-ms256m -mx1024m"
SERVER_NAME=examplesServer
WLS_USER=weblogic
WLS_PW=weblogic
$JAVA_HOME/bin/java -
Xbootclasspath/a:$JVIEW_HOME/agent/lib/JViewAgent.jar -
XrunJView:server=127.0.0.1,port=4445,agentname=examplesServer
$JAVA_OPTIONS -Dweblogic.Name=$SERVER_NAME
-Dweblogic.management.username=$WLS_USER
-Dweblogic.management.password=$WLS_PW
-Dweblogic.ProductionModeEnabled=$PRODUCTION_MODE
-Djava.security.policy="$WL_HOME/server/lib/weblogic.policy"
weblogic.Server
9.1 Pre-Install
• Determine which Application Servers to install the Agent on. We suggest you
follow the pre-installation steps under the “Preparing for Installation” section
above.
• Ensure that your selected hosts meet the System Requirements (see “System
Requirements” and “Supported Platforms, Application Servers, JDKs, and
Databases” above).
The JView 2004 Agent runs within inside your Application Server's JVM. In order to
do so, you must make available the JView 2004 agent library (both native and Java
library). Once the Agent has been installed correctly, it will automatically run next
time you start up your application’s JVM.
• Install the JView 2004 download onto your Java application’s host.
o You may also simply copy the agent directory from <Your JView 2004
Install Dir>/agent to your Java Application server's file system.
• Edit your JVM's startup shell file’s java startup command:
o Add the location of the <JView>/agent/tru64 to the LD_LIBRARY_PATH.
• If you are setting the Java system property -Djava.library.path environment, add
the location of the <JView Install Dir>/agent/tru64 to the -Djava.library.path
variable.
• Add "-Xbootclasspath/a:<JView Install Dir>/agent/tru64/Tru64JViewAgent131
(or 141 depending on your VM Version).jar -DJViewParams=server=<IP of
Nucleus Server>,port=4445,agentname=<MyAgent>" directly after the "java"
command (Note: replace tags with real data).
##################################################
### JVIEW 2004 EXAMPLE FOR WEBLOGIC 8.X ON TRU64
### Please change variables as necessary
##################################################
BEA_HOME=/opt/bea
WL_HOME=$BEA_HOME/weblogic81
JAVA_HOME=$BEA_HOME/jdk141_02
PATH=$PATH:$WL_HOME/server/bin/oci920_8
CLASSPATH=$CLASSPATH:$WL_HOME/server/lib/xerces.jar:$WL_HOME/server/lib
/weblogic.jar
JAVA_OPTIONS="-ms256m -mx1024m"
SERVER_NAME=examplesServer
WLS_USER=weblogic
WLS_PW=weblogic
$JAVA_HOME/bin/java -
Xbootclasspath/a:$JVIEW_HOME/agent/tru64/Tru64JViewAgent131.jar -
DJViewParams=server=127.0.0.1,port=4445,agentname=examplesServer
$JAVA_OPTIONS -Dweblogic.Name=$SERVER_NAME
-Dweblogic.management.username=$WLS_USER
-Dweblogic.management.password=$WLS_PW
-Dweblogic.ProductionModeEnabled=$PRODUCTION_MODE
-Djava.security.policy="$WL_HOME/server/lib/weblogic.policy"
weblogic.Server
10 Troubleshooting
If you should run into issues with the installation of any the Agent, please use these
frequently asked questions or contact a DevStream support representative to assist
you.
10.1 Agent
An error occurred during initialization of VM - Could not find -Xrun
library: JView.dll
The JView.dll is not set in your application's startup script's PATH. If you are having
difficulty setting your PATH following the instructions in the Installation Guide, you
can set this at your system level in Windows via your System's Environment
Variables (Under Control Panel - > System -> Advanced). You may need to restart
windows for this setting to take affect.
A. The JView.a is not in your LIBPATH for your application's startup script.
B. JView dependant libraries are not in your LIBPATH. You can determine what
the dependant libraries are by executing "ldd JView.a" in the same directory
of the JView.a file (the <install>/agent/aix5). Ensure that the dependencies
are also added into the LIBPATH in your application's startup script.
A. The JView.sl is not in your SHLIB_PATH for your application's startup script.
B. JView dependant libraries are not in your SHLIB_PATH. You can determine
what the dependant libraries are by executing "ldd JView.sl" in the same
directory of the JView.sl file (the <install>/agent/hpux11). Ensure that the
dependencies are also added into the SHLIB_PATH in your application's
startup script.
Please refer to the Agent Installation Guide for you specific application server.
JView 2004 has built-in cluster capability. You can monitor multiple application
servers with one Nucleus Server, and one Performance Console. During agent
configuration, you can set an Agent Name, which will identify each server uniquely.
The JView 2004 Agent has a very light memory footprint. Applications will typically
experience less than 10 MB of overhead.
How much CPU overhead does the JView 2004 Agent cause?
JView 2004 is the only leading production monitor that displays estima ted overhead.
In production mode, most customers experience < 2% overhead. This overhead
depends on your configuration and instrumentation options, along with your
application's code path. In PerfPoint (Development) mode, most applications will
incur 20-30% overhead, using the out-of-box configuration. (PerfPoint collects
detailed statistics on each of your custom classes.) Instrumentation options can lead
to less/more overhead, depending on configuration.
11 Assistance
11.1 DevStream Customer Support
You may email our support team at support@devstream.com. Customers with
active support contracts may login to the DevStream Customer Center and
search/submit support cases. For Platinum Support customers, you may reach
support at (877) DEV-STREAM ext. 2.
DevStream Corporation
4164 Austin Bluffs Pkwy Ste 230
Colorado Springs, CO 80918
(877) DEV-STREAM (338-7873)
support@devstream.com