Release Notes for iPlanet^(TM) Application Server Enterprise Connector for Tuxedo, Version 6.5

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:

• What's New in the iPlanet Application Server Enterprise Connector for Tuxedo

• Product Certification of Enterprise Connector for Tuxedo 6.5 on iPlanet Application Server EPE 6.5 and 6.5 SP1

• Documentation

• Software and Hardware Requirements

• Installation Notes

• Upgrade from iPlanet Application Server Enterprise Connector for Tuxedo 6.0 SPx to Version 6.5

• Resolved Issues

• Known Problems and Limitations

• How to Report Problems

• Documentation Revision

• For More Information

What's New in the iPlanet Application Server Enterprise Connector for Tuxedo

---

There are no new features in the iPlanet Application Server Enterprise Connector for Tuxedo, version 6.5

Product Certification of Enterprise Connector for Tuxedo 6.5 on iPlanet Application Server EPE 6.5 and 6.5 SP1

---

The following iPlanet Application Server EPE 6.5 products have been certified to run on versions 6.5 and 6.5 SP1.

• Unified Integration Framework 6.5

• iPlanet Application Server Enterprise Connector for Tuxedo 6.5

Platform Summary

---

The iPlanet Application Server Enterprise Connector for Tuxedo supports the following platforms:

• Microsoft Windows NT version 4.0 SP6, Windows 2000 Server SP2

• Sun SPARC^(TM) running Solaris 2.6 and Solaris 8

Documentation

---

All Sun Microsystems product documentation can be found at the following site:

http://docs.sun.com/

This section contains the following:

• iPlanet Application Server Enterprise Connector for Tuxedo 6.5 Documentation

• Software and Hardware Requirements

iPlanet Application Server Enterprise Connector for Tuxedo 6.5 Documentation

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.

• Administrator's Guide—(PN 806-5503-02) The Administrator's Guide explains how to get started with, install, manage, and configure the Enterprise Connector for Tuxedo 6.5.

• Developer's Guide—(PN 806-5504-02) The Developer's Guide gives a brief overview of the Enterprise Connector for Tuxedo 6.5 and explains how to develop applications that access the connector.

Referenced Documentation

References to specific pieces of documents are provided within the Enterprise Connector for Tuxedo 6.5 documentation.

• iPlanet Web Server Developer's Guide

• iPlanet Application Server Administrator's Guide

• iPlanet Application Server Release Notes

Software and Hardware Requirements

---

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.

Application Server Platform

Patches

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.

Solaris and Windows Systems

The following software must be installed before you can install the Enterprise Enterprise Connector for Tuxedo 6.5:

• Tuxedo Workstation Client 7.1 with Rolling Patch CR042398.

• iPlanet Application Server EPE Version 6.5 or 6.5 SP1.

• iPlanet Unified Integration Framework Version 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.

Solaris

• Memory: 256 MB minimum; 512 MB recommended

• Disk Space: 400 MB

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.

Windows NT/Windows 2000 Server SP2

• Memory: 256 MB minimum; 512 MB recommended

• Disk Space: 200 MB

Installation Notes

---

The iPlanet Application Server Enterprise Connector for Tuxedo, Version 6.5 must be installed on the same machine as iPlanet Application Server EPE.

To install the connector:

• for Windows NT or Windows2000 server SP2, unzip NT/instux.zip from the CD-ROM into a temporary directory; then run setup.exe in the instux directory.

• for Solaris, untar Solaris/instux.tar from the CD-ROM into a temporary directory and then run setup in the instux directory.

Post-Installation Issues

There are two mandatory post-installation issues that you must address:

• Multi-threading

• Memory Consumption

Multi-threading

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.

• To change the MaxPoolSize parameter refer to iPlanet Application Server Enterprise Connector for Tuxedo Administrator's Guide, Version 6.5, Chapter 3, section: Update Connection Pool Parameters.

Memory Consumption

Problem—The 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.

Solution—The 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:

Solaris:

On Solaris modify the iasenv script to change the flags.

The file, iasenv.ksh, is in the following directory: <ias_inst_dir>/ias/env

Set the following flags:

GX_ARGS : JAVA_GX_ARGS="-DGX.cleaner.enabled=yes

(By default Disabled)

JAVA_ARGS : Enable Explicit GC

Remove -XX:+DisableExplicitGC flag from JAVA_ARGS to enable Explicit GC

(By default Disabled)

JAVA_ARGS : Reset the Max Heap Size from 1024 MB to 512 MB

Windows:

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.

Figure 1    iPlanet Application Server EPE 6.5 Tree Structure.

Upgrade from iPlanet Application Server Enterprise Connector for Tuxedo 6.0 SPx to Version 6.5

---

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.

To Upgrade the iPlanet Application Server Enterprise Connector for Tuxedo from Version 6.0 SPx to Version 6.5.

1. Export the Unified Integration Framework Repository "bsp" node using Repository Browser
   1. Go to ".../APPS/bin and run "bspbrowser.sh"

   2. Export the Repository "bsp" node by selecting "Export Root".

      You must perform this step when upgrading from iPlanet Application Server EPE version 6.0 to versions 6.5 or 6.5 SP1.

