These release notes contain important information concerning the Version 6.5 release of the iPlanet(TM) Application Server Enterprise Connector for PeopleSoft. New features and enhancements, installation notes, known problems, and other late-breaking issues are addressed here. Read this and associated documents before you begin using iPlanet Application Server Enterprise Connector for PeopleSoft.
This document contains the following sections:
There are no new features in the Enterprise Connector for PeopleSoft 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 Version 6.5 SP1.
The Enterprise Connector for PeopleSoft 6.5 supports the following platforms:
Microsoft Windows NT version 4.0 SP6/Windows 2000 server SP2
Sun SPARC(TM) running Solaris 2.6
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 PeopleSoft 6.5 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 PeopleSoft 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 Connector for PeopleSoft 6.5:
iPlanet Application Server Enterprise Pro Edition 6.5 requires the JDK 1.3.1_04 patch. The patch is not required if you install the 6.5 SP1 version.
All iPlanet Application Server EPE, versions 6.5 and 6.5 SP1 components and the Unified Integration Framework, version 6.5, must be installed on the server machine before the Enterprise Connector for PeopleSoft 6.5 is installed. The Enterprise Connector for PeopleSoft 6.5 must be installed on the same machine as the iPlanet Application Server EPE.
Installation of the product is as follows:
The following post-installation issues must be addressed:
The following directories need to have the permissions set as indicated:
The following files need to be modified to run the application:
For Solaris: The script must include the $PS_HOME environment variable. The value of this variable is the path of the directory that contains tuxedo/locale/CATALOG directory. For example, if the PeopleSoft installation contains the path /local/psft/tuxedo/locale then $PS_HOME=/local/psft.
The $LD_LIBRARY_PATH environment variable must also contain the directory that contains libpsmsg.so, supplied by PeopleSoft. For more details consult your system administrator.
For Windows: The Windows $PATH- environment variable must also point to the directory that contains psmsg.dll, supplied by PeopleSoft. For more details consult your system administrator.
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 PeopleSoft 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 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 PeopleSoft 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 Integration 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 PeopleSoft
Table 2 describes known problems and associated solutions for the Enterprise Connector for PeopleSoft 6.5.
If you have problems with Enterprise Connector for PeopleSoft 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 PeopleSoft 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:
Note
Upgrade from Connector for PeopleSoft 6.0 SPx to Version 6.5
To Upgrade the iPlanet Application Server Enterprise Connector for PeopleSoft 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(TM) Application Server Enterprise Connector for PeopleSoft 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