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

Domino Start Script New Version 3.1.0

Daniel Nashed  11 February 2016 15:26:10

As already mentioned at IBM ConnectED last week, I am working on a new version of my start script.

Most of the new functionality has been build in because I found it useful for the customer environments I am working in.

On top of the new functionality I added a new script "rc_all" that can start, stop, cleanup, diag ... all partitions a the same time.
The new rc_all script is a separate script that will search for your Domino partition rc-scripts and is mainly interesting when you run Linux machines with multiple partitions.

The new version of the start script has a couple of other additions which could be quite helpful.

You can edit the notes.ini with a simple"ini" command or show current notes.ini setting.
"lastlog" shows you the last log lines from the output log which could be input for a grep command.
By default the last 100 lines but you can specify an optional the number of lines.

The new version can also enable/disable/check the rc-service with the "service" command.

For diagnostics I added the "stacks" command which will quickly just dumps the call-stacks without other NSD functionality (less overhead).


The biggest change is the cleanup of the log files. You can now specify how long logs are stored and the logs are removed when you use the "clearlog" command
or when you enable the log clear functionality at startup in the configuration.

There are a couple of options and I also added some functionality for clearing temporary files at startup.

I have also added more functionality for the system database compact (you can leverage DBMT and there are separate other options) and also a separate log.nsf compact is available.

One of my customers also requested that the log.nsf can be renamed on startup.
I have added a new feature to move the log.nsf with a different name to a backup directory on startup after n days (this avoids creating a new database on every short term startup).

All functionality is completely customizable. There are settings for each of the commands.

I would be very interested to get your feedback about the new commands and options and before I release it, I would like to send it to some admins for beta testing.

If you are interested, feel free to drop me a short mail and I will send you the current state of the start script.
I am using it in customer environments and on my servers already in production.

But I still want to get some feedback before I release it. Documentation is already updated.

Here is the complete extract of what is new in this release.

I hope you like the new functionality

Daniel


--------------
Change History
--------------

V3.1.0 20.01.2016

New Features
------------

New command "clearlog"
Clears logs, custom logs and log backups as configured.
Optionally you can specify custom log cleanup days with two additional parameters.
First parameter defines log cut-off days for logs and second parameter defines cut-off days for backup logs.

New command "version" shows version of start script

New command "inivar" displays notes.ini setting specified

New command "ini" to edit the notes.ini of the server

New command "lastlog" shows last log lines. by default 100 lines are displayed.
Optionally you can specify the number of log lines

New command "service" for Linux enables/disables the Domino server "service".
Works for rc-systems and also systemd. Allows to check, enable, disable the service.

New command "stacks" runs NSD stacks only

New option for command "archivelog"

- additional parameter to specify an additional string to add to the archive log file name


New Parameters to enable new features

DOMINO_LOG_CLEAR_DAYS
Number of days until logs are cleared

DOMINO_LOG_BACKUP_CLEAR_DAYS
Number of days until backup logs are cleared

DOMINO_CUSTOM_LOG_CLEAR_SCRIPT
Custom log clear script will be used instead of the standard log clear operations and replaces all other clear operations!


DOMINO_COMPACT_TASK
Compact task can now be specified. By default "compact" is used.
Another option would be to use "dbmt" in Domino 9.

DOMINO_LOG_COMPACT_OPTIONS
Log compact options

DOMINO_LOG_START_COMPACT_OPTIONS="-C log.nsf"
Start log compact options


DOMINO_LOG_DB_DAYS
Rename log database on startup after n days

DOMINO_LOG_DB_BACKUP_DIR
Target directory for rename log database on startup / default "log_backup" in data dir

Moving the log.nsf will be executed before starting the server and after startup compact/fixup operations
You can specify a directory inside or outside the Domino data directory


EDIT_COMMAND
------------

Option for the new "ini" command for changing the editor.


REMOVE_COMMAND_TEMP
-------------------
New option to specidy a different command for removing old tempfiles on startup (default: "rm -f")


REMOVE_COMMAND_CLEANUP

New option to specify a different command for removing expired log files (default: "rm -f")


Changes
-------

DOMINO_REMOVE_TEMPFILES
The script only deletes *TMP files in data directory which are at least 1 day old to ensure no important files are deleted.


The "nsd" command by default will generate a NSD with memcheck -- full nsd
"fullnsd" command is removed from documentation but can still be used.
"nsdnomem" is now used to generate a NSD without memcheck.


Problems Solved
---------------
When checking resources (shared mem, MQs, Semaphores) the ipcs command in combination with grep is used to check the resources for a certain partition/user.
The ipcs command does not allow to specify a user-name. The was a potential issue whe the login user-names where sub-strngs of each other.
Exampple "notes" and "notes1".  Even this is fixed it is still recommended to ensure that login names are not sub-strings of reach other.
Comments

1Ray Bilyk  11.02.2016 17:46:04  Domino Start Script New Version 3.1.0

I'm sorry that I missed you at IBM Connect 2016.

Thank you once again for this incredible script! It is a lifesaver time and time again!!!

Cheers!

2Thales  07.03.2016 14:29:55  Domino Start Script New Version 3.1.0

Hello,

I need the script for my Test Domino Server R.9.0.1.

Can you sent pls ?

many thanks

3John Willemse  15.03.2016 16:47:36  Domino Start Script New Version 3.1.0

Nice work. I will start testing soon. Please provide the new download link for CentOS 7.

4Michael Knost  06.04.2016 21:45:50  Domino Start Script New Version 3.1.0

Great blog and very helpful informations...

Can you sent me your startscript pls? We have updated from domino 7 to 9 and I think this can be very useful.

many thanks

Michael

5Lonnie Huffaker  28.04.2016 0:03:52  Domino Start Script New Version 3.1.0

Can I get a copy of the 3.1.0 script getting ready to put up another server and would like to try the new script

6Markus Schmuck  24.05.2016 17:26:26  Domino Start Script New Version 3.1.0

Hello Daniel,

can you please send me the current version of the start script?

many thanks, Markus

7Daniel Nashed  24.05.2016 18:23:42  Domino Start Script New Version 3.1.0

@Martin, the new version is releases. you can request it here

-> http://www.nashcom.de/nshweb/pages/startscript.htm

8Oleg  17.11.2016 14:18:39  Domino Start Script New Version 3.1.0

Hello Daniel,

can you please send me the current version of the start script?

many thanks, Oleg

9Daniel Nashed  20.11.2016 11:34:27  Domino Start Script New Version 3.1.0

you can request the script here --> https://www.nashcom.de/nshweb/pages/startscript.htm


  • [IBM Lotus Domino]
  • [Domino on Linux]
  • [Nash!Com]
  • [Daniel Nashed]