8/8/2019 JView 2004 Agent Installation Guide for WebLogic
1/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 1 of 31
JView 2004 Agent InstallationGuide for WebLogic
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
2/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 2 of 31
The information in this document is subject to change without notice. If you find any problems in thedocumentation, please report them to us in writing. DevStream Corporation does not warrant that thisdocumentation is error free. DevStream Corporation could make improvements and/or changes in theproducts described in this documentation at any time without notice.
The customer acknowledges and agrees that (a) the System and all related documentation are confidentialtrade secrets of DevStream Corporation and (b) title to and intellectual property rights in the System andrelated documentation (including without limitation all copyright, trademark, trade secret and patent
rights) are and shall remain the confidential proprietary property and information of DevStreamCorporation.
The customer shall use the system only in accordance with this Agreement. The customer shall notdisclose, copy, or reproduce any portion of the system or documentation in any form to any third personwithout the prior written consent of DevStream Corporation, nor allow third parties to do the same. Thecustomer shall keep the System and all confidential information in the strictest confidence.
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
3/31
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
4/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 4 of 31
9.1 Pre-Install ....................................................................279.2 JView Agent Installation ................................................27
10 Troubleshooting................................................2910.1 Agent .........................................................................29
11 Assistance.........................................................31
11.1 DevStream Customer Support .....................................31
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
5/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 5 of 31
1 Introduction
DevStream delivers J2EE performance tuning solutions, from JView 2004 Enterprise
Edition to professional service consulting for performance tuning.
JView 2004 Enterprise Edition is a comprehensive performance monitoring tooldesigned to help customers quickly detect bottlenecks in their performance of Java
custom code and J2EE-driven applications. JView 2004 helps organizations acceleratetheir debug time, reduce and manage overall costs, and customize their production
performance monitoring as their business needs change over time.
JView uses JavaScape technology (Patent Pending) - a technology which provides a
detailed visual landscape display of J2EE Component-based performance metrics,J2EE component interactions, and analysis of performance short-comings.
1.1JView 2004 Enterprise EditionDevStream's JView 2004 Enterprise Edition is an advanced J2EE productionperformance monitoring and Java Application Performance Management solution.
JView 2004 obtains precise real-time method CPU time and transaction time, JVM
Heap memory usage, as well as SQL metric data in an easy-to-use interface.
JView 2004 is the industry's only Production Ready native code Java PerformanceMonitor, allowing for in-depth Production Java performance monitoring due to its lowoverhead. JView 2004 delivers full spectrum analysis of method metric transaction
time and method CPU time, along with thread stack views and SQL runtime
statistics.
In production mode, JView's low overhead monitoring provides detail on end-to-endtransactions, helping J2EE developers, QA testers, and Administrators quickly
pinpoint and resolve performance issues.
You can benefit from JView 2004 Enterprise Edition in the following ways:
Accelerate solution time. Organizations can more quickly realize areturn on their investment since they do not have to spend time researching
where the performance bottlenecks are. Customers will spend more time
getting the problems fixed instead of using all of their resources to track them
down.
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
6/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 6 of 31
Reduce likelihood of production downtime. The visual landscape andcomponent interaction map can be configured to throw alarms, such as
sending of a page or email, to alert administrators of degraded performance,resource starvation, hung transactions, system response time issues, or theapproach of system transaction capacity.
Meet your SLA's.Companies can feel confident that they can meet theirService Level Agreements by using JView's configurable SLA Monitoring View.
Key Features and Benefits of JView 2004: Real-time monitoring Landscape view of J2EE Components SNMP v2/v3 support for Enterprise Application Monitor Integration Precision Call Trace Analysis Microsecond Precision for demanding applications SLA Monitoring and Automated Operational Awareness Alerts SQL Call statistics CPU Thread time statistics Thread stack analysis and Stalled Thread alerts MReports - Reporting of problematic components PerfPoint - Collect detailed data in Production for problem analysis Easy-to-use Performance Console - Install and begin tuning in minutes. Transaction Exp lorer - Drill down into where your application is spending
Transaction time and CPU
Transaction Scope Review an individual transaction through the server,obtaining stack trace, URL, username, and more
Isolated resource consumption using Method and SQLyzer HotSpot Views Supports J2EE Application Servers as well as stand-alone applications Identify performance issues proactively before they impact users
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
7/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 7 of 31
1.2JView 2004 Documentation1.2.1JView 2004 Installation Guide
TheJView 2004 Installation Guide is intended as a first point of reference wheninstalling the JView Nucleus Server (NS), Agent, and Performance Console. This
guide is intended to be used by system administrators or J2EE developers. Thisdocument will walk you through the following:
Overview of the JView 2004 System Architecture System Requirements Pre-Installation Instructions Installation Instructions for Windows, UNIX (Solaris, HP-UX, AIX and Tru64),
and Linux for each of the JView components
First-Use Application Launch Instructions Upgrade Instructions
1.2.2JView 2004 Agent Installation Guide for
Application Servers
There is a vendor specific JView 2004 Agent Installation Guide for each of the
application servers that are officially supported by DevStreams JView. Each of these
documents is intended to supplement the general JView 2004 Installation Guide forthose customers who wish to run the JView Agent in an Application Server
environment. The document includes the following information:
Overview of the JView 2004 System Architecture System Requirements JView 2004 Agent Installation instructions are available for the following
Application Servers:
o WebLogic 6.x, 7.x, 8.xo WebSphere 5.xo Oracle 9iAS/10iASo Orion Servero JBoss 3.x, 4.xo SunOne 6.x, 7.xo JRun 4.xo Tomcat 3.x, 4.x, 5.xo Caucho Resin 2.x
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
8/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 8 of 31
1.2.3JView 2004 Users Guide
TheJView 2004 Users Guide will assist you in configuring JView to meet your J2EEPerformance Monitoring needs. The guide includes:
Detailed description of Performance Console Views and configuration of each Agent Configuration Options Tuning your Application using JView 2004 Capacity Planning Using JView 2004 JView 2004 MReports SLA Monitoring using JView 2004 Custom Reporting using JView Database schema design and descriptions Configuring Users and Groups
1.3Purpose and ScopeThe purpose of thisAgent Installation Guide for WebLogic is to ensure successful
installation of the JView 2004 Agent for use on a WebLogic Application Server. Thisguide includes detailed instructions for installing the JView 2004 Agent, but will not
cover the Nucleus Server or Performance Console installation. Installation of theJView Agent is detailed for the following operating systems: Windows (all versions),
Solaris, Linux, HP-UX, AIX, and Tru64.
This Agent Installation Guide for WebLogic is intended to be used by systems
administrators and/or developers or support personnel who are familiar with theoverall environment and have access to install software on the WebLogic Application
Server(s) in the environment.
For instructions on Nucleus Server or Performance Console installation, please refer
to theJView 2004 Installation Guide. Please note: the Nucleus Server should be
installed prior to the Agent installation.
1.4Supporting DocumentsAdditional assistance and technical documentation can be found by going to theDevStream online help web pages. http://www.devstream.com/help
For instructions on Nucleus Server or Performance Console installation, please refer
to theJView 2004 Installation Guide. Please note: the Nucleus Server should beinstalled prior to the Agent installation.
DevStream provides additional Agent Installation Guides for the following ApplicationServers: WebLogic, WebSphere, Oracle 9iAS/10iAS and Orion Servers, JBoss,
SunOne, JRun, Tomcat, and Caucho Resin.
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
9/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 9 of 31
1.5Other DevStream ResourcesOther resources you may find helpful include:
Online product demo the online demo provides a walk-through of JViewsfeatures and functionality and can be viewed at any time by going to
http://www.devstream.com/JView2004/demo
JView 2004 Product Brief download the JView 2004 Product Brief toeasily distribute and summarize the benefits and features of JView to the restof your team members.
http://www.devstream.com/JView2004/JView2004Brief.pdf
Release Notes find out whats new in each version by going tohttp://www.devstream.com/JView2004/releasenotes.html
Frequently Asked Questions (FAQs) if you still have questions, trylooking at our online FAQs at http://www.devstream.com/support/FAQ.html
DevStream Support You may email our support team [email protected]. Customers with active support contracts maylogin to the DevStream Customer Center and search/file support cases.
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
10/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 10 of 31
2Overview of InstallationThis document describes the procedures to successfully install the JView 2004 Agent
on a WebLogic Application Server. For detailed instructions on Nucleus Server andPerformance Console installation, please read theJView 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.
2.1JView 2004 Application OverviewThe JView 2004 Java monitoring solution is comprised of 3 components:
JView 2004 J2EE Monitor Agent JView 2004 Nucleus Server (NS) JView 2004 Performance Console
Figure 1: JView 2004 Architecture Diagram
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
11/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 11 of 31
2.1.1JView 2004 AgentThe JView 2004 Agent runs inside your Application Server's JVM, obtainingperformance metrics at low cost using Dynamic Bytecode Instrumentation. The JView
Agent sends this data, in real-time, back to the Nucleus Server, where the data is
stored and distributed to JView 2004 Performance Consoles.
Additionally, the agent obtains hardware CPU and JVM memory data. Unique toJView 2004 is the calculation of the agent's overhead, displayed in the PerformanceConsole, to assist you in instrumentation configuration decisions.
2.1.2JView 2004 Nucleus Server (NS)The JView 2004 Nucleus Server (NS) is the central point for data retrieval andstorage in JView 2004. The NS receives data from JView 2004 Agents and makes this
data available to JView Performance Consoles. The NS also makes analyzed dataavailable to the Operational Alert Server (within the NS), which monitors and reports
on configured Server Level Agreement (SLA) watches.
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 datareports in multiple formats including HTML, XML, and PDF.
2.1.3JView 2004 Performance Console
(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. Itcan also connect directly to the MReports database for reporting capability, as well asopening historical session data.
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
12/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 12 of 31
2.2JView Terms and DefinitionsFor ease of use of the JView application, you are encouraged to review this list ofcommon terms used throughout the JView application and documentation, including
this Installation Guide.
Table 1: GLOSSARY OF COMMON TERMS
Performance Point - Performance Point allows for the on-demand collection of
Method and CPU metric data on all of your classes. This dynamic parameter canallow you to drill-down on a performance issue during production, while allowing you
to turn off the associated overhead during normal monitoring. By turning PerfPoint
on, you are enabling Dev Mode.
Dev Mode - During development testing, PerfPoint DevMode allowscontinuous capture of detailed method stack statistics enabling you to fully
performance profile your Java code.
Prod Mode - In Production Mode, your J2EE components, or End-To-End usertransactions, are monitored, including JSPs, Servlets, Session, Entity, and
Message Driven EJB's, as well as SQL.
PerfPoint - In Production Mode, PerfPoint DevMode allows on-demand detailfor a specific short interval (15-45 seconds) for detailed method stack
statistics enabling you to fully performance profile your Java code. This isuseful when you have a performance issue in production and need to obtain
low-level data.
Nucleus Server The Nucleus Server is the middleware component of JView 2004Enterprise Edition. The JView 2004 Nucleus Server (NS) is the central point for dataretrieval and storage in JView 2004. The NS receives data from JView 2004 Agentsand 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 Bytecodeinstrumentation.
PConsole - The JView 2004 Performance Console (PConsole) is the main delivery
point of JView 2004 data. The JView 2004 PConsole connects directly to the JView2004 NS to obtain method metric and SQL data, along with JVM and cluster node
information. The PConsole contains 7 views, defined below:
JavaScape View - The JavaScape view uses JavaScape - a patent-pending
technology which paints a landscape view of your J2EE environment. Thisview displays component interactions between JSPs, Servlets and
WebServices, Session, Entity, and Message-Driven beans as well as databaseusage.
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
13/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 13 of 31
JLinks - Lines are drawn between components which were executed inthe same thread from a parent method. These J2EE links grow thicker
as throughput is increased between the object component interactions.
JavaScape by Thread View - The JavaScape by Thread view enables you toperform Java Thread analysis and quickly determine how long a particular
request has been active. Additionally, you'll be able to identify the J2EEcomponent thread stack of that thread. This can help debug where long-
running transactions are spending their time.
Transaction Explorer View- The Transaction Explorer view displaysmethod and SQL time calls in tree format. This lets you easily drill-down and
discover the call stack for problematic methods. The tree is organized in
largest consumers, from top to bottom. The tree can be sorted by CPU orTransaction time period.
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 aparticular 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 toexecute Java Performance tuning at ease, as you easily determine whichmethod is consuming your resources.
SQLyzer Hot Spot View - The SQLyzer Hot Spot view lets you quicklypinpoint largest SQL consumers in your application, providing the SQL query
itself, runtime statistics, and whether or not the SQL statement was prepared.
SLA Monitoring View - The SLA Monitoring view displays currently
configured SLA rules. Note that the Nucleus Server, via the Operational AlertServer, is also monitoring your SLA's, and will respond to any SLA violations.
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, TopTen JSPs, Top Ten Servlets, etc.
MReports Database - The MReports database is populated by the Nucleus Server,
for reporting purposes. This database is also used for historical session retrieval.
Operational Awareness Alert - The JView 2004 Nucleus Server runs the
Operational Awareness Alert (OAA) Server, where your custom SLA's are monitoredand 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.
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
14/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 14 of 31
2.3System Requirements2.3.1Agent Requirements
The JView 2004 Agent runs within the monitored application server JVM. As such, thefollowing requirements are for the node on which you will run the monitoredapplication on:
100 MB of memory
5 MB of disk space
2.4Supported Platforms, ApplicationServers, JDKs, and Databases
To guarantee top performance of your JView 2004 Application, please read through
the following list of certified Application Servers, Operating Systems, Databases, andJDK versions. If your environment runs on any of the above that is not yet certified,
please contact DevStream Support to work through any issues you may encounterand to inquire about the product certification schedule.
Table 2: SUPPORTED ENVIRONMENTS
Operating Windows NT 4.0, Windows 2000 Professional, Windows 2000 Server,Systems Windows XP Professional, Windows 2003 Server, Linux x86, Solaris 8
SPARC, Solaris 9 SPARC, HP-UX 11i PA-RISC 2.0, AIX 5, Tru64
Application BEA Weblogic 8.x, 7.x, 6.x,Servers WebSphere 5.x
Sun One Application Server 7.x, 6.x
Oracle 10.x, 9.x iAS (On Sun/IBM JRE)Caucho Resin 2.x
JBoss 4.x, 3.xJRun 4.x
Apache Tomcat 5.x, 4.x, 3.x
Database Oracle 9.x, 8.x (Oracle and Weblogic Oracle jDrivers are supported)Servers DB2 8.x
MS SQL Server 7.0, 2000MySQL 3.x, 4.x
JDK 1.2 Sun 1.2.2_17/_017, Sun 1.2.2_16/_016, Sun 1.2.2_15/_015,Sun 1.2.2_14/_014, Sun 1.2.2_14/_014, Sun 1.2.2_012,
Sun 1.2.2_011, Sun 1.2.2_010, Sun 1.2.2_009, Sun 1.2.2_008,
Sun 1.2.2_007, Sun 1.2.2_006, Sun 1.2.2_005, Sun 1.2.2_004
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
15/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 15 of 31
JDK 1.3 Sun/HP/IBM 1.3.1_08, Sun/HP/IBM 1.3.1_07, Sun/HP/IBM 1.3.1_06,Sun/HP/IBM 1.3.1_05, Sun/HP/IBM 1.3.1_04, Sun/HP/IBM 1.3.1_03,
Sun/HP/IBM 1.3.1_02, Sun/HP/IBM 1.3.1_01a, Sun/HP/IBM 1.3.1_01,
Sun/HP/IBM 1.3.1, Sun 1.3.0_05, Sun 1.3.0_04, Sun 1.3.0_03,
Sun 1.3.0_02, Sun 1.3.0_01, Sun 1.3.0
JDK 1.4 Sun/HP/IBM 1.4.2_01, Sun/HP/IBM 1.4.2, Sun/HP/IBM 1.4.1_05,Sun/HP/IBM 1.4.1_04, Sun/HP/IBM 1.4.1_03, Sun/HP/IBM 1.4.1_02,
Sun/HP/IBM 1.4.1_01, Sun/HP/IBM 1.4.1, Sun/HP/IBM 1.4.0_04,
Sun/HP/IBM 1.4.0_03, Sun/HP/IBM 1.4.0_02, Sun/HP/IBM 1.4.0_01,Sun/HP/IBM 1.4.0, BEA JRockit 1.4.2, BEA JRockit 8.1, BEA JRockit 8.0
MReports Oracle 9.x, 8.x
Databases MySQL 3.x, 4.x
2.5Order of InstallationThe Nucleus Server(s) should be installed first. After the NS has successfully startedup, the JView Agent(s) and Performance Consoles can be installed next in either
order, keeping in mind that you will not be able to connect to or display data in the
PConsole until one or more Agents have been installed to collect the data. For
installation of the Nucleus Server, please refer to theJView 2004 Installation Guide.
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
16/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 16 of 31
3Preparing for InstallationPrior to installing JView 2004 in your environment(s), you will want to take the time
to architect where best to place each of the components. It is important to have to
proper resources allocated to the stand-alone components such as the NucleusServer and MReports database.
3.1Information required before InstallYoull want to setup a separate Nucleus Server and MReports database for eachapplication type that you monitor. This allows reports to be created for specificapplications as well as ensures enough processing power is available for each
applications Nucleus Server.
For each Nucleus Server, youll 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:
1. Determine number of applications to be monitored.2. Determine number of agent licenses per application (that is, the number of
CPUs per host * the number of hosts which serve that application).
Remember JView 2004 agent licenses are by host, not by JVM.
3. Determine how many and where to place the Nucleus servers. For eachapplication, youll likely desire a single Nucleus Server. If you have greaterthen 8 hosts for a specific application, you may want to consider multiple
Nucleus Servers.
4. Determine where to place the MReports database. An MReports databaseschema is unique to a single Nucleus Server. 2 Nucleus servers must store
data in 2 separate MReports schemas.5. SNMP Port Number identify if there are any running SNMP Agents on the
host where the Nucleus Server(s) will run. If so, determine how you will
resolve the default port conflict of 161 (you can edit this in the NucleusServer configuration, or change the conflicting agents port).
6. SNMP Trap information you should determine where (if at all) SNMP trapswill be send for SLA Violations.
7. SMTP Configuration identify which SMTP server you will route your JViewOperational Awareness Alerts (for SLA Violation notifications). Identify if this
SMTP server requires authentication.
3.2Upgrading from Previous VersionsIf you are upgrading from a previous version of JView 2004, you can install directlyover the existing installation and your configuration files will be preserved. You will
need to recreate the MReports database, as the schema will have changed. Simply
run the MReports installation as normal (it will drop existing tables and recreatethem).
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
17/31
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
18/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 18 of 31
Example Windows Bat File for Weblogic 8.x
##################################################
### 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
REM ######## START JVIEW 2004 ADDITION #######
set JVIEW_HOME=C:\jview2004_2.1set PATH=%JVIEW_HOME%\agent\windows;%PATH%
REM ######## END JVIEW 2004 ADDITION #######
"%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/8/2019 JView 2004 Agent Installation Guide for WebLogic
19/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 19 of 31
5Agent Installation Instructionsfor Solaris
In order to install JView 2004 you need to register and download the latest JView
installation executable from www.devstream.com/downloads. For any componentsto be installed on a UNIX Solaris server, please follow these steps:
5.1Pre-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 SystemRequirements and Supported Platforms, Application Servers, JDKs, andDatabases above).
5.2JView Agent InstallationNOTE: This JView 2004 Agent Installation Guide for WebLogicprovides
instructions for installing the JView 2004 Agent on WebLogic Application Server only.
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 nexttime you start up your applications JVM.
To install the JView 2004 Agent on WebLogic applications:
Install the JView 2004 download onto your Java applications host.o You may also simply copy the agent directory from /agent to your Java Application server's file system.
Edit your JVM's startup shell files java startup command:o Add the location of the /agent/solaris to the LD_LIBRARY_PATH.
If you are setting the Java system property -Djava.library.path environment, addthe locat ion of the /agent/solaris to the -Djava.library.path
variable. Add "-Xbootclasspath/a:/agent/lib/JViewAgent.jar -
XrunJView:server=,port=4445,agentname="directly after the "java" command (Note: replace tags with real data).
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
20/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 20 of 31
Example Solaris Shell File for Weblogic 8.x
##################################################
### 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_8CLASSPATH=$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
######## START JVIEW ADDITION #######
JVIEW_HOME=/opt/jview2004
export LD_LIBRARY_PATH=$JVIEW_HOME/agent/solaris:$LD_LIBRARY_PATH
######## END JVIEW ADDITION #######
$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/8/2019 JView 2004 Agent Installation Guide for WebLogic
21/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 21 of 31
6Agent Installation Instructionsfor Linux
In order to install JView 2004 you need to register and download the latest JView
installation executable from www.devstream.com/downloads. For any components
to be installed on a Linux server, please follow these steps:
6.1Pre-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 SystemRequirements and Supported Platforms, Application Servers, JDKs, andDatabases above).
6.2JView Agent InstallationNOTE: This JView 2004 Agent Installation Guide for WebLogicprovides
instructions for installing the JView 2004 Agent on WebLogic Application Server only.
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 Javalibrary). Once the Agent has been installed correctly, it will automatically run nexttime you start up your applications JVM.
To install the JView 2004 Agent on WebLogic applications:
Install the JView 2004 download onto your Java applications host.o You may also simply copy the agent directory from /agent to your Java Application server's file system.
Edit your JVM's startup shell files java startup command:o Add the location of the /agent/linux to the LD_LIBRARY_PATH.
If you are setting the Java system property -Djava.library.path environment, addthe location of the /agent/linux to the -Djava.library.pathvariable.
Add "-Xbootclasspath/a:/agent/lib/JViewAgent.jar -XrunJView:server=,port=4445,agentname="directly after the "java" command (Note: replace tags with real data).
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
22/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 22 of 31
Example Linux Shell File for Weblogic 8.x
##################################################
### 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_8CLASSPATH=$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
######## START JVIEW ADDITION #######
JVIEW_HOME=/opt/jview2004
export LD_LIBRARY_PATH=$JVIEW_HOME/agent/linux:$PATH
######## END JVIEW ADDITION #######
$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/8/2019 JView 2004 Agent Installation Guide for WebLogic
23/31
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
24/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 24 of 31
Example HP-UX Shell File for Weblogic 8.x
##################################################
### 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
######## START JVIEW ADDITION #######
JVIEW_HOME=/opt/jview2004SHLIB_PATH=$JVIEW_HOME/agent/hpux11:/usr/lib:$SHLIB_PATH######## END JVIEW ADDITION #######
$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/8/2019 JView 2004 Agent Installation Guide for WebLogic
25/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 25 of 31
8Agent Installation Instructionsfor AIX
In order to install JView 2004 you need to register and download the latest JView
installation executable from www.devstream.com/downloads. For any components
to be installed on a UNIX AIX server, please follow these steps:
8.1Pre-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 SystemRequirements and Supported Platforms, Application Servers, JDKs, andDatabases above).
8.2JView Agent InstallationNOTE: This JView 2004 Agent Installation Guide for WebLogicprovides
instructions for installing the JView 2004 Agent on WebLogic Application Server only.
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 nexttime you start up your applications JVM.
To install the JView 2004 Agent on WebLogic applications:
Install the JView 2004 download onto your Java applications host.o You may also simply copy the agent directory from /agent to your Java Application server's file system.
Edit your JVM's startup shell files java startup command:o Add the location of the /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 /agent/aix to the -Djava.library.path
variable.
Add "-Xbootclasspath/a:/agent/lib/JViewAgent.jar -XrunJView:server=,port=4445,agentname="directly after the "java" command (Note: replace tags with real data).
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
26/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 26 of 31
Example AIX Shell File for Weblogic 8.x
##################################################
### 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=examplesServerWLS_USER=weblogic
WLS_PW=weblogic
######## START JVIEW ADDITION #######
JVIEW_HOME=/opt/jview2004
export LIBPATH=$JVIEW_HOME/agent/aix5:$LIBPATHexport AIXTHREAD_ENRUSG=ON
######## END JVIEW ADDITION #######
$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/8/2019 JView 2004 Agent Installation Guide for WebLogic
27/31
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
28/31
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
29/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 29 of 31
10TroubleshootingIf you should run into issues with the installation of any the Agent, please use thesefrequently asked questions or contact a DevStream support representative to assist
you.
10.1AgentAn error occurred during initialization of VM - Could not find -Xrunlibrary: JView.dll
The JView.dll is not set in your application's startup script's PATH. If you are havingdifficulty 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.
I am receiving message: "java.lang.NoClassDefFoundError:com/dstream/jview/MethodTimer"
Check the "-Xbootclasspath/a:$JVIEW_PATH/agent/lib/JViewAgent.jar" option (or
%JVIEW_PATH% for windows). The JViewAgent.jar path needs to be in the
bootclasspath (otherwise you will receive the "java.lang.NoClassDefFoundError"error).
Could not find -Xrun library: JView.so (Linux/Solaris)
There are two possibilities for why this error appears:
A. The JView.so is not in your LD_LIBRARY_PATH for your application's startupscript.
B. JView dependant libraries are not in your LD_LIBRARY_PATH. You candetermine what the dependant libraries are by executing "ldd JView.so" in thesame directory of the JView.so file (the /agent/your_os). Ensure that
the dependencies are also added into the LD_LIBRARY_PATH in your
application's startup script.
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
30/31
JView 2004 Agent Installation for WebLogic
Copyright 2004 - DevStream Corporation Page 30 of 31
Could not find -Xrun library: JView.a (AIX)
There are two possibilities for why this error appears:
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 directoryof the JView.a file (the /agent/aix5). Ensure that the dependencies
are also added into the LIBPATH in your application's startup script.
Could not find -Xrun library: JView.sl (HP-UX)
There are two possibilities for why this error appears:
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 /agent/hpux11). Ensure that thedependencies are also added into the SHLIB_PATH in your application's
startup script.
How do I configure my application server to run with JView 2004?
Please refer to theAgent Installation Guide for you specific application server.
Can I run multiple application servers using JView 2004?
JView 2004 has built-in cluster capability. You can monitor multiple applicationservers with one Nucleus Server, and one Performance Console. During agent
configuration, you can set an Agent Name, which will identify each server uniquely.
How much memory does the JView 2004 Agent require?
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 estimated overhead.
In production mode, most customers experience < 2% overhead. This overheaddepends on your configuration and instrumentation options, along with your
application's code path. In PerfPoint (Development) mode, most applications willincur 20-30% overhead, using the out-of-box configuration. (PerfPoint collects
detailed statistics on each of your custom classes.) Instrumentation options can leadto less/more overhead, depending on configuration.
8/8/2019 JView 2004 Agent Installation Guide for WebLogic
31/31
JView 2004 Agent Installation for WebLogic
11Assistance11.1DevStream Customer SupportYou may email our support team at [email protected]. Customers withactive support contracts may login to the DevStream Customer Center andsearch/submit support cases. For Platinum Support customers, you may reach
support at (877) DEV-STREAM ext. 2.
DevStream Corporation
4164 Austin Bluffs Pkwy Ste 230Colorado Springs, CO 80918(877) DEV-STREAM (338-7873)