DeskTux

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
<WRAP round alert>
The content of this page is no longer maintained and could be outdated soon or already is. The reasons could be various, like this information became obsolete or there is by now a better way to handle the information on this page. This page will be retained here for archiving reasons.
</WRAP>

====== Domino ======

[[http://www.ibm.com/lotus/domino|Lotus Domino]] (actually by now it is from [[http://www.ibm.com/|IBM]]) is the server-platform for [[http://www.ibm.com/lotus|Lotus]] [[archive:notes]].

===== rc-script =====
You can use the domino rc-script to start and stop your Domino-server (any version). Make sure to adapt the variables to your installation, the default values are based on a default Domino installation!

Please note that all Domino-output is redirected to the non-interactive console TTY12. So when you run Domino for the first time (i.e. when it asks for input) you need to run it manually on an interactive console!

==== Features and changes ====
  * Added init information as a preparation to make the script fully [[http://refspecs.freestandards.org/LSB_3.1.0/LSB-Core-generic/LSB-Core-generic/tocsysinit.html|LSB 3.1]] compliant.\\ For the script to be 100% LSB 3.1 compliant, only the action "status" needs to be added.
  * Some minor updates (language support etc).
  * I added a function "kill" to kill domino if "stop" doesn't work. In which case nsd will also write a logfile.
  * A function "restart" has been added as well, in case you need to restart Domino for e.g. a configuration change.
  * The script now also works better with Domino 7 and newer, and I added lots of commentary to clarify things.
  * An addition, concerning language settings when encountering problems with language-specific characters, has also been made. Thanks to Giorgio Fedon for pointing out the problem!
  * [[http://www.danilodellaquila.com/|Danilo Dellaquila]] asked about the license for this script. Well, it's just a script... please consider it licensed under the [[http://www.gnu.org/licenses/gpl-2.0.txt|GPLv2]].

==== Download and installation ====
Just extract the file below, copy the file ''domino'' to ''/etc/init.d/'' (depending on your distribution) and run the script:

  /etc/init.d/domino {start|stop|restart|kill|help}

On Debian I recommend running this command:

  update-rc.d domino defaults 99 01

Or, more recently:

  insserv -v domino

<WRAP download>
{{wiki:domino-rc.tar.gz|}}\\
Size: 2,2 kB
</WRAP>

===== Remote Setup =====
A default Domino (6.x or newer) configuration needs a running X. But sometimes you don't want X on a productive server. Fortunately there is a way to configure Domino without X (at least without X on the server).
You can run the following stepd on a Linux workstation with a running X and Java Runtime installed.

  - Run the command ''/opt/lotus/bin/server -listen'' (on a default installation) as the notes-user.
  - Copy the following files from the server directory ''/opt/lotus/notes/latest/linux/'' to a temporary directory on your workstation:
    * cfgdomserver.jar
    * jhall.jar
    * remotesetup
  - Run the script ''remotesetup'' and configure your server remotely.

Please note that this does not work from/on a Windows workstation!
This information can also be found in the written Lotus Domino installation guide. But the internet is easier to search, isn't it? ;-)

===== Tuning =====
Domino can open a significant number of files and processes---especially in large environments or with certain applications. On Debian the default limit for the number of open files is 1024 which just isn't enough.

To increase this limit and prevent unexplainable crashes and hours of NSD file analyses you should add this to the end of your ''/etc/security/limits.conf'':
<code bash>
# Tuning for Domino
notes	soft	nofile	49152
notes	hard	nofile	49152
notes	soft	nproc	12500
notes	hard	nproc	12500
</code>

If you run your Domino server as another user than the notes-user you must enter the correct username of course.

These are the recommendations from IBM, unfortunately I don't have a link available.

===== Lotus Domino 9.x =====
I have tested this only on Wheezy, but there are no noteworthy problems with Domino 9. Everything runs fine out of the box.

===== Lotus Domino 8.5.x =====
Okay, this info is for Debian Lenny or later only. Just as Domino 8.0.x this version won't install on Etch.

The installation of Domino 8.5 on Lenny runs smoothly out of the box. Just do a minimum netinst (only "Base System" selected in tasksel), go ahead and install Domino straight away. No installation of different libstdc++ versions anymore, no linking of gawk, nothing. It works just fine!

===== Lotus Domino 8.0.x =====
I couldn't get Domino 8 to run on Debian Etch. The installer won't do what I want it to; I suspect it's a library version problem.

By now I've got a grip on Domino 8.0.2 and test-installed it on Debian Lenny. This works like a charm, so I think the libraries must, indeed, have been the problem. And the installation is quite straight-forward too. As far as I can see, nothing at all to worry about! Just run the install and be happy!

When you do an upgrade from 7.x you may have to move the old program directory out of the way (on default install ''/opt/ibm'') for the upgrade to work correctly. The upgrade process itself goes fine, but when starting Domino it still calls itself 7.x (although a design upgrade is being carried out anyway). Moving the program directory out of the way prevents this problem.

===== Lotus Domino 7.x =====
Good news everybody! Somehow I get the impression that IBM did a really good job on Domino 7. It seems more bug-fixed and even faster as well!

The installation (on Debian Sarge and Etch) is exactly the same as [[Domino#Lotus_Domino_6.x|Domino 6.x]] except for the fact that you don't need to manually install the correct C++ library. The default pre-installed one will do just fine. The only library which needs to be installed is libstdc++5 (apt-gettable in Sarge and Etch). Also you should make sure to install gawk and eventually remove or re-configure your local MTA or other daemons which could collide with Domino.

With Debian there are a few things to take care of, though.

==== Possible error messages ====
**<nowiki>This linux kernel does not have the required epoll I/O readiness notification facility. Listener task exited: Failed to create an IOCP port</nowiki>**\\
Use kernel 2.6! If you really want to use Kernel 2.4 you will need to re-compile your own kernel with the "epoll" option enabled (CONFIG_EPOLL=y).

[[http://www.muddle.de/|Muddle]] reported that CONFIG_EPOLL is not supported by the vanilla kernel 2.4. It seems the Debian maintainers applied a [[http://www.xmailserver.org/linux-patches/nio-improve.html|patch]] to the stock-kernels so CONFIG_EPOLL is supported. Obviously, if you wish to run a vanilla [[http://www.kernel.org|kernel]] 2.4 you must apply that [[http://www.xmailserver.org/linux-patches/nio-improve.html|patch]] to get the EPOLL function into the kernel.

**On the //Console:// <nowiki>Please edit your shell's DISPLAY environment variable to reflect an unlocked terminal that you would like to launch the Domino Setup Program on.</nowiki>**\\
**In //setuplog.txt:// <nowiki>/opt/lotus/notes/70000/linux/jvm/bin/libfontmanager.so: libstdc++-libc6.2-2.so.3: cannot open shared object file: No such file or directory.</nowiki>**\\
If you do not run the Server Setup remotely but wish to do that locally through an X server you should install the package "libstdc++2.10-glibc2.2". It's apt-gettable in Sarge and Etch. You can also manually download it from the [[http://archive.debian.net/woody/libstdc++2.10-glibc2.2|Debian servers]].

The server itself will run just fine without it.

**<nowiki>/opt/lotus/notes/latest/linux/nsd.sh: line 1: /bin/gawk: No such file or directory</nowiki>**\\
You should link ''/usr/bin/gawk'' to ''/bin/gawk'', otherwise the error above will occur on server start:

  # ln -s /usr/bin/gawk /bin

===== Lotus Domino 6.x =====
Basically the installation of Domino 6.x is the same as [[Domino#Lotus_Domino_5.x|Domino 5.x]]. Basically...

For these versions it is not sufficient to just link ''libstdc++-libc6.1-1.so.2'' to the existing version, you have to install the correct version. It is included in the package ''libstdc++2.9-glibc2.1''. You can download it from the [[http://archive.debian.net/woody/i386/libstdc++2.9-glibc2.1/download|Debian archives]]\\
If you just link the existing file, Domino will segfault.

==== Possible obstacles ====
  * If you are upgrading from Domino 5.x you need to remove the symlink ''/opt/lotus/notes/latest'' (default installation) before the upgrade. Otherwise the upgrade will not work!
  * On some pages you will be told to install the latest IBM Java to get Domino working. This is not true! Domino is shipped with a working IBM Java and it is installed by default. People may have gotten confused because the error message you get if you didn't install the correct libstdc++ comes from the JVM.

===== Lotus Domino 5.x =====
Running Lotus Domino 5.x on Debian GNU/Linux Sarge is quite easy.
Just run the installation as stated in the installation manual on a minimal Debian installation (Netinstall with Debian Base should be sufficient) and follow these steps before running Domino for the first time:

  - Change to the directory ''/usr/lib'': <code># cd /usr/lib</code>
  - Link ''libstdc++-libc6.1-1.so.2'' to ''libstdc++-3-libc6.2-2-2.10.0.so'': <code># ln -s libstdc++-3-libc6.2-2-2.10.0.so libstdc++-libc6.1-1.so.2</code>

Run Domino and be happy!