HCL Notes and Domino wiki: Lotus Domino: Starting and Stopping Domino -with- the Server OS automatically with systemd

Starting and Stopping Domino -with- the Server OS automatically with systemd

Added by ~Ted Nonhipigenakol | Edited by ~Ted Nonhipigenakol on December 28, 2014 | Version 8

Actions ▼

When you install IBM Domino in xLinux, there are no start scripts nor integration with sysvinit or systemd. And even if you use one of the scripts that are available out there, systemd will crash Domino and the databases need recovery upon restart unless you set it up properly.

Tags: startup, systemd

The scripts that I am aware of for startup and shutdown of Domino are here (in order of increasing usefulness):

1. http://www-01.ibm.com/support/docview.wss?uid=swg21201435

2. http://www-01.ibm.com/support/docview.wss?uid=swg21179847

3. http://www.nashcom.de/nshweb/pages/startscript.htm

These have worked wonderfully over the years, but in RHEL 7 there has arisen a new problem. The sysvinit system has been replaced with systemd.

"No worries!" they claim. "Backwards compatibility" and all that. Right. The problem is, even if you install one of these scripts properly with chkconfig, systemd will NOT shut down Domino gracefully, but kill it and its child processes on shutdown or reboot. This means you're going through recovery and consistency checks after every server shutdown or reboot unless you remember to manually stop domino with "service domino stop" or "systemctl stop domino".

The solution is to set up a proper systemd service unit file and enable it. Since the nashcom scripts are the most useful in my view, I've included them in my example. However, you can use whatever script you want. The true issue here is that your script will NOT be used to shut down Domino unless you set up the directives right in your systemd service unit file. The most important directives are "KillMode=process" and "RemainAfterExit=yes":

[Unit]

Description=IBM Domino Server

Documentation=http://www-947.ibm.com/support/entry/portal/product/lotus/ibm_notes

After=syslog.target network.target

[Service]

Type=simple

User=notes

LimitNOFILE=60000

ExecStart=/opt/ibm/domino/bin/domino_script start

ExecStop=/opt/ibm/domino/bin/domino_script stop

TimeoutSec=300

KillMode=process

RemainAfterExit=yes

[Install]

WantedBy=multi-user.target

NOTE: The LimitNOTFILE=60000 is where the ulimit goes now- it doesn't reside in your startup script as stated in IBM Technote 1221870.

In RHEL 7 or CentOS 7, this file should reside in /etc/systemd/system, for example /etc/systemd/system/domino.service

Enable your new service:

systemctl enable domino.service

Now, Domino will be properly shut down with the OS instead of SIGINT'd and you can start and stop Domino with "systemctl start domino" and "systemctl stop domino" respectively.