AD4J EM 10.2.0.5 Upgrade

There is an issue with this AD4J. This version will cater to JDK1.5_somebuild. It does not support JDK JVM later than 1.5. Hence need an upgrade to the current one.

The upgrade is simple. Following are the steps to follow:

Oracle Enterprise Manager 10g Release 4 Grid Control (10.2.0.4)
- Application Diagnostics for Java (AD4J) Version 4


Table of Contents
-----------------
Introduction
Documentation & Downloads
What is new in version 4?
Install and Upgrade Notes
Complete List of Supported JVMs, Platforms and Application Servers
Known Issues

Introduction
------------

This document contains the Release Notes for Oracle Enterprise Manager 10g
Release 4 Grid Control (10.2.0.4) - Application Diagnostics for Java Version 4
released in March 2009.

Documentation & Downloads
-------------------------
You can access the latest documentation and product downloads for Oracle AD4J
from Oracle Technology Network (OTN) available online at:
http://www.oracle.com/technology/software/products/oem/htdocs/jade.html

What is new in version 4?
-------------------------

This version adds some new features and it's agents add support for several
new platforms.

New Console Features:
=====================
- Admin can define action URLs to be invoked when a threashold is exceeded
- Admin can setup rules to mark threads as idle (Setup->Monitoring)
- Cross tier correlation has been enhanced to follow RMI protocol (Eg: For
EJBs)
- Console is able to install AD4J support patches

New Database Agent:
===================
- Support for monitoring Oracle Databases on Solaris x86
- Support for RAC databases using Virtual IPs for HA/failover

New Java Agent Features:
========================
- The Java agent now supports the JRockit JVM on 32 bit Linux x86 along with
some other new JVMs as listed below:

New JVMs being supported:
=========================

Linux x86 32 bit
----------------
Sun Microsystems Inc. 1.4.2_19
Sun Microsystems Inc. 1.5.0_17
Sun Microsystems Inc. 1.6.0_10
Sun Microsystems Inc. 1.6.0_11

IBM Corporation 1.5.0_2

BEA Systems, Inc. 1.4.2_14 (R27)
BEA Systems, Inc. 1.4.2_15 (R27)
BEA Systems, Inc. 1.4.2_16 (R27)
BEA Systems, Inc. 1.4.2_17 (R27)
BEA Systems, Inc. 1.4.2_19 (R27)
BEA Systems, Inc. 1.5.0_12 (R27)
BEA Systems, Inc. 1.5.0_14 (R28)
BEA Systems, Inc. 1.5.0_15 (R27)
BEA Systems, Inc. 1.6.0_01 (R27)
BEA Systems, Inc. 1.6.0_02 (R27)
BEA Systems, Inc. 1.6.0_03 (R28)
BEA Systems, Inc. 1.6.0_05 (R27)
BEA Systems, Inc. 1.6.0_11 (R27)

Linux x86 64 bit
----------------
Sun Microsystems Inc. 1.5.0_13
Sun Microsystems Inc. 1.5.0_16
Sun Microsystems Inc. 1.5.0_17

Windows 32 bit
--------------
Sun Microsystems Inc. 1.6.0_10
Sun Microsystems Inc. 1.6.0_11

Solaris SPARC 32 bit
--------------------
Sun Microsystems Inc. 1.4.2_19
Sun Microsystems Inc. 1.5.0_17
Sun Microsystems Inc. 1.6.0_10
Sun Microsystems Inc. 1.6.0_11

Solaris SPARC 64 bit
--------------------
Sun Microsystems Inc. 1.4.2_12
Sun Microsystems Inc. 1.4.2_13
Sun Microsystems Inc. 1.5.0_06
Sun Microsystems Inc. 1.5.0_09
Sun Microsystems Inc. 1.5.0_11
Sun Microsystems Inc. 1.5.0_12
Sun Microsystems Inc. 1.5.0_13

HP Itanium 32 bit:
------------------
Hewlett-Packard Co. 1.4.2.19

HP Itanium 64 bit
-----------------
Hewlett-Packard Co. 1.4.2.14
Hewlett-Packard Co. 1.4.2.15
Hewlett-Packard Co. 1.4.2.16
Hewlett-Packard Co. 1.5.0.14

