WebSphere Application Server Network Deployment, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Migrating Version 5 Application Profiles to Version 6

Why and when to perform this task

The WebSphere Application Server Version 6 application profiling function works under the unit of work concept. This gives it a more predictable data access pattern based on the active unit of work, which could be either a transaction or an ActivitySession.

In order to support Java 2 platform, Enterprise Edition (J2EE) 1.3 applications with an application profile configuration from WebSphere Application Server Version 5.x , the Application Profile service on a Version 6 server must enable the Application Profiling 5.x Compatibility Mode as the default. The 5.x compatibility mode has a fair amount of performance overhead on a Version 6 server. Because of this, if there is no J2EE 1.3 application with an application profile V5.x configuration installed, the server does not load the support for the 5.x compatibility mode during startup, even when the 5.x compatibility mode is turned on.

After the server starts without loading the 5.x compatibility mode support, if a J2EE 1.3 application with an application profile V5.x configuration installs on the server and attempts to start, the following message is displayed, and the server must be restarted:
ACIN0031E: The J2EE 1.3 application <ApplicationName> is configured for application 
profiling and is installed and starting on a running server that enables Application Profiling
 5.x Compatibility Mode. You must re-start the server.
This situation only happens when:
  1. the server started with the Application Profile service enabled and 5.x compatibility mode turned on
  2. you try to install and start a J2EE 1.3 application with an application profile configured in Version 5.x.
To avoid this situation, you must install at least one J2EE 1.3 application with an application profile Version 5.x configuration before starting the server.

Ideally, you would upgrade your J2EE 1.3 applications to use the Version 6 application profiling configuration and turn off the Application Profiling 5.x Compatibility Mode through the administrative console.

Therefore it is recommended that you migrate any application you might have configured with application profiling in Version 5. Application profiles migration only requires you to re-configure your applications in the Version 6 Application Server Toolkit (AST). See Application profiling: Overview and Automatic configuration of application profiling for more information.




Related concepts
Application profiling: Overview
Automatic configuration of application profiling

Related tasks
Using the TaskNameManager interface

Task topic    

Terms of Use | Feedback

Last updated: Mar 17, 2005 4:28:29 AM CST
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/appprofile/tasks/tapp_appmig526.html

© Copyright IBM Corporation 2002, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)