The Techie

HOW I  SET UP LOTUS DOMINO 6.5.1

 ON FEDORA/WHITE BOX/CentOS

1.    Download IBM's instructions for installing Domino from the IBM RedBook -
http://publib-b.boulder.ibm.com/Redbooks.nsf/RedpieceAbstracts/sg246835.html

2.   Get Java 1.4.2 for Linux from Sun's website - http://java.sun.com/j2se/1.4.2/download.html

3.    Get the latest compatibility libraries from Freshrpms - see Krishnan Subramanian's web page on Fedora News http://fedoranews.org/krishnan/tips/tip025.shtml

Note: I have installed Domino 6.5.1 on the nptl kernel without any problems, except occasionally the server does not start correctly when the machine does. However please note this is an upatched copy of Yarrow.

4.    Log in as root.  Install the compatibility libraries by double-clicking on the file in Gnome.  If  you are using CentOS you will find that it uses the latest libraries anyway (as does White Box with the latest updates) and works fine if you carry out the other instructions on this page.

5.    Install Java by double-clicking on the file in Gnome and then double-clicking on the extracted file.

6.    Create Notes user and group -  home directory for notes user should be set to /local/notesdata

7.    Ensure that Apache and Sendmail are stopped and disabled - they start by default in a server installation of RedHat.  They will conflict with Domino and the webserver and SMTP will not work.

7.    Still logged in as root, install Domino according to the instructions in the RedBook: the program directory should be /opt/lotus/bin and the data directory /local/notesdata.

7.    Log in as the notes user, open a text editor and type the following:

export PATH=$PATH:/opt/lotus/bin:/./:/local/notesdata
export LD_ASSUME_KERNEL=2.2.5

Save the file in notes' home directory (/local/notesdata if you have set it as above) as .bash_profile.

Log out and in again.

8.    Logged in as the notes user, in a terminal, type /opt/lotus/bin/server and the server should run.  Let it configure itself.  When it has finished, stop it and then type in a terminal: 

server -jc &

This should start the server in the Java Console.

Enjoy!

9.    When you have had enough, stop the server.  Next, download Mike Glanders RedHat 9 script from Double 6 http://www.double6.co.uk   Check that it matches your system setup - you will have to change $DOM_HOME to /local/notesdata if you have installed as above.

10.    Log in as root.  Copy the script into /etc/init.d.  Check the permissions are 755 and make it executable: chmod a+x domino.

11.    In a terminal type chkconfig - -add domino. Now call up Server Settings/Services from the Gnome menu. You should find domino listed as a service with a tick against it, but it will say "server is stopped".

12.    Reboot the machine.  Watch the system messages, and domino should be seen to load towards the end.  If so, congratulations!  You have set up your server correctly.  Log in as any user, and in a terminal type su - notes (or whatever you have called your notes user) and then the password.  Then type jconsole and the Java Console will load.  Connect to your server using the Administrator name and password you created during setup - or click on the picture of a computer at top left, this connects to the "local server".

13.    The rest is yours to do.  Have fun!

Note: It is also a good idea to increase the number of file handles available to Domino.  See page 3 for instructions on how to do this.


Here, a Word of Dire Warning: This information applies only to Domino 6.5.1. DO NOT INSTALL DOMINO 6.5.3 ON A FULLY UPDATED WHITE BOX LINUX RESPIN 1 SYSTEM (January 2005 updates).  It will not run, but will fail with a Fatal Error.  I have not been able to find a way around this.  At present, it seems 6.5.1 will run on such a system - given the above "tweaks". 

However, Domino 6.5.4 installed and ran happily on White Box Respin 2.

My thanks to those people who put their instructions on the web, especially the following:

Krishnan Subramanian 

Double 6 

Tom Davis of Notes Re-Engineering Ltd for his help in setting up

IBM Technical Support (excellent!)

Our current support team - DGA and many others

Domino on White Box Linux - Live Console on Win98SE


Elizabeth Sangster

Linux Counter

February 2006
For Pitfalls, go to page 2
For Domino 7 on White Box Linux 4.0 (Manifestdestiny), go to page 3
For Domino 9 on CentOS 6 go to page 4