HP PA-RISC 32 bit
-----------------
Hewlett-Packard Co. 1.4.2.19
Hewlett-Packard Co. 1.4.2.20
Hewlett-Packard Co. 1.5.0.09
Hewlett-Packard Co. 1.5.0.14

IBM AIX Power 32 bit
--------------------
IBM Corporation 1.4.2_4
IBM Corporation 1.5.0_SR2
IBM Corporation 1.5.0_SR5
IBM Corporation 1.5.0_SR7
IBM Corporation 1.5.0_SR8


Bug fixes
============================================================
8250583 - IAS on Solaris 64 bit - may observe segv in getting the jsp data.
7712841 - DB -> correlation broken except when providing exact db host name/ip.
7722019 - JAVA/DB X-TIER FAILS ON AIX32 FOR IPV6 PROTOCOL
7551623 - DB X-TIER FUNCTIONALITY MAY NOT WORK ON AIX AND WINDOWS
7607855 - THREAD SUMMARY DETAIL: OS PID IS WRONG
7629000 - AGENT MEMORY CONSUMPTION SHOULD BE IMPROVED
7415165 - HISTORICAL DATA IS MISSING FEW STACK TRACES WHEN NO FILTER IS APPLIED
8227595 - WARN USERS ABOUT HIGH MONITORING FREQUENCY
7352432 - UNABLE TO CHANGE PASSWORD FOR USERS. RESULTS IN ERROR.
8220782 - Console redirects to appropriate page after login
8262190 - SOME HELP PAGES OF AD4J CONSOLE ARE MISSING
8258884 - TRACE ACTIVE/ALL THREADS IS NOT DISPLAYING THREAD(S) INFO (IBM JAVA
1.5 on Linux x86)
8258857 - WEBSPHERE PORT IS NOT SHOWN ON CONSOLE (IBM JAVA 1.5 on Linux x86)
7701943 - AGENT THROWS UNHANDLED EXCEPTION ON WLS WHEN RUNNING WITH ADF
7632412 - JAMAGENT CRASHES DUE TO HUGE STACK LOCAL
7531829 - PURIFY ERROR IN DBAGENT

Known Issues
============
* This version requires DB schema upgrade which is performed automatically
* The IBM JDK 1.5 agent may intermittently miss collecting "request names"
when the garbage collector is extremely busy.


Released Files
--------------
Oracle AD4J Console can be installed on these three 32 bit platforms only:

Linux - lnx/jamserv-lnx-b3441.zip
Solaris - sun/jamserv-sun-b3441.zip
Windows - win/jamserv-win-b3441.msi

Each console bundle contains the agents for all supported platforms.

The win/upgrade-b3441.zip file is needed for upgrading Windows consoles.

To install the product, please follow the instructions available at
http://download.oracle.com/docs/cd/B16240_01/doc/install.102/e11085/toc.htm

Install and Upgrade Notes
-------------------------

Oracle AD4J Installation and configuration documents are available at the
following locations on OTN:

* Oracle AD4J Installation Guide
http://download.oracle.com/docs/cd/B16240_01/doc/install.102/e11085/toc.htm

* Oracle AD4J Administration and Reference Guide
http://download.oracle.com/docs/cd/B16240_01/doc/admin.102/e11084/toc.htm

AD4J supports manual upgrade from version 3 to version 4. It does not support
automatic upgrade of the previous installations.

Follow these steps to manually upgrade if you have a previous installation of
Oracle AD4J

Manual upgrade of AD4J Console:
1. Stop monitoring (if it is running)
2. Undeploy the AD4J Java agents on the monitored app servers
3. Undeploy the AD4J Database agents on the monitored databases
4. Shutdown the console
5. Delete all files in the /cache directory
6. Make a backup of your current jamserv directory
7. On Linux or Solaris, unzip the appropriate zip file into the /tmp directory
and replace your existing jamserv/jam directory with /tmp/jamserv/jam
On Windows unzip win\upgrade.zip to the jamserv directory
8. Restart the console
9. Login to the console
10. Upgrade the repository schema if you are prompted to do so
11. Navigate to "Setup" and then to the "Download Agent" page & rebuild the wars
12. Download the Java agent and deploy it to the monitored app servers using
same procedure you used previously
13. Download the Database agent and deploy it to the monitored app servers using
same procedure you used previously
14. Restart monitoring (if it was previously running)

