These release notes contain important information concerning the Version 6.5 release of the iPlanet(TM) Application Server Enterprise Connector for Tuxedo. New features and enhancements, installation notes, known problems, and other late-breaking issues are addressed here. Read this document and associated documents before you begin using iPlanet Application Server Enterprise Connector for Tuxedo.
This document contains the following sections:
There are no new features in the iPlanet Application Server Enterprise Connector for Tuxedo, version 6.5
Be sure and read the important information concerning Post-Installation Issues.
Note
The following iPlanet Application Server EPE 6.5 products have been certified to run on versions 6.5 and 6.5 SP1.
The iPlanet Application Server Enterprise Connector for Tuxedo supports the following platforms:
All Sun Microsystems product documentation can be found at the following site:
This section contains the following:
In addition to these release notes, the Enterprise Connector for Tuxedo 6.5 product includes an entire set of documentation. This section contains a brief synopsis of each document.
References to specific pieces of documents are provided within the Enterprise Connector for Tuxedo 6.5 documentation.
This section deals with the requirements for both Application Server platforms: Solaris and Windows.
Software and hardware requirements are grouped to whether they apply to both Windows and Solaris systems or are specific to one of the systems.
All patches are located on the iPlanet Application Server, Enterprise Pro Edition 6.5 CD or in the download. For more information see the section "Required Patches" in the iPlanet Process Manager, 6.5 Release Notes:
http://docs.sun.com/source/816-6356-10/index.html.
The following software must be installed before you can install the Enterprise Enterprise Connector for Tuxedo 6.5:
iPlanet Application Server Enterprise Pro Edition 6.5 requires the Maintenance Update 2 (MU2) patch. The patch is not required when you install the 6.5 SP1 version.
iPlanet Application Server Enterprise Pro Edition 6.5 requires the JDK 1.3.1_04 patch. The patch is not required when install the 6.5 SP1 version.
The iPlanet Application Server Enterprise Connector for Tuxedo, Version 6.5 must be installed on the same machine as iPlanet Application Server EPE.
There are two mandatory post-installation issues that you must address:
Tuxedo version 7.1 supports multi-threaded server processes. The iPlanet Application Server Enterprise Connector for Tuxedo supports this new feature added to Tuxedo.
When the iPlanet Application Server Enterprise Connector for Tuxedo is used to access multi-threaded Tuxedo applications, the connection pool parameter: MaxPoolSize needs to be customized. The MaxPoolSize value should be set to the number of users that can run concurrently times 50.
The number of users is specified in Lic.txt file that resides in <TuxedoInstallation>/udataobj.
ProblemThe change in the JVM default arguments on iPlanet Application Server, Enterprise Pro Edition, versions 6.5 and 6.5 SP1, causes the Enterprise Connector for Tuxedo 6.5 to have high memory consumption on Solaris\NT\Windows2000 platforms.
The default JVM arguments on iPlanet Application Server, Enterprise Pro Edition, versions 6.5 and 6.5 SP1, are as follows:
-server -Xss512k -Xms128m -Xmx1024m -XX:NewSize=42m -XX:MaxNewSize=342m
-XX:+DisableExplicitGC -Xconcurrentio
Refer to http://java.sun.com/docs/hotspot/VMOptions.html for details on VM parameters.
SolutionThe workaround to resolve the high memory consumption is to set flags to force the garbage collector to clean up the memory as described in the following section:
On Solaris modify the iasenv script to change the flags.
The file, iasenv.ksh, is in the following directory: <ias_inst_dir>/ias/env
GX_ARGS : JAVA_GX_ARGS="-DGX.cleaner.enabled=yes
JAVA_ARGS : Enable Explicit GC
JAVA_ARGS : Reset the Max Heap Size from 1024 MB to 512 MB
On Windows use kregedit to modify the iPlanet Application Server EPE registry to change the flags.
Modify JavaArgs by appending -XX:+DisableExplicitGC=no to existing JavaArgs
Figure 1 shows the iPlanet Application Server EPE tree structure.
The memory flag settings are explained in more detail in the iPlanet Application Server EPE 6.5 release note at the following URL:
http://docs.sun.com/source/816-6373-10/index.html
in section: Compatibility with Previous Releases/Memory Settings.
In order to upgrade the iPlanet Application Server Enterprise Connector for Tuxedo for version 6.0 SPx, you must also upgrade the iPlanet Application Server EPE 6.0 SPx to version 6.5 or 6.5 SP1 and the Unified Integrated Framework from SPx to Version 6.5.
You need to deploy all the applications to the Application Server. Refer to the iPlanet Application Server EPE documentation for instructions on how to migrate the applications.
Table 1 lists the issues resolved in iPlanet Application Server Enterprise Connector for Tuxedo.
.
Table 2 describes known problems and associated solutions for the iPlanet Application Server Enterprise Connector for Tuxedo.
Known Problems and Limitations
If you have problems with iPlanet Application Server Enterprise Connector for Tuxedo Version 6.5, contact Sun customer support using one of the following mechanisms:
So that we can best assist you in resolving problems, please have the following information available when you contact support:
This document has changed since the initial iPlanet Application Server Enterprise Connector for Tuxedo 6.5 release.
Table 3 shows the revision history for this document, and lists the affected sections.
Useful Sun ONE information can be found at the following Internet locations:
Useful Sun ONE information can be found at the following Internet locations:
Note
Upgrade from iPlanet Application Server Enterprise Connector for Tuxedo 6.0 SPx to Version 6.5
To Upgrade the iPlanet Application Server Enterprise Connector for Tuxedo from Version 6.0 SPx to Version 6.5.
Migrating the Applications
Resolved Issues
Known Problems and Limitations
How to Report Problems
Documentation Revision
For More Information
Use of iPlanet Application Server Enterprise Connector for Tuxedo is subject to the terms described in the license agreement accompanying it.
Copyright © 2002 Sun Microsystems, Inc. All rights reserved.
Last Updated December 04, 2002