Release Notes for iAS Enterprise Connector for PeopleSoft

Version 6.0 SP1[and for iAS version SP2]

Updated February 20, 2001

These release notes contain important information available at the time of the version 6.0 [SP 1] release of iAS Enterprise Connector for PeopleSoft. New features and enhancements, installation notes, known problems, and other late-breaking issues are addressed here. Read this document before you begin using iAS Enterprise Connector for PeopleSoft.

An electronic version of these release notes can be found at the iPlanet documentation web site: http://docs.iplanet.com/docs/manuals/. 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 iAS Enterprise Connector for Peoplesoft, Version 6.0

These release notes detail the changes, resolved issues and known problems for the iPlanet Application Server Enterprise Connector for PeopleSoft, version 6.0 SP1 and for iAS version SP2 releases.

Software and Hardware Requirements

The following table lists the hardware and software requirements for installing and running the Peoplesoft Enterprise Connector.

Table 1 Software and Hardware Requirements

Component

Requirement

Computer and Operating System

One of the following systems:

Intel Pentium microprocessor running Microsoft Windows NT version 4.0 with Service Pack 5.

Sun SPARC running solaris 2.6.

Memory

Per CPU: 256 MB minimum; 512 MB recommended.

Available disk space

Total disk space: 200 MB on Windows NT, 400 MB on Solaris.

CD-ROM drive

CD-ROM drive

Network software

TCP/IP

Browser software

One of the following browsers:

Netscape Communicator 4.5 or later

Microsoft Internet Explorer 4.0 (Windows NT only)

PeopleSoft System

Version 7.55 installed.

Other software

The following additional software is required:

iPlanet Application Server 6.0 SP1 or SP2

Unified Integration Framework 6.0 SP1

The iPlanet Application Server and Unified Integration Framework must be installed prior to installing the Peoplesoft Enterprise Connector.

Component	Requirement
Computer and Operating System	One of the following systems: Intel Pentium microprocessor running Microsoft Windows NT version 4.0 with Service Pack 5. Sun SPARC running solaris 2.6.
Memory	Per CPU: 256 MB minimum; 512 MB recommended.
Available disk space	Total disk space: 200 MB on Windows NT, 400 MB on Solaris.
CD-ROM drive	CD-ROM drive
Network software	TCP/IP
Browser software	One of the following browsers: Netscape Communicator 4.5 or later Microsoft Internet Explorer 4.0 (Windows NT only)
PeopleSoft System	Version 7.55 installed.
Other software	The following additional software is required: iPlanet Application Server 6.0 SP1 or SP2 Unified Integration Framework 6.0 SP1 The iPlanet Application Server and Unified Integration Framework must be installed prior to installing the Peoplesoft Enterprise Connector.

Installation Notes

Please make sure all iPlanet Application Server 6.0 SP1 or SP2 components and the Unified Integration Framework (UIF) SP1 have already been installed on the server machine. The iPlanet Enterprise Connector for PeopleSoft must be installed on the same machine as the iPlanet Application Server.

Installation

Installation of the product is as follows:

for Windows NT, unzip the file NT\inspsft.zip from the CD-ROM into a temporary directory, then run the file setup.exe in the inspsft directory.
for Solaris, untar the file Solaris/inspsft.tar from the CD-ROM into a temporary directory and then run the file setup in the inspsft directory.

Post-Installation Issues: iAS SP2 Users Only

Due to changes in iAS 6.0 SP 2 deployment tools and directory structure, files need to be copied manually to run the PeopleSoft Connector 6.0 SP1 samples with iAS 6.0 SP2.

For NT:

The following tasks should be performed to copy the files manually for the following samples:

ProcessMsg

Copy Execute.properties and Execute_properties.properties

from

<iAS Install Dir >\ias\APPS\ProcessMsg\ProcessMsg

to

<iAS Install Dir >\ias\APPS\ProcessMsg
SearchDialog

Copy Execute.properties and Execute_properties.properties

from

<iAS Install Dir >\ias\APPS\SearchDialog\ SearchDialog

to

<iAS Install Dir >\ias\APPS\ SearchDialog
ProcessMsgEJB

Copy Execute.properties and Execute_properties.properties

from

<iAS Install Dir >\ias\APPS\ProcessMsgEJB\ ProcessMsgEJB

to

<iAS Install Dir >\ias\APPS\ ProcessMsgEJB

For Solaris:

The following tasks should be performed to copy the files manually for the following samples:

ProcessMsg

Copy Execute.properties and Execute_properties.properties

from

<iAS Install Dir>/ias/APPS/ProcessMsg/ProcessMsg

to

<iAS Install dir>/ias/APPS/ProcessMsg
SearchDialog

Copy Execute.properties and Execute_properties.properties

from

<iAS Install Dir>/ias/APPS/ProcessMsg/SearchDialog

to

<iAS Install dir>/ias/APPS/SearchDialog
ProcessMsgEJB

Copy Execute.properties and Execute_properties.properties

from

<iAS Install Dir>/ias/APPS/ProcessMsg/ProcessMsgEJB

to

<iAS Install dir>/ias/APPS/ProcessMsgEJB

Upgrading From the Enterprise Connector for Peoplesoft Version 6.0.

All datasource information is overwritten when you upgrade the Enterprise Connector for PeopleSoft version 6.0. You may backup datasources from the previous version and use them in this release.

The procedure for backing up and re-using user mapping information is as follows:

Before installing the UIF v6.0 SP1, backup the PeopleSoft datasource nodes from each PeopleSoft datasource in the UIF repository, using the Repository Browser's export utility (for example, DS1.xml DS2.xml)
During UIF installation, the installer prompts you to overwrite the existing BSP node. Select YES to overwrite the existing BSP node.
For NT: Copy the repository.dtd file from the <iasinstalldir>\ias\APPS\adapters\psft\samples\metadata directory to the directory where modified XMLs are stored.