Complete List of Supported JVMs, Platforms and Application Servers
==================================================================

1) AD4J console is supported on:
Windows (2000 or later)
Linux x86 (RHEL 3 or later)
Solaris SPARC (8 or later)

2) AD4J Database agent supports Oracle 8i or later on the following platforms:
Linux x86 and IA64
Solaris SPARC and x86
AIX PowerPC
HPUX 11 on PA-RISC and IA64

3) AD4J Java agents supports the following JVM on their respective platforms:

Linux x86 32 bit:
-----------------
BEA Systems, Inc. 1.4.2_14 (R27)
BEA Systems, Inc. 1.4.2_15 (R27)
BEA Systems, Inc. 1.4.2_16 (R27)
BEA Systems, Inc. 1.4.2_17 (R27)
BEA Systems, Inc. 1.4.2_19 (R27)
BEA Systems, Inc. 1.5.0_12 (R27)
BEA Systems, Inc. 1.5.0_14 (R28)
BEA Systems, Inc. 1.5.0_15 (R27)
BEA Systems, Inc. 1.6.0_01 (R27)
BEA Systems, Inc. 1.6.0_02 (R27)
BEA Systems, Inc. 1.6.0_03 (R28)
BEA Systems, Inc. 1.6.0_05 (R27)
BEA Systems, Inc. 1.6.0_11 (R27)
IBM Corporation 1.4.2_1
IBM Corporation 1.4.2_10
IBM Corporation 1.4.2_6P3
IBM Corporation 1.4.2_SR0
IBM Corporation 1.4.2_SR5
IBM Corporation 1.4.2_SR6
IBM Corporation 1.4.2_SR7
IBM Corporation 1.4.2_SR8
IBM Corporation 1.4.2_SR9
IBM Corporation 1.5.0
IBM Corporation 1.5.0_2
IBM Corporation 1.5.0_5
Sun Microsystems Inc. 1.3.1_00 - 1.3.1_20
Sun Microsystems Inc. 1.4.2_00 - 1.4.2_19
Sun Microsystems Inc. 1.5.0_00 - 1.5.0_17
Sun Microsystems Inc. 1.6.0_0
Sun Microsystems Inc. 1.6.0_02
Sun Microsystems Inc. 1.6.0_04
Sun Microsystems Inc. 1.6.0_05
Sun Microsystems Inc. 1.6.0_06
Sun Microsystems Inc. 1.6.0_07
Sun Microsystems Inc. 1.6.0_10
Sun Microsystems Inc. 1.6.0_11

Linux x86 64 bit:
-----------------
Sun Microsystems Inc. 1.5.0_07
Sun Microsystems Inc. 1.5.0_08
Sun Microsystems Inc. 1.5.0_10
Sun Microsystems Inc. 1.5.0_11
Sun Microsystems Inc. 1.5.0_12
Sun Microsystems Inc. 1.5.0_13
Sun Microsystems Inc. 1.5.0_14
Sun Microsystems Inc. 1.5.0_15
Sun Microsystems Inc. 1.5.0_16
Sun Microsystems Inc. 1.5.0_17

SPARC Solaris 32 bit (SunOS Version 8, 9, 10):
----------------------------------------------
Sun Microsystems Inc. 1.3.1_00 - 1.3.1_20
Sun Microsystems Inc. 1.4.2_00 - 1.4.2_19
Sun Microsystems Inc. 1.5.0_00 - 1.5.0_17
Sun Microsystems Inc. 1.6.0_0
Sun Microsystems Inc. 1.6.0_04
Sun Microsystems Inc. 1.6.0_05
Sun Microsystems Inc. 1.6.0_06
Sun Microsystems Inc. 1.6.0_07
Sun Microsystems Inc. 1.6.0_10
Sun Microsystems Inc. 1.6.0_11

