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.

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