IBM Lotus Enterprise Integrator for Domino (LEI) Release 7.0.1 January 16, 2006 A) What's New in LEI Release 7.0.1 B) System Requirements C) Installation Considerations D) Installing LEI - General Instructions E) Uninstalling LEI F) Operational Considerations G) What's Been Fixed in LEI Release 7.0.1 H) Documentation Errata I) Troubleshooting and Additional Support _______________________________________________________________________________ A) What's New in LEI Release 7.0.1 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 7.0.1 is a point release to the major LEI 7.0 release. If you are new to release 7x stream, please also see the version 7.0 readme.txt file at the Lotus Documentation site http:/www.lotus.com/doc. The latest documentation set for LEI 7x can be found at http:/www.lotus.com/doc in the Enterprise Integrator product category. B) System Requirements *Hardware Requirements* - 40MB disk space on Win32 - 80MB disk space on UNIX and i5/OS - 90MB temp space on Win32 - required by i5/OS 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 is supported on the following platforms: - Windows 2000 Server and Advanced Server - Windows 2003 Server and Server Enterprise Edition - AIX 5.2 and 5.3 - Solaris 9.0 and 10 - RedHat Enterprise Linux (RHEL) 4.0 - Novell SuSE Linux Enterprise Server (SLES) 8 and 9 - i5/OS V5R3 and V5R4 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. *Software Requirements* LEI 7.0.1 requires Notes/Domino 7.0.1. - Notes 7 client to administer the LEI Administrator database and run the LEI server if LEI is installed on a Notes client - Domino 7.0.1 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* Supported Lotus Connector data driver versions are listed below. Note: DataDirect ODBC drivers can be used with the Lotus Connector for ODBC. These include the Data Direct Sybase, Oracle, Informix, DB2, and SQL Server ODBC wire protocols. LEI and DECS support the supplied Lotus- branded DataDirect ODBC driver. LEI recommends using the Lotus-branded DataDirect ODBC Wire Prototol Drivers Release 5.0. Windows 2000 Server and Advanced Server and Windows 2003 Server and Server Enterprise Edition Oracle 9i and 10g DB2 v8.1, DB2 v8.2, and DB2/400 Sybase 12.5 and 12.5.1 MS SQL Server 2000 and 2005 Data Direct ODBC 5.0 AIX 5.2 and 5.3 Oracle 9i and 10g DB2 v8.1, DB2 v8.2, and DB2/400 Sybase 12.5 and 12.5.1 Data Direct ODBC 5.0 Solaris 9.0, 10 Oracle 9i and 10g DB2 v8.1, DB2 v8.2, and DB2/400 Sybase 12.5 and 12.5.1 Data Direct ODBC 5.0 RedHat Enterprise Linux (RHEL) 4.0 and Novell SuSE Linux Enterprise Server (SLES) 8 and 9 Oracle 9i and 10g DB2 v8.1, DB2 v8.2, and DB2/400 Data Direct ODBC 5.0 i5/OS V5R3 and V5R4 DB2/400 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: ndctest Issue the following command for UNIX: dctest Issue the following command for i5/OS: RUNDOMCMD SERVER(your_dom_server) CMD(CALL PGM(QDOMINOxxx/DCTEST)) BATCH(*NO) where xxx is the Domino release (650 for Domino 6.50 or 603 for Domino 6.0.3) A command window help menu provides information for using the connectivity test program. C) Installation 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 complete LEI installation instructions. See below for related considerations. Installation Considerations - When installing LEI as an NT service for use with a local Domino server or a local Notes client, be sure that the service starts with the same NT login credentials as Domino. For both cases set the following notes.ini parameter as specified below: EIUseOSMemory=1 - The user ID of the user who is installing LEI must be resident in the Domino Directory group LocalDomainAdmins or the LEI installation will fail. - The Domino server must be running during LEI installation. For the UNIX platforms, the installer does not error out if Domino is not running. You must verify that the Domino server is running before installing LEI. - DECS, if installed, must not be running during LEI installation. - The LEI installation utility does not inform you that you must make changes to your Domino Directory in order to support the server-side browsing method used by LEI. See the LEI Installation Guide (leiig.nsf) for details. - The LEI server must be installed on a machine where a Notes client or a Domino server is installed. Only one LEI server can be installed on any single non-partitioned machine. On a partitioned machine, an LEI server can be installed on each partition. The LEI server version and the Notes/Domino version must match, for example Domino 7.0.1 with LEI 7.0.1. - On UNIX, do not use the following characters in an LEI server name: ", ', &, ;, :, / D) Installing LEI - General Instructions The LEI install process is explained fully in the IBM Lotus Enterprise Integrator for Domino (LEI) Installation Guide (leiig.nsf) supplied with this release and at http://www.lotus.com/doc. 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 variable 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 prompting for password, ensure that your Notes client is running during LEI install. E) Uninstalling LEI The LEI uninstall process is documented in the IBM Lotus Enterprise Integrator for Domino (LEI) Installation Guide (leiig.nsf) supplied with this release and also available at the Lotus Documentation site (http://www.lotus.com/doc). F) Operational Considerations Current 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 (lsxlc.nsf) and Lotus Connectors and Connectivity Guide (lccon.nsf) are supplied with Domino, not LEI. You can also obtain these guides at the Lotus Documentation site (http://www.lotus.com/doc) for this release. For the latest information about the i5/OS platform, visit the http://www-1.ibm.com/servers/eserver Web site: For the latest information about Enterprise Integration offerings, visit the http://www.lotus.com/ei Web site. G) What's Been Fixed in LEI Release 7.0.1 The following issues have been resolved and may be expanded upon in the fixlist database at http://www.lotus.com/ldd/r5fixlist.nsf. General: -- On UNIX, the LEI readmefirst.txt file, which directs the user to the current readme file, is not functional. Connectors: -- Using an activity in which rich text fields in the source are mapped to CLOB fields in the target causes unnecessary updates. -- Empty text strings do not transfer to an Oracle target as NULLs. Virtual activities: -- A limit to the number of activity threads that can be running simultaneously causes a functional limitation to how many virtual activities can be run. -- When using virtual activities, all the servers in a cluster except the first, do not put the activity in the configuration document. -- If multiple Virtual Fields activities are defined on the same form, and the second activity (based on the monitor order) uses multivalue handling, then the second activity fails on an Update with the following error message: Monitor failure -- Error: Field count mismatch -- Field count mismatch problems occur when running a Virtual Fields activity a between Domino database source and SQL Server table target. -- Virtual documents do not appear in a Notes view if one or more keys in the external key table are blank. The missing values are not NULL, but blank. -- Virtual activities cannot map NULL datetime fields in a Notes source to the default fields in a DB2/400 target. -- If Update event and Open event are heavily invoked, virtual activities intermittently hang. This is because the unread count code takes a shortcut within Domino where it does not lock the database as it should. Data management activities: -- When the Timestamp Replication activity using the Order metaconnector is executed, an "Error: Update at Connector B affected ..." occurs. -- Running a Direct Transfer activity on i5/OS using a Notes or DB2 source with an ODBC Connector target of DataDirect DSN for the Oracle Wire Protocol Driver and metadata as a stored procedure, fails when using 10 or more input parameters. -- Running NDCTEST on a Windows platform for an OLE DB connection yields an application error and does not complete successfully. -- Running a Replication activity with the timestamp option on a UNIX platform does not update the activity SrcTimeStamp and DestTimeStamp properties. -- When using the Order metaconnector in a Replication activity from Notes to DB2/400, certain German characters display incorrectly in the DB2/400 target. This may also occur when using the LCConnection class in LotusScript. -- The Order metaconnector does not differentiate between uppercase and lowercase characters. -- Calls from an ODBC Connector to a stored procedure are limited to 10 input characters. -- The Direct Transfer activity does not support output parameters if DATE or TIME only value options are enabled. -- Scheduling an activity with the "Run at Times" option only runs the activity every other time instance specified. -- Timestamp replication fails if order is used with a Notes source. H) Documentation Errata -- The kitted LEI Installation Guide and Connectors and Connectivity Guide contain operating system and connectors database versioning errors. The correct operating system versions are listed in Section B of this readme. 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 ***************************************************************************** THE INFORMATION CONTAINED IN THIS DOCUMENTATION IS PROVIDED FOR INFORMATIONAL PURPOSES ONLY. WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATION CONTAINED IN THIS DOCUMENTATION, IT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN ADDITION, THIS INFORMATION IS BASED ON IBM’S CURRENT PRODUCT PLANS AND STRATEGY, WHICH ARE SUBJECT TO CHANGE BY IBM WITHOUT NOTICE. IBM SHALL NOT BE RESPONSIBLE FOR ANY DAMAGES ARISING OUT OF THE USE OF, OR OTHERWISE RELATED TO, THIS DOCUMENTATION OR ANY OTHER DOCUMENTATION. NOTHING CONTAINED IN THIS DOCUMENTATION IS INTENDED TO, NOR SHALL HAVE THE EFFECT OF, CREATING ANY WARRANTIES OR REPRESENTATIONS FROM IBM (OR ITS SUPPLIERS OR LICENSORS), OR ALTERING THE TERMS AND CONDITIONS OF THE APPLICABLE LICENSE AGREEMENT GOVERNING THE USE OF IBM SOFTWARE. Licensed Materials - Property of IBM ©Copyright IBM Corporation 1987, 2006 All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GS ADP Schedule Contract with IBM Corp. Lotus Software IBM Software Group One Rogers Street Cambridge, MA 02142 IBM, the IBM logo, AIX, Domino, Freelance, Freelance Graphics, iSeries, i5/OS, Lotus, Lotus Notes, LotusScript, Notes, 1-2-3, OS/400, Quickplace, S/390, Sametime, SmartSuite, WebSphere, Workplace, Workplace Managed Client, z/OS, and zSeries Client are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Additional IBM copyright information can be found at: http://www.ibm.com/legal/copytrade.shtml Intel and Pentium are trademarks of Intel Corporation in the United States, other countries, or both. Microsoft, Windows, and the Windows logo are registered trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others. Portions Copyright © 1996 Granite Software, Inc., adapted from ZMerge Power Tool(TM) for Lotus Notes. *****************************************************************************