2. Uninstall the UIF 6.0 SPx and iPlanet Application Server Enterprise Connector for Tuxedo 6.0 SPx

3. Upgrade iPlanet Application Server EPE 6.0 SPx to iPlanet Application Server EPE 6.5 or 6.5 SP1. See the Release Notes for iPlanet Application Server EPE 6.5 SP1.

4. Install Unified Integration Framework 6.5.

5. Install iPlanet Application Server Enterprise Connector for Tuxedo 6.5 on the same machine.

6. Import the UIF Repository "bsp" node using the UIF Repository Browser.
   1. Go to ".../APPS/bin and run "bspbrowser.sh"

   2. Import the Repository "bsp" node from the exported XML file.

Migrating the Applications

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.

Resolved Issues

---

Table 1 lists the issues resolved in iPlanet Application Server Enterprise Connector for Tuxedo.

Table 1    Resolved Issues

ID	Summary
5439445	You no longer need to modify the script iasenv.ksh that is located in <ias_root>/ias/env. as described in "Configuring The Installation, Solaris-based" section for iPlanet Application Server 6.0 SP3 in the Enterprise Connector for Tuxedo version 6.5 Administrator's Guide.

.

Known Problems and Limitations

---

Table 2 describes known problems and associated solutions for the iPlanet Application Server Enterprise Connector for Tuxedo.

Table 2   

ID	Summary
4640987	Uninstaller removes common files in multi-connector installation. Solution— When uninstalling one of several connectors, such as R/3, PeopleSoft, Tuxedo or CICS, the common directories <iASInstallDir>/ias/APPS/console, <iASInstallDir>/ias/APPS/ecu and files from the bin directory may be deleted. It is necessary to copy these directories back to APPS directory, while maintaining the same sub-directories structure, from <iASInstallDir>/ias/APPS/UIFbackup for the connectors to function correctly. All files that are present in the UIFBackup directory need to be copied to the <iASInstallDir>/ias/APPS.
4742828	The installer does not copy samples in webless installation mode. In a webless installation, the web server and iPlanet Application Server reside on separate machines. In this configuration mode the iPlanet Application Server Enterprise Connector for Tuxedo installation does not automatically copy the HTML and image files pertaining to connector samples to the web server document root directory. Solution— To run the samples shipped with the iPlanet Application Server Enterprise Connector for Tuxedo, copy the HTML and image files manually from the iPlanet Application Server instance to the web server instance. This process is described in section "Copying Files in Webless Installation" in the Administrator's Guide.
	The uninstaller doesn't delete repository content related to Enterprise Connector for Tuxedo 6.5. Solution—Use the Unified Integration Framework Repository Browser to delete the unwanted datasource(s).
	The uninstaller doesn't automatically unregister the Tuxedo extension in iPlanet Registry database. Solution—Unregister the Tuxedo extension manually. To unregister the Tuxedo extension: Open the iPlanet Registry editor by typing kregedit on the command line. Open the following key: SOFTWARE\iPlanet\Application Server\6.0\CCS0\Extensions\ TuxedoAdapterExt\ENABLED Set the value to 0 and click OK.
	The uninstaller removes common files in a multi-connector installation. When uninstalling one of several connectors, such as R/3, PeopleSoft, or CICS, the common directories /ias/APPS/console and /ias/APPC/ecu may be deleted. Solution —Copy these directories back to APPC directory from /ias/UIFbackup.

Known Problems and Limitations

How to Report Problems

---

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:

• Sun ONE online support web site at: http://www.sun.com/service/sunone/software/index.html

• The telephone dispatch number associated with your maintenance contract

So that we can best assist you in resolving problems, please have the following information available when you contact support:

• Description of the problem, including the situation where the problem occurs and its impact on your operation

• Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem

• Detailed steps on the methods you have used to reproduce the problem

• Any error logs or core dumps

Documentation Revision

---

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.

Table 3    Connector for Tuxedo Release Notes Revision History

Release Note Issue Date	Affected Sections
August 2002	Original release of this document
November 2002	Corrected URL references to Sun ONE doc sites in the For More Information Section. Added the following sections: Documentation Revision Product Certification of iPlanet Application Server Enterprise Connector for Tuxedo on iPlanet Application Server EPE Version 6.5 on Version 6.5 SP1.

For More Information

---

Useful Sun ONE information can be found at the following Internet locations:

Useful Sun ONE information can be found at the following Internet locations:

• Other iPlanet Application Server Enterprise Connector for Tuxedo documentation — http://docs.sun.com/db/prod/3682#hic

• Support Services & Knowledge Base — http://www.sun.com/service/sunone/software/index.html

• Consulting and Professional Services Information — http://www.sun.com/service/sunps/sunone/index.html

• Developer Information — http://developer.iplanet.com/

• Software Product Information — http://wwws.sun.com/software/

• Software Training — http://www.sun.com/software/training/

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