IBM Lotus Enterprise Integrator for Domino (LEI) Release 6.5.3 January 19, 2005 A) What's New in LEI Release 6.5.3 B) System Requirements C) Installation and Migration Considerations D) Installing LEI - General Instructions E) Uninstalling LEI F) Operational Considerations G) What's Been Fixed in LEI Release 6.5.3 H) Documentation Errata I) Troubleshooting and Additional Support ________________________________________________________________________ A) What's New in LEI Release 6.5.3 For the latest information about Enterprise Integration offerings, visit the http://www.lotus.com/ei Web site or the Lotus Documentation site (http:/www.lotus.com/doc). LEI Release 6.5.3 is a point release to the major LEI 6.5 release. If you are new to the 6.5x stream, please also see the version 6.5x readme.txt files at the Lotus Documentation site (http://www.lotus.com/doc). The Lotus Connectors and Connectivity Guide and readme.txt have been updated from 6.5.2; other changes are documented in this readme.txt. LEI now uses Domino memory management tools. Benefits of the switch include enhanced performance and simplified troubleshooting. LEI 6.5.3 recommends using the Lotus-branded DataDirect ODBC Wire Protocol Drivers Release 5.0. iSeries users cannot use the DataDirect 5.0 drivers. Instead, iSeries users should use the DataDirect 4.2 drivers. The Lotus Connectors and Connectivity Guide has been updated for 6.5.3 to reflect the new driver data, specifically the ODBC Connector chapter. Data Direct drivers are installed on the iSeries platform by the Domino installation program. The ODBC DataDirect Lotus-branded drivers are available for download on IBM Passport Advantage for licensed LEI users at the following Web address: http://www-306.ibm.com/software/howtobuy/passportadvantage/ B) System Requirements For complete details see the LEI Installation Guide. *Hardware Requirements* - 40MB disk space on Win32 - 80MB disk space on UNIX and iSeries - 90MB temp space on Win32 - required by iSeries LEI Installer - 15MB temp space on Win32 - required by LEI installer - 90MB temp space on UNIX - required by LEI installer *Operating Systems and Versions* LEI 6.5.3 is supported on the following platforms: - Windows NT 4 SP6a, 2000, and 2003 - AIX 5.1, and 5.2 - Solaris 2.8 and 2.9 - United Linux v1.0 - OS400 V5R1, V5R2, and V5R3 Read all Domino documentation regarding the specific patches Domino requires for its server. The patch level required by Domino is a prerequisite for successful LEI installation. Patch requirements are updated periodically. See the Domino documentation for details. For example, the correct Solaris patch cluster is required. See IBM Technote 175748 for description of known issues for Windows NT 4.0 service pack 6a. *Software Requirements* LEI 6.5.3 requires Notes/Domino 6.5.3. - Notes 6 client to administer the LEI Administrator database A 6.5.3 Notes client is required if LEI is installed on a Notes client. - Domino 6.5.3 server to manage the LEI Administrator database and run the LEI server if LEI is installed on a Domino server - Client libraries of the external systems to be accessed must be installed on the LEI server and the Domino server. When running activities, if the LEI server and the Domino server are on separate machines, the client libraries must be installed on both machines. - For UNIX - X Window system server environment - For UNIX - X Window system client libraries *** Verify that all of your database software is current with all available maintenance releases and/or fix packs. *Current supported data drivers list* Win NT4, 2000, Win2003 Oracle 8i, 9i, 10g DB2 UDB 7.x and 8.1 up through SP6 Sybase 12.5 MS SQL Server 2000 Data Direct ODBC 5.0 AIX 5.1, 5.2, 5.3 Oracle 8i, 9i, 10g DB2 UDB 7.x and 8.1 up through SP6 Sybase 12.5 Data Direct ODBC 5.0 Sol 8, 9 Oracle 8i, 9i, 10g DB2 UDB 7.x and 8.1 up through SP6 Sybase 12.5 Data Direct ODBC 5.0 LINUX RedHat AS 2.1, RedHat AS 3.0, United LINUX 1.0 Oracle 8i, 9i, 10g DB2 UDB 7.x and 8.1 up through SP6 Data Direct ODBC 5.0 i5/OS V5R1, V5R2, V5R3 DB2 UDB 7.x and 8.1 up through SP6 Data Direct ODBC 5.0 *Testing Connectivity* - The supplied DCTEST program tests connectivity from the system on which the LEI server is installed to external data sources. The LEI server acts as a client to your external data server. - Run the appropriate connectivity test program from the Domino server before running LEI. The program names are listed below by platform: Issue the following command for Windows (NT, 2000, 2003): ndctest Issue the following command for UNIX (AIX, Linux, and Solaris): dctest Issue the following command for iSeries: RUNDOMCMD SERVER(your_dom_server) CMD(CALL PGM(QDOMINOxxx/DCTEST)) BATCH(*NO) where xxx is the Domino release (6.5.3) Command window help provides information for using the connectivity test program. C) Installation and Migration Considerations See the Installation Guide (leiig.nsf) supplied with LEI and also available as both a .nsf file and an HTML browseable at the Lotus Documentation site (http://www.lotus.com/doc) on the Enterprise Integrator product page for LEI installation and migration instructions. See below for related considerations. D) Installing LEI - General Instructions See the Installation Guide (leiig.nsf) supplied with LEI and also available as both a .nsf file and an HTML browseable at the Lotus Documentation site (http://www.lotus.com/doc) on the Enterprise Integrator product page for complete LEI installation and migration instructions. See below for related considerations. Before installing to a UNIX platform, you must do the following: - Set the correct access controls in the names.nsf file on the Domino server. - Establish the correct access rights in the Notes ID file. - Ensure that all needed environment variables are set and exported. - Ensure that you have loaded and configured X Window system software. If you will be installing LEI to a Notes client, set the Notes ID to share its password with other Notes-based systems, as documented in the LEI installation guide. To avoid multiple promptings for password, ensure that your Notes client is running during LEI install. E) Uninstalling LEI The LEI uninstall process is explained fully in the Installation Guide (leiig.nsf) supplied with LEI and also available as both a .nsf file and an HTML browseable at the Lotus Documentation site (http://www.lotus.com/doc) on the Enterprise Integrator product page. F) Operational Considerations LEI Tech Notes and other user information can be found at http://www-3.ibm.com/software/lotus/support/integration/support.html. The Lotus Connector LotusScript Extensions Guide (lsxlc6.nsf) and Lotus Connectors and Connectivity Guide (lccon6.nsf) are not supplied with LEI. You can obtain them at the Lotus Documentation site or with your Domino release. G) What's Been Fixed in LEI Release 6.5.3 The following issues have been corrected in LEI 6.5.3. General: LEI and DECS now use Domino Memory Management in order to better detect and help resolve intermittent DECS/LEI memory leaks. LEI used the "serverkeyfile" specified in the Domino notes.ini, rather than the ID specified with the "keyfilename" variable. This issue has been corrected When LEI was started as an addin task, all threads remained open when LEI was closed. This issue has been corrected. Connections: The LC LSX property LCTOKEN_RECORD_LIMIT was being incorrectly set when using the Lotus Connector for DB2. The workaround was to connect to DB2 using the Lotus Connector for ODBC. The problem has been fixed and the workaround is no longer needed. The DCTEST program command line for iSeries is incorrect in chapter 1 of the Connectors and Connectivity Guide. The correct command line is specified below: RUNDOMCMD SERVER(iseries) CMD(CALL PGM(DCTEST)) BATCH(*NO). Also, DCTEST on iSeries only supports Notes and DB2. Activities yielded a writeback error when performing an Execute operation using an Oracle connection. The problem has been fixed. H) Documentation Errata The LEI installation guide topic "Starting and Running the LEI Server"contains a syntax error. On Solaris, if LEI is installed as an addin, type "load leia" to start LEI. If LEI is installed as a standalone, and not an addin, type "load leis" to start LEI. I) Troubleshooting and Additional Support For the latest LEI technical information, including Tech Notes, visit the following Web page: http://www-3.ibm.com/software/lotus/support/integration/support.html Support is also available for LEI at the following Web page: http://www-3.ibm.com/software/lotus/support/ ***************************************************************************** Under the copyright laws, neither the documentation nor the software may be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine-readable form, in whole or in part, without the prior written consent of IBM Corporation, except in the manner described in the documentation or the applicable licensing agreement governing the use of the software. Domino, Notes, IBM Lotus Enterprise Integrator for Domino (LEI), LotusScript, Lotus Connectors, and Domino Enterprise Connection Services (DECS) are trademarks of Lotus Software, IBM Software Group. AIX, DB2/2, DB2, and IBM are registered trademarks of International Business Machines Corporation. All other trademarks are held by their respective owners. Copyright IBM Corporation 1985-2005 Lotus Software, IBM Software Group One Rogers Street Cambridge, MA 02142 All Rights Reserved. *****************************************************************************