SPARC Solaris 64 bit (SunOS Version 8, 9, 10):
----------------------------------------------
Sun Microsystems Inc. 1.4.2_06
Sun Microsystems Inc. 1.4.2_07
Sun Microsystems Inc. 1.4.2_12
Sun Microsystems Inc. 1.4.2_13
Sun Microsystems Inc. 1.5.0_06
Sun Microsystems Inc. 1.5.0_08
Sun Microsystems Inc. 1.5.0_09
Sun Microsystems Inc. 1.5.0_10
Sun Microsystems Inc. 1.5.0_11
Sun Microsystems Inc. 1.5.0_12
Sun Microsystems Inc. 1.5.0_13
Sun Microsystems Inc. 1.5.0_14
Sun Microsystems Inc. 1.5.0_15

Windows 32 bit (2000, 2003 Server & XP):
----------------------------------------
Sun Microsystems Inc. 1.4.2_0 - 1.4.2_18
Sun Microsystems Inc. 1.5.0_0 - 1.5.0_16
Sun Microsystems Inc. 1.6.0_0
Sun Microsystems Inc. 1.6.0_01
Sun Microsystems Inc. 1.6.0_02
Sun Microsystems Inc. 1.6.0_03
Sun Microsystems Inc. 1.6.0_04
Sun Microsystems Inc. 1.6.0_05
Sun Microsystems Inc. 1.6.0_06
Sun Microsystems Inc. 1.6.0_07
Sun Microsystems Inc. 1.6.0_10
Sun Microsystems Inc. 1.6.0_11

HP-UX Itanium 32 bit:
---------------------
Hewlett-Packard Co. 1.4.2.19

HP-UX Itanium 64 bit:
---------------------
Hewlett-Packard Co. 1.4.2.07
Hewlett-Packard Co. 1.4.2.11
Hewlett-Packard Co. 1.4.2.12
Hewlett-Packard Co. 1.4.2.13
Hewlett-Packard Co. 1.4.2.14
Hewlett-Packard Co. 1.4.2.15
Hewlett-Packard Co. 1.4.2.16
Hewlett-Packard Co. 1.4.2.17
Hewlett-Packard Co. 1.5.0.14

HP-UX PA-RISC 32 bit:
---------------------
Hewlett-Packard Co. 1.3.1_07
Hewlett-Packard Co. 1.3.1_09
Hewlett-Packard Co. 1.3.1_19
Hewlett-Packard Co. 1.4.2_04
Hewlett-Packard Co. 1.4.2_05
Hewlett-Packard Co. 1.4.2_06
Hewlett-Packard Co. 1.4.2.15
Hewlett-Packard Co. 1.4.2.17
Hewlett-Packard Co. 1.4.2.18
Hewlett-Packard Co. 1.4.2.19
Hewlett-Packard Co. 1.4.2.20
Hewlett-Packard Co. 1.5.0.03
Hewlett-Packard Co. 1.5.0.05
Hewlett-Packard Co. 1.5.0.06
Hewlett-Packard Co. 1.5.0.09
Hewlett-Packard Co. 1.5.0.10
Hewlett-Packard Co. 1.5.0.11
Hewlett-Packard Co. 1.5.0.12
Hewlett-Packard Co. 1.5.0.14

IBM-AIX 32 bit:
---------------
IBM Corporation 1.3.1_07
IBM Corporation 1.3.1_08
IBM Corporation 1.4.2_0
IBM Corporation 1.4.2_2
IBM Corporation 1.4.2_6
IBM Corporation 1.4.2_7
IBM Corporation 1.4.2_8
IBM Corporation 1.4.2_8 (IFIX 120916 : 142_SR8 + 119825)
IBM Corporation 1.4.2_9
IBM Corporation 1.4.2_10
IBM Corporation 1.4.2_11
IBM Corporation 1.5.0_SR2
IBM Corporation 1.5.0_SR5
IBM Corporation 1.5.0_SR7
IBM Corporation 1.5.0_SR8


Oracle AD4J can monitor Java applications running on any app server as well as
standalone Java applications. Detection of request names and listener ports is
specifically supported on the following Application Servers:

- Oracle Application Server (OC4J)
- Oracle WebLogic Server
- IBM WebSphere
- SAP NetWeaver
- Apache Tomcat
- Apache Jserv
- RedHat JBoss