These release notes contain important information available at the time of the version 6.0 SP2 release of iPlanet 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 before you begin using iPlanet Application Server Enterprise Connector for Tuxedo.
An electronic version of these release notes can be found at the iPlanet documentation web site: http://docs.sun.com
These release notes contain the following sections:
The following table lists the hardware and software requirements for installing and running iPlanet Application Server Enterprise Connector for Tuxedo.
Component
Requirement
Total disk space: 200 MB on NT and Windows2000, 400 MB on Solaris.
The following additional software must be installed prior to installing the iPlanet Application Server Enterprise Connector for Tuxedo:
The iPlanet Application Server 6.0 SP2 or SP3 component, the Unified Integration Framework (UIF) SP2, and Tuxedo Workstation client 7.1 must be installed before installing iPlanet Application Server Enterprise Connector for Tuxedo, version 6.0 SP2.
The iPlanet Application Server Enterprise Connector for Tuxedo, Version 6.0 SP 2 must be installed on the same machine as iPlanet Application Server.
One of the most significant improvements from Tuxedo version 6.5 to version 7.1 was the addition of multi-threading.
multi-threading is the inclusion of more than one unit of execution in a single process. In a multi-threaded application, multiple simultaneous calls can be made from the same process.
The advantages of multi-threading are:
The disadvantages of multi-threading are:
The server must be specifically configured and compiled to use multi-threading.
To configure a multi-threaded application, edit your UBBCONFIG file by adding the parameters shown in the Table 2.
If you are creating a multi-threaded server, you must run the buildserver(1) command with the -t option. This option is mandatory for multi-threaded servers. If you do not specify the -t option at build time, and try to boot the new server with a configuration file where the value of MAXDISPATCHTHREADS is greater than 1, a warning message is recorded in the userlog. The server then reverts to single-threaded operation.
For more information on multi-threading, see the documentation on the Tuxedo 7.1 CD -ROM. Refer to the section concerning: How multi-threading and Multicontexting Work in a Server, docs/tuxedo/v7_1/html/pgthr7.htm.
When you use multi-threading you need to customize the connection Pool parameter: MaxPoolSize. It should be the multiple of 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.0, Chapter 3, section: Update Connection Pool Parameters.
In order to upgrade the iAS Enterprise Connector for Tuxedo you must also upgrade the iPlanet Application Server 6.0 SP1 and the Unified Integrated Framework from SP1 to SP2.
You must have iPlanet Application Server 6.0 SP2, SP3, or SP4 installed before upgrading the UIF and Connector.
Refer to the Unified Integrated Framework 6.0 SP2 release notes for instruction on upgrading from SP1.
The following issues have been resolved in the iPlanet Application Server Enterprise Connector for Tuxedo 6.0 Service Pack 2 release:
iPlanet Application Server Enterprise Connector for Tuxedo consumes an exorbitant amount of CPU time.
Two new variables have been added to the worker so that the Tuxedo client avoids repetitive GETREPLY requests without receiving a reply: SLEEPTIME and MAXSLEEPTIME.
Configuring the Installation: Unix section for iAS SP2 and later.
The following is not valid for versions iAS SP2 or later:
Add <tuxedo /ws rootdir>/lib to LD_LIBRARY_PATH environment variable.
* The LD_LIBRARY_PATH of the shell environment may be modified, or the script <ias root>/ias/bin/kjs may be adjusted to include this path
With iAS SP2 and later, the "kjs" is changed and LD_LIBRARY_PATH can no longer be changed in this script. This script now internally calls <ias root>/ias/env/iasenv.ksh which in turn adds $TUXDIR/lib to LD_LIBRARY_PATH (TUXDIR= <tuxedo /ws rootdir>). Setting TUXDIR environment variable is sufficient.
The Tuxedo Connector did NOT pass an empty FML32/FML16 string.
The iAS Connector for Tuxedo now passes an empty FML32/FML16 string.
The following lists known problems and limitations:
Uninstaller removes common files in multi-connector installation.
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.
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 Tuxedo Enterprise connector installation does not automatically copy the HTML and image files pertaining to connector samples to the web server document root directory.
To run the samples shipped with the Tuxedo Enterprise connector, 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 Tuxedo connector.
Use the UIF Repository Browser to delete the unwanted datasource(s).
The uninstaller doesn't automatically unregister the Tuxedo extension in iPlanet Registry database.
To unregister the Tuxedo extension:
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.
Copy these directories back to APPC directory from /ias/UIFbackup.
FML fields can not be deleted using the Repository Browser.
Use the Netscape Console to delete the unwanted FML/FML32 field(s). Optionally, the configuration node can be exported into an XML file, delete unwanted FML field entries in XML file and re-import using the Repository Browser.
The samples do not work when using Webserver 6.0 SP1.
In order to use the samples with Webserver 6.0 SP1:
If you have problems with iPlanet Product_Name, contact iPlanet 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:
Useful iPlanet information can be found at the following Internet locations:
Copyright © 2001 Sun Microsystems, Inc. All rights reserved
Last Updated August 28, 2002