For Solaris: Copy the repository.dtd from the <iasinstalldir>/ias/APPS/adapters/psft/samples/metadata directory to the directory where modified XMLs are stored.
Import the DS1.xml using the Repository Browser's import utility under the dataSources node.

Documentation

This product includes an Administrator's and a Developer's Guide. The installer copies these publications to the ias/APPS/docs/psft subdirectory of the root installation directory of your iPlanet Application Server. These documents are available online in PDF and HTML formats. To access these files, use the following URL:

http://docs.iplanet/com/docs/manuals/ias/html

Adobe Acrobat 4.0 and PostScript printer with PS level 2 fonts are required to print the PDF version.

The following lists corrections to the documentation posted on the web site.

Documentation Corrections in the Administrator's Guide

Entity Mapping

You must create at least one entity and one user after creating a new data source.

Resolved Issues

The following issues have been resolved in the iPlanet Application Server Enterprise Connector for PeopleSoft 6.0 Service Pack 1 release.

Table 2 Resolved Issues

ID

Summary

364671

Add and edit data source to the Management Console options.

398160

You can now modify Pool parameters such as MaxPoolSize and SteadyPoolSize with the Management Console.

398161

The sample has been replaced with a simpler sample.

402121

An entity can not be deleted if there are mapped users.

413928

Error recovery/exception handling mechanism.

519068

A screen has been added at the end of the procedure for creating a new data source using the Management Console. The screen will alert the user if there is an existing data source with the same name and ask, Yes or No, if the existing data source should be over-written. If you choose the Yes option, the data source will be over-written; if you choose No, the data source that you created will be deleted.

N/A

Improved Pooling. there is now a pool for each user.

ID	Summary
364671	Add and edit data source to the Management Console options.
398160	You can now modify Pool parameters such as MaxPoolSize and SteadyPoolSize with the Management Console.
398161	The sample has been replaced with a simpler sample.
402121	An entity can not be deleted if there are mapped users.
413928	Error recovery/exception handling mechanism.
519068	A screen has been added at the end of the procedure for creating a new data source using the Management Console. The screen will alert the user if there is an existing data source with the same name and ask, Yes or No, if the existing data source should be over-written. If you choose the Yes option, the data source will be over-written; if you choose No, the data source that you created will be deleted.
N/A	Improved Pooling. there is now a pool for each user.

Known Problems and Limitations

ID:517183

Uninstaller Removes Common Files in Multi-connector Installation

When uninstalling one of several connectors, such as Peoplesoft, R/3, or CICS, the common directories /ias/Apps/console and ias/Apps/ecu may be deleted. It is necessary to copy these directories back to the Apps directory from the ias/Apps/UIFbackup for the Peoplesoft connector to function correctly.

To uninstall a connector from a Windows NT that has multiple connectors installed:

If you want to uninstall a connector from an NT machine that has more than one connector installed, perform the following tasks.

Uninstall the connector. Refer to Chapter 2 in the Administrator's Guide.

During the uninstallation procedure the connector files shown in the right panel, as seen in the screen capture below, are removed from the iPlanet/iAS6/ias directory and moved to the UIFbackup/console directory. The connector files need to be copied back to their original location.
Copy the console specific directories, the top level directory and the connector specific directories to the ias/Apps/console for the following folders:
- constants
- exceptions
- ftp
- gui
- model
All the other directories, with all their included files, and the LocalDebug.class should be copied back.
Copy the connector files Appltab and ldobuffer.dll to the directory iPlanet/ias/Apps/bin.

To uninstall a connector from a Solaris machine that has multiple connectors installed:

Uninstall the connector. Refer to Chapter 2 in the Administrator's Guide.

During the uninstallation procedure the connector files are removed from the iPlanet/iAS6/ias directory and moved to the UIFbackup/console directory. The connector files need to be copied back to their original location.
Copy the console specific directories, the top level directories, and the connector specific directories to ias/APPS/console for the following folder:
- constants
- exceptions
- ftp
- gui
- model
All the other directories, with all their included files, and the file LocalDebug.class should be copied back.

D:532185

The following directories need to have the permissions set as indicated:

For Solaris:

$<iAS installation directory>/ias/APPS - must be writable by the user running the management console (psconsole.sh). If not, the management console cannot write the XML files that it generates.
$PS_HOME - must be writable for all users. Tuxedo libraries write a log file to the $PS_HOME directory.

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 NT:

The NT: $PATH- environment variable must also point to the directory that contains psmsg.dll, supplied by PeopleSoft. For more details consult your system administrator.

Limitation

Only Oracle databases are supported with this release.

How to Report Problems

If you have problems with iPlanet iAS Enterprise Connector for PeopleSoft, contact iPlanet customer support using one of the following mechanisms:

iPlanet online support web site at http://www.iplanet.com/support/online/

From this location, the CaseTracker and CaseView tools are available for logging problems.
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

For More Information

Useful iPlanet information can be found at the following Internet locations:

iPlanet release notes and other documentation --- http://docs.iplanet.com/docs/manuals/
iPlanet product status --- http://www.iplanet.com/support/technical_resources/
iPlanet Professional Services information --- http://www.iplanet.com/services/pro_serv/index.html
iPlanet developer information --- http://developer.iplanet.com/
iPlanet learning solutions --- http://www.iplanet.com/learning/index.html
iPlanet product data sheets --- http://www.iplanet.com/products/index.html

Last Updated February 20, 2001