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

alt

Daniel Nashed

New Start Script version 3.2.2 with a Tika Stop server work-around

Daniel Nashed – 14 June 2019 04:39:09

There are a couple of new features to the start script and fixed one issue with restartcompact for systemd.
And there is also an addition for the Docker environment. I have a separate blog post about the current Tika issues -->
http://blog.nashcom.de/nashcomblog.nsf/dx/domino-10-attachment-indexing-with-apache-tika.htm

There is shutdown control I added into the start script, because the external Java process does currently not terminate.

By default without any config parameter the shutdown check will be 30 seconds.
The default in the config in the configuration file is 20 seconds. So if you don't deploy the new config settings, the script will wait 10 seconds longer before killing the Tika process.


Beside that hard coded logic for the Tika process, I added another delayed shutdown command that is invoked during the shutdown after some time.

And there is also a new tika process stop/kill command, which I added.


When you kill the tika server process, it will be restarted when the next process tries to index an attachment.


The new version is available by mail request (-->
http://www.nashcom.de/nshweb/pages/startscript.htm).

I am still planning for the next major release. It might not have many new features but will have changed default locations (probably /opt/nashcom), maybe will move to github (not sure because than I am loosing a bit of control but make the feedback process and download easier).

And I might move to a new documentation format. So probably the documentation will be online only in MD format. Still experimenting in converting MD files back to txt.

Also I sort of like the old text file better than the new MD format for the purpose of the start script documentation. Maybe I will just bring it up in two formats and get feedback.


-- Daniel


New Features


New Commands:


"systemlog" shows the last log lines from systemd service.

This is helpful to see output of the start script.



"tika" stop|kill


Shows the Tika server status and can be used to terminate the process.


Without additional parameters this command shows the status of the Tiker server process.

tika stop --> stops the process.

tik kill  --> kills the process.


Added "locale" output to server start logging.

This can help to troubleshoot issues with locale setting on your server.



New configuration options:



DOMINO_TIKA_SHUTDOWN_TERM_SECONDS


Tries to shutdown the Tika index server during shutdown.

IT happens that the Tika server does not terminate, which prevents the Domino server from shutting down properly.

Default 30 seconds.


DOMINO_SHUTDOWN_DELAYED_SCRIPT


Script which can be executed delayed during shutdown.

DOMINO_SHUTDOWN_DELAYED_SECONDS
specifies the number of seconds after shutdown start.


DOMINO_SHUTDOWN_DELAYED_SECONDS
(default 20 seconds)


Shutdown Delay for delayed shutdown command.

Default is 20 seconds if script is defined.


Docker Support:


Now the entry point script checks if the script is already started with the right user and will not switch to the user.

There are configuration options on the Docker side to run the entry point script directly with the right user.

When you switch the user to "notes" at the end of your dockerfile, the container is started with "notes".

This provides better security.


Problems Solved


restartcompact and restartfixup did not work correctly with systemd.

For systemd the rc_domino script needs to stop the service run compact/fixup and restart the service.

Links

    Archives


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