NUMBER ZERO: Verify that all requirements in the LEI Install guide are correct. Often, even if the previous version was installed recently, entries have been removed from the Domino Server doc that have not affected the running of LEI, but will prevent the installer from running. The LEI Installer uses Domino to create the necessary database and copy documents from the old to the new. It must have the ability to do this. The Install Guide explains this.

NUMBER ZERO ZERO: LEI can use both native database clients and ODBC drivers for connectivity. These should be established on the new server before starting LEI. This is particularly critical if you are going from a 32 bit OS to a 64 bit OS. The database clients and ODBC drivers are different and in different directories. And check the LEI release notes, older versions of the clients may no longer be supported.

Please see this related article for more information: http://www-10.lotus.com/ldd/dominowiki.nsf/dx/Pre-upgrade_considerations_for_DECS_LSX_LC_LSDO_and_LEI

NOTE: If you are using the Connector for SAP you must install it again after upgrading LEI. It is not a part of the LEI Install/Upgrade program.

NOTE: The LEI Installer does both new installs and upgrades, if you have an existing installation it will detect it and perform an upgrade.

1. You might want to check the size of the leilog.nsf before beginning, if it is more than 100 MB we recommend creating a new one. To do this just remove the old one however you wish and make a new one from the leilog.ntf. The only restriction is that the name be the same.

2. Make sure that LEI has shut down and all activities were terminated successfully. The state of all LEI activities is stored in the LEI Administrator and they should all be inactive.

3. From a Notes Client open the LEI Administrator and under Actions run the RefreshAllDocuments agent. At the end it will tell you if there were errors. If there were, and there is likely to be some from an administrator that has been used for many years follow each of them to the activity and try to correct. It may be broken links to connections and/or activities that are no longer used. They are not harmful but you might want to clean them up now. Others might stem from a problem from long ago where a field was computed for display when it should have been computed. The activity works fine, but the script can not check it. If you open it and save it is fine, the value was displayed.

4.) Shut down Domino

5. Remove LEI from the Server Tasks line of the Domino notes.in.

6.) Reboot the operating system to make sure all orphaned processes are cleared out.

7.) Upgrade Domino and confirm that is successful.

8.) Make your own back up of the LEI decsadm.nsf, just in case. The LEI installer also makes a backup copy so you will have good safety margin.

9.) Now upgrade LEI.

10.) RefreshAllDocuments will run again. Look for errors and correct if necessary.

11.) Start up LEI and watch for any errors.

HINT: If you run into problems you can shut everything down again, rename the LEI decsadm.nsf and then start Domino without LEI. Make a new database with file name of decsadm.nsf from the leiadm.ntf. Open this and the original and copy the Server and Administrator Configuration documents to the new one.

This will give you a fresh, empty LEI Administrator. Start LEI again and watch for any errors. Correct if necessary.

Now set up a couple connections and a simple test activity. Does this work? If so try copying in a few activities from one of your back ups and test them. Correct any problem you encounter and then continue copying activities.

A good article with more details on upgrading:

http://www-10.lotus.com/ldd/ddwiki.nsf/dx/IBM_Lotus_Enterprise_Integrator_Best_practices_for_upgrading_