Domino on Linux/Unix, Troubleshooting, Best Practices, Tips and more ...


Daniel Nashed

Domino Start Script 2.7 Released

Daniel Nashed – 11 September 2013 08:28:53

Today I updated my start script to version 2.7. Version 2.6 never really made it to the request page.
I have sent it to a couple of customers by email but I did not post it because I was still waiting for feedback for version 2.6.
There are not really many changes and additions. Most of the changes and additions are coming from my customer projects.
I am adding functionality based on what customers need. If you have special requirements please let me know by mail.
What I am always trying is to add functionality in a generic way to ensure they are helpful for many customers.
For example I have introduced a way to plug in your own scripts in all different events (pre shutdown, post shutdown, start etc ...).

In addition I am optimizing the script to work more clean in some edge situations. Like invoking a shutdown command when the server is not running.

I have documented the changes in the readme.

If there is anything special that you want to do with your start scripts that is not there yet, feel free to contact me by mail.
In most cases it can be implemented in a generic way that helps more customers and I would add it to the standard script.

You can request the new version of the script here -->

-- Daniel

V2.7 01.09.2013

New Features

New Option DOMINO_3RD_PARTY_BIN_DIRS to allow "cleanup" to kill processes started from 3rd Party directories

When you try to shutdown a Domino server the script checks now if the server is started at all before inititiating the shutdown.
In previous versions this took a longer time because the loop for termination check was invoked anyway.
Also pre-shutdown scripts have been invoked which lead to a delay.
The script also skips post_shudown operations in this case.
You will see a message on the console that shutdown is skipped because the server is not started.
This will improve shutdown performance when the server was not started.

V2.6 03.01.2013

New Features

New Option DOMINO_PRE_KILL_SCRIPT to allow invoking a script before "nsd -kill"
New Option DOMINO_POST_KILL_SCRIPT to allow invoking a script after "nsd -kill"

New Option DOMINO_PRE_CLEANUP_SCRIPT to allow invoking a script before cleaning up server resources native on OS level
New Option DOMINO_POST_CLEANUP_SCRIPT to allow invoking a script after cleaning up server resources native on OS level

Added Debug Output (BEGIN/END) for all pre/post scripts

1Matteo Bisi  18.09.2013 15:12:21  Domino Start Script 2.7 Released

Thanks for share !!

I'm use your domino start script on linux and i think you have made a very nice job.

Thanks again


2Shrinivas  16.10.2013 14:25:50  Domino Start Script 2.7 Released


If the server is started using jconsole, using your script we cant access server console.

Normally we can use "<server name> monitor" to view the live console.

How do we access live console on AIX if the server is started using java Controller options.

Appreciate your response.


3Daniel Nashed  17.10.2013 7:41:16  Domino Start Script 2.7 Released

if you use the server controller there is no way to use the -monitor option.

the issue behind this is that there are no normal log files any more and the server is controlled by the server controller.

the script is starting the server controller which starts the server. at this point you should use the Java based Domino Console that interacts with the Server Controller.

the idea behind -monitor is to have a low-level console that always works. if you enable the Server Controller you have already a low-level way to communicate with your server.

All the logs are now written by the Server controller and there is no need to redirect output from the server process.

If you have questions about it and want to go thru details feel free to drop me an email.

-- Daniel

4Shrinivas  17.10.2013 8:03:18  Domino Start Script 2.7 Released

Thanks for response,

Its my pleasure to interact with you.

The concern with using Domino Java controller is when is server is in hang state or busy not acceptig client request we cannot take the console.

The benefit of using -monitor is we could take console at any stage and see whats happening on server.

With QOS to implement we need to start server with Java controller option and that is where the -monitor does not work.

Not sure if you have an alternative way to tackle this conditions.


5Daniel Nashed  17.10.2013 8:12:45  Domino Start Script 2.7 Released

the controller should be able to work with the server in the same way than the -monitor command.

when the server hangs the server controller should still receive log output.

the controller should do exactly what the -montor command does.

did you have cases where this did not work?

-- Daniel



    • [HCL Domino]
    • [Domino on Linux]
    • [Nash!Com]
    • [Daniel Nashed]