Release Notes for iPlanet^TMApplication Server Unified Integration FrameWork

Version 6.5

These release notes contain important information available at the time of the Version 6.5 release of iPlanet^TMApplication Server Unified Integration FrameWork. New features and enhancements, installation notes, known problems, and other late-breaking issues are addressed here. Read this document before you begin using iPlanet^TMApplication Server Unified Integration FrameWork.

An electronic version of these release notes can be found at the iPlanet documentation web site: http://docs.sun.com.Check the web site prior to installing and setting up your software and then periodically thereafter to view the most up-to-date release notes and manuals.

These release notes contain the following sections:

• What's New in UIF, Version 6.5

• Product Certification of iPlanet Application Server EPE 6.5 Products on iPlanet Application Server EE 6.5 SP1

• Installation Notes

• Upgrade from iPlanet Application Server Enterprise Connectors 6.0 SP2 to UIF Version 6.5

• Known Problems and Limitations

• How to Report Problems

• Documentation Revision

• For More Information

What's New in UIF, Version 6.5

---

• UIF Tracing

• Single Click Installation

• Repository Browser

• LDAP Failover Support

UIF Tracing

UIF provides the tracing API that is used for connector developers as well as application developers for dumping messages in UIF runtime and connector runtime.

This feature is turned off, by default, in the UIF installation, for example, ENABLE_TRACING=0. When the user needs to turn on the UIF tracing switch, set ENABLE_TRACING=1 in the UIFTraceConfig.properties file.

Impact on UIF Applications and UIF Connectors:

• Application Developers - Edit the UIFTraceConfig.properties in <iASinstall_location>/ias/APPS directory to enable Tracing and dump tracing messages at runtime.

• Connector developers - Use the UIF Tracing API to dump messages at various points in the connector execution. Edit the UIFTraceConfig.properties to make matching flag entries.

Table 1 lists the changes and impact on UIF Tracing.

Table 1 �� Changes and Impact on UIF Tracing

Filename	Impact on UIF Tracing
UIFTraceConfig.properties file�	locate in <iASinstall_location>/ias/APPS directory Out of the box entries are ..... ENABLE_TRACING=0 UIF_RUNTIME_CONNECTOR=1 UIF_RUNTIME_POOLING=1 UIF_RUNTIME_FUNCOBJ=1 UIF_RUNTIME_SP=1 This file can be extended by adding connector keys. For Example MY_CONNECTOR_POOLING=1 MY_CONNECTOR_EXECUTION=1 ...etc�
ENABLE_TRACING�	Setting to 1 will enable tracing. Setting to 0 will disable tracing completely.�
UIF_RUNTIME_CONNECTOR�	Setting to 1 will dump the UIF and connector interaction messages Setting to 0 disables the messages.�
UIF_RUNTIME_POOLING�	Setting to 1 will dump the UIF pooling related messages. Setting to 0 disables the messages.�
UIF_RUNTIME_FUNCOBJ�	Setting to 1 will dump the UIF Function Object related messages. Setting to 0 disables the messages.�
UIF_RUNTIME_SP�	Setting to 1 will dump the UIF Service Provider related messages. Setting to 0 disables the messages�
Tracing API (for ECB SDK users only)'�	The tracing API is available in CoErrorLogMgr.h HRESULT UIFTraceMsg( /* [in] */ LPSTR pTraceFlagName, /* [in] */ LPSTR pFormat, ...) ; Usage #include "access_cErrorLogExt.h" UIFTraceMsg("MY_CONNECTOR_EXECUTION", "Executing function object %s", functionObjectName) ; ... and make the MY_CONNECTOR_EXECUTION flag entry in the UIFTraceConfig.properties file. When ENABLE_TRACING=1 and MY_CONNECTOR_EXECUTION=1, UIFTraceMsg will start dumping messages in to KJS log file.�

Single Click Installation

UIF is installed directly from the CD.

Impact on UIF Applications and UIF Connectors:

There is no longer a need to unzip the UIF bits on to a hard drive. You can run setup, directly from the CD.

1. Change to the Windows/Solaris directory on the CD.

2. To start installation:

   For Windows:

   click on setup.exe.

   For Solaris:

   Execute the setup script.

Repository Browser

All the strings and image locations have been internationalized. The Repository.properties file containing the key value pairs is located in the <iASinstall_location>/ias/APPS directory. When being translated to Japanese, for example, this file needs to be renamed as Repository_ja.properties and the values need to be changed to Japanese. The same procedure needs to be followed for other languages, with proper language code. For example fr for French, fr_FR for French & France, en_US for English and US etc.)

