LDD Today

Tips from LDD

Automatically starting LEI on UNIX

Tip submitted by
Craig Lemelin
Level: Intermediate
Works with: Lotus Enterprise Integrator
Updated: 02-Dec-2002

As you know, on the Windows platform you can start Domino and LEI at bootup via the NT Service functionality. What you may not know is that this functionality is available for UNIX platforms via Startup Scripts. Life just got one step easier for LEI administrators!

The LEI Startup Scripts require that Domino also be autostarted via Startup Scripts. Currently, the only available examples for Domino Startup Scripts exist in two IBM Redbooks:
Everything you need to know about setting up Domino Startup Scripts is provided within these books, so we won't duplicate that information here.

There are two Startup Scripts included in the LEI6 install kit—one for the Sun Solaris platform and another for the IBM RS/6000 platform. Both Startup Scripts assume that you created an RS/6000 or Sun Solaris Notes user account and that the user’s profile is correctly set up for the operation of LEI. For more information on setting up the Notes account, refer to the LEI documentation.

Installing the Startup Scripts
After you verify that you have an existing Notes user account, follow these steps to set up your machine to use the Startup Scripts:
The UNIX operating systems calls all files alphabetically at startup. For example, if you have Domino autostarted from a script called S40Domino, make sure that the LEI Startup Script name follows the Domino Startup Script name alphabetically.

Testing your efforts
After you configure the machines, manually run the scripts to test them. With Domino already started, sign on as root and execute the following commands at the UNIX console:

PlatformCommand
RS/6000/etc/rc.d/autolei.a start
/etc/rc.d/autolei.a stop
Sun Solaris/etc/init.d/autolei.s start
/etc/init.d/autolei.s stop

After you verify that the scripts work correctly, reboot the UNIX machine. Domino starts up, and then LEI starts. There is a small delay on the LEI startup to ensure that Domino is running correctly before LEI initiates startup. To view what is running, list the processes associated with the Notes user. Both Domino and LEI processes should be listed.

Troubleshooting
If problems arise, logs are created in the /tmp directory. Check the file <leiservername>.log for any information about the problem. If the file does not exist, the Startup Script likely did not run, so there may be UNIX user rights issues.


SUBMIT YOUR TIPS!
We encourage you to send us your tips (You can also click the "Would you like to submit a tip?" graphic below.) Your tips can be anything you've discovered about any Lotus product. The most important thing is that your tip be interesting, useful, or handy. And be sure to include complete information about how your tip works. For ideas, take a look at our tip archives. If we publish your tip, we'll send you the IBM Redbooks Lotus Collection on CD.