Automatically starting LEI on UNIX

Craig Lemelin, Presented by Lotus Software, IBM Corporation

Craig Lemelin is a contributor to the Lotus Developer Domain. LDD is the premier technical Web site for Lotus software products.

Summary: Domino 4.6 Startup Scripts gave UNIX platforms the ability to start up Lotus Enterprise Integrator (LEI> at boot-up, a capability heretofore found only on the Windows platform. Information on Startup Scripts can be found in IBM Redbooks.

Tag this!

Date: 01 Apr 2003
Level: Introductory
Activity: 823 views

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:

Copy the Startup Scripts from the LEI6 install kit to their respective locations:
Platform Location
RS/6000 /etc/rc.d/autolei.a
Sun Solaris /etc/rc2.d/autolei.s

Platform	Location
RS/6000	/etc/rc.d/autolei.a
Sun Solaris	/etc/rc2.d/autolei.s

After copying the files, create symbolic links. Enter the following commands at the UNIX console:


Platform	Command
RS/6000	-s /etc/rc.d/autolei.a /etc/rc.d/rc2.d/S90lei -s /etc/rc.d/autolei.a /etc/rc.d/rc2.d/K90lei
Sun Solaris	-s /etc/init.d/autolei.s /etc/rc2.d/S90lei -s /etc/init.d/autolei.s /etc/rc2.d/K90lei

Prior to starting the UNIX machine, make sure that the script file and symbolic links have the correct file and execute permissions assigned to them.

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:

Platform	Command
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.

About the author

Craig Lemelin is a contributor to the Lotus Developer Domain. LDD is the premier technical Web site for Lotus software products.

Comments (Undergoing maintenance)

Trademarks | My developerWorks terms and conditions

Close [x]

Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Close [x]

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/

SITE_ID=1

Zone=Lotus

ArticleID=12777

ArticleTitle=Automatically starting LEI on UNIX

publish-date=04012003

author1-email=

author1-email-cc=