The Repository Browser images are kept in the <iASinstall_location>/ias/APPS/bspimages/en directory. To localize to Japanese, for example, you should create a 'ja' directory under <iASinstall_location>/ias/APPS/bspimages and edit the image files. The image file name should not be changed.

For localized versions please contact you nearest iPlanet sales representative.

Impact on UIF Applications and UIF Connectors:

The Repository Browser can be viewed in different languages.

LDAP Failover Support

UIF runtime switches to a secondary LDAP server in case the primary LDAP server fails. The following describes two scenarios for LDAP failover support:

• iPlanet Application Server installed with LDAP failover support:

  When iPlanet Application Server is installed with LDAP failover support, UIF configurations are updated appropriately during the install time. Hence UIF fails over to the secondary LDAP server, when the primary one fails.

• Secondary LDAP server added at a later time to iPlanet Application Server installation:

  If a secondary LDAP server is added at a later time to iPlanet Application Server installation, the BSPConfig.properties file needs to be updated.

To Update the BSPConfig.properties File

1. Open the BSPConfig.properties file located in [iAS_install_directory]/ias/APPS.

2. Add the secondary host name to the key 'hostname', with a space.

For example, if the 'hostname' entry is mentioned as 'hostname=myprimaryhost', a secondary host name can be added as 'hostname=myprimaryhost mysecondaryhost'. The other LDAP parameters do not need to be modified.

Product Certification of iPlanet Application Server EPE 6.5 Products on iPlanet Application Server EE 6.5 SP1

---

The following iPlanet Application Server EPE 6.5 products have been certified to run on iPlanet Application Server, Enterprise Edition, 6.5 SP1.

• Unified Integration Framework, 6.5

• iPlanet Application Server Enterprise Connectors, 6.5

Installation Notes

---

UIF can be installed directly from the CD. This feature is available on NT and Solaris. See Single Click Installation.

Upgrade from iPlanet Application Server Enterprise Connectors 6.0 SP2 to UIF Version 6.5

---

In order to upgrade the iPlanet Application Server Enterprise Connectors for version 6.0 SP2, you must also upgrade the iPlanet Application Server 6.0 SP2 and the Unified Integrated Framework from SP2 to Version 6.5

You must have iPlanet Application Server 6.5 installed before upgrading the UIF and Connector.

To Upgrade the iPlanet Application Server Enterprise Connector for Version 6.0 SP2 to UIF Version 6.5.

1. Export the UIF Repository "bsp" node using UIF 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 while migrating from iPlanet Application Server 6.0 to iPlanet Application Server 6.5.

2. Install the iAS 6.5/UIF/Connector Version 6.5
   1. Uninstall the iAS/UIF/Connectors 6.0 and Install and then iAS/UIF/Connectors 6.5 on the same machine

      or

   2. Install the iAS/UIF/Connector 6.5 on different machine.

3. 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.

After step1 and step2 the following software is updated:

• UIF/Connectors 6.5

• iPlanet Application Server 6.5

• iDS (may be updated or uses the previous version. The update is dependent on iPlanet Application Server 6.5 installation input from user.)

If you are using the iDS installed with iPlanet Application Server 6.0, there is no need to perform Step 3.

Migrating the Applications

You need to deploy all the applications to the Application Server. Refer to the iPlanet Application Server documentation for migrating the applications.

Known Problems and Limitations

---

In UIF Version 6.0 SP2 release the "&" character can not be used in the repository.

Problem 526169

iPlanet Application Server Tuxedo Extension - FML32 numeric input buffers defaults to zero.

The UIF assigns a default value to integers when the XML is loaded into the repository.

Workaround

Wrap the integer in an array to avoid the integer being default to '0'.

Problem 4725667

There are embedded Spaces in PATH/CLASSPATH.

Workaround

Before installing the Application Server iAS/UIF/Connectors on Windows be certain that there are no embedded spaces in PATH or CLASSPATH.

How to Report Problems

---

If you have problems with iPlanet^TMApplication Server Unified Integration FrameWork Version 6.5, contact iPlanet 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 Unified Integration Framework 6.5 release.

Table 2 shows the revision history for this document, and lists the affected sections.

Table 2 �� UIF 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 EPE 6.5 Products on iPlanet Application Server EE 6.5 SP1 �

For More Information

---

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

• Other iPlanet^TMApplication Server Unified Integration FrameWork documentation — http://docs.sun.com/db/prod/3698#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^TMApplication Server Unified Integration FrameWork is subject to the terms described in the license agreement accompanying it. Copyright � 2002 Sun Microsystems, Inc.

Last Updated November 26, 2002