HOWTO: Install Lotus Domino 7.0.2 on Ubuntu 8.0.4

This minimalistic guide shows how to install Domino 7.0.2 on Ubuntu 8.0.4 server or workstation. I did this on Ubuntu 7, but did not write everything down, which meant learning/searching for the information once more. Please let me know if you have better ways of doing this!

Create a domino user and group


$ sudo useradd -m domino
$ sudo groupadd domino
$ sudo passwd domino

Add required libraries

Domino uses some libraries that is not installed by the standard Ubuntu installation.


$ sudo apt-get install libstdc++5
$ sudo apt-get install libxmu6
$ sudo apt-get install libxp6
$ sudo apt-get install libxp-java
$ sudo apt-get install libxtst6

Install

Unpack the installation file (my is named S7.0.2.tar) and run the linux/domino/install script as root. Use default settings (except user, enter domino), use ”Manual setup”.


$ tar -xvf S7.0.2.tar
$ cd S7.0.2/linux/domino
$ sudo install

Change ownerships on files

Since you installed as root, the files is owned by root. I guess if install was run as the domino user, this step would not be required.


$ sudo chown -R domino /local/notesdata
$ sudo chgrp -R domino /local/notesdata
$ sudo chown -R domino /opt/ibm
$ sudo chgrp -R domino /opt/ibm

Firewall

Stop your local firewall or open 1352 in the local firewall. If you are using shorewall, you can do your own Notes macro. Change the port from 80 to 1352 in the macro.Notes file.


$ sudo cp /usr/share/shorewall/macro.HTTP /usr/share/shorewall/macro.Notes
$ sudo gedit /usr/share/shorewall/macro.Notes

Add the following (depending on setup…) to /etc/shorewall/rules:


Notes/ACCEPT net $FW

Conflicting services

Stop any mail, web, ldap services, so that Domino does not conflict on ports. Remember to disable those you don’t need or disable the Domino services that you don’t need.

$ sudo /etc/init.d/postfix stop
$ sudo /etc/init.d/courier-imap stop
$ sudo /etc/init.d/courier-imap-ssl stop

Relink sh

The server script uses /bin/sh, relink sh to bash that normally links to /bin/dash.


$ sudo rm /bin/sh
$ sudo ln -s /bin/bash /bin/sh

nsd.sh

I got many ”Command not found” errors when starting the server first time. After some research, I found that the script requires gawk in sd.sh:

$ sudo apt-get install gawk

Start the server setup listener


$ su notes
$ DISPLAY=:0.0
$ export DISPLAY
$ cd /local/notesdata
$ /opt/ibm/lotus/bin/server -listen

If you want to add a server with existing IDs, put the certifier ID, the server ID and the admin ID in the notesdata directory on the server. Run the Remote Server Setup utility on a client. Usually in StartLotus ApplicationsRemote Server Setup. Configure as a normal setup.

Server startup script

To be able to start Domino on startup, restart it and shutdown when system restarts, you can download domino init.d-script and put in /etc/init.d. Restart the server to see if it works.


$ cd /etc/init.d
$ sudo wget http://johankanngard.net/wp-content/uploads/2008/07/domino
$ sudo chmod +x domino
$ sudo chown domino domino
$ sudo chgrp domino domino
$ sudo update-rc.d domino defaults
$ sudo shutdown -r now

Test

Use a Notes client and test that the server is up and running. To see if the server is running on the server, you use telnet.


$ ps a | grep server
4505 pts/0 Ss+ 0:00 su - domino -c /opt/ibm/lotus/bin/server

You can also try connecting to the server locally with telnet using:


$ telnet localhost 1352
Trying 127.0.0.1...
Connected to localhost.
Escape character is \\\\\\\'^]\\\\\\\'.

Some links of interest


Updated the startup script since the stop argument wasn’t working.