These release notes contain important information available on and after the release of the iPlanet Application Server Enterprise Connector for R/3 Version 6.0 SP2. 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 R/3.
An electronic version of these release notes can be found at the Sun ONE documentation web site: http://docs.sun.com
These release notes contain the following sections:
The connector supports SAP R/3 Versions 4.6B and 4.6C. SAP recommends that Versions 4.6B and 4.6C should be used with the 4.6D kernel (the latest release of the SAP kernel).
For more details see SAP R/3 release notes number 0156548, August 29, 2001:
The following table lists the hardware and software requirements for installing and running the iPlanet Application Server Enterprise Connector for R/3.
Component
Requirement
Total disk space: 200 MB on Windows NT and Windows2000, 400 MB on Solaris.
The following additional software is required:
Post-Installation Issues: with iAS SP2 and SP3.
Due to changes in deployment tools and directory structure of iAS SP2 and SP3, files need to be copied manually to run the iPlanet Application Server Enterprise Connector for R/3 SP2 samples with iAS 6.0 SP2 or SP3. See Problem 545163.
In order to upgrade the iAS Enterprise Connector for R/3 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 R/3 SP2 release:
The problem with backend connections that were not released by the worker process has been resolved.
The problem with the R3 workers that appeared to be stale after communication failure has been resolved in this release.
The problem with the RFC exceptions that were causing a memory leak in the worker process has been resolved.
The R/3 Samples delivered with iPlanet Application Server Enterprise Connector for R/3 Version 6.0 SP2 are developed for multi-language environments.
A drop-down list has been added to the first web page of the examples. The user has to select the corresponding charset to get correct data for the language selected.
For example if you want to select Japanese data stored in Shift_JIS format in the backend SAP system, select Shift_JIS from the drop-down list. The data should then been properly displayed on the browser.
A page directive has also been added to endForm.jsp for all the examples:
<%@ page contentType="text/html; charset=Shift_JIS" %>
If data with a different character set is to be retrieved, the JSP files have to be modified accordingly.
There is no need to recompile any java files.
For example if the data is stored in UTF-8, the jsp page has to be changed to:
<%@ page contentType="text/html; charset=UTF8" %>
To run the samples in Japanese, the application must be modified.
Please replace the following information in the iPlanet Application Server Enterprise Connector for R/3 Administrator's Guide:
In Table 3.1 in chapter 3, the variable Language should be defined as:
'Language used by the R3 server for messages. EN is English, DE is German. For other languages, consult the R/3 Guides." instead of the current text.
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 <iAS InstallDir>/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 files that are present in the UIFBackup directory need to be copied to the <iASInstallDir>/ias/APPS.
The worker process daemon is not working when multiple instances of iAS are installed on the same machine. It tries to use the same port number.
Modify the script startR3worker to start the second daemon on a different port.
"$" character is not acceptable in the R/3 connector
The "$" character cannot be used as a character in any of the datasource fields in the Management Console.
The documentation on User Management - Entity Mapping has been clarified.
You need to create Entity Mappings in the Management Console for each new datasource that you create.
The backend connections are not being released by the worker process.
The R/3 connector uses an out-of-process model. Connections to the R/3 system are through a worker process. The connections that are pooled by the UIF are not the actual connections to the R/3 backend. The connections are from iAS to the worker process. Therefore, none of the UIF pooling parameters are applied to the backend connections. For example, if you define the Max Pool Size as 20, you may have more than 20 connections to the backend since the worker process can create more connections. Even if you kill KJS, the backend connections will not close. To close the backend connections you need to terminate the worker processes.
Uninstaller removes common UIF backup files in multi-connector installation.
When installing one of several connectors, such as R/3, PeopleSoft, Tuxedo or CICS, the common directories <iAS InstallDir>/ias/Apps/console, <iASInstallDir>/ias/APPS/ecu and files from the bin directory may be deleted. Copy these directories back to the APPS directory while maintaining the same sub-directories structure from <iASInstallDir>/ias/APPS/UIFbackup for the connectors to function correctly. All the files that are present in the UIFBackup directory need to be copied to the <iASInstallDir>/ias/APPS/bin.
Problem: Unexpected Memory Consumption
If you upgrade from iAS6.0 SP3 to iAS6.0 SP4, there may be unexpected memory consumption under a heavy load with huge data transformation.
Refer to iAS 6.0 SP4 release note memory management section or contact support for fine tuning the memory.
Sample Applications do not work with iAS SP2 and UIF Version 6.0 SP2.
The following tasks should be performed to copy the files manually for the following samples:
Copy Execute.properties and Execute_properties.properties from
<iAS Install Dir >\ias\APPS\BAPI_CUSTOMER_GETDETAIL\BAPI
<iAS Install Dir >\ias\APPS\BAPI_CUSTOMER_GETDETAIL
Copy Execute.properties and Execute_properties.properties from
<iAS Install Dir >\ias\APPS\BAPI_CUSTOMER_GETDETAIL_EJB\BAPI
<iAS Install Dir >\ias\APPS\BAPI_CUSTOMER_GETDETAIL_EJB
Copy Execute.properties and Execute_properties.properties from
<iAS Install Dir >\ias\APPS\BAPI_CUSTOMER_GETSALESAREAS\BAPI
<iAS Install Dir >\ias\APPS\BAPI_CUSTOMER_GETSALESAREAS
The following tasks should be performed to copy the files manually for the following samples:
Copy Execute.properties and Execute_properties.properties from
<iAS Install Dir >/ias/APPS/BAPI_CUSTOMER_GETDETAIL/BAPI
<iAS Install Dir >/ias/APPS/BAPI_CUSTOMER_GETDETAIL
Copy Execute.properties and Execute_properties.properties from
<iAS Install Dir >/ias/APPS/BAPI_CUSTOMER_GETDETAIL_EJB/BAPI
<iAS Install Dir >/ias/APPS/BAPI_CUSTOMER_GETDETAIL_EJB
Copy Execute.properties and Execute_properties.properties from
<iAS Install Dir >/ias/APPS/BAPI_CUSTOMER_GETSALESAREAS/BAPI
<iAS Install Dir >/ias/APPS/BAPI_CUSTOMER_GETSALESAREAS
The samples do not work when using Webserver 6.0 SP1.
In order to use the samples with Webserver 6.0 SP1:
There may be some instability issues with the R/3 Connector under heavy load with large amounts of data on Windows2000 platforms.
The test failed on multi-CPU system and passed on single-CPU system. We suspect multi-CPU issues on Windows2000 platforms.
If you have problems with iPlanet Application Server Enterprise Connector for R/3 Version 6.0 SP2, 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 Sun ONE information can be found at the following Internet locations:
Last Updated August 13, 2002