Start Script commands provide the functionality of the start script.
Refer to the parameter configuration for customization.
Starts the Domino server and archives the last OS-level Domino output-file.
The output-file is renamed with a time-stamp and compressed using the configured compression tool.
Compressing the log file is invoked in background to avoid slowing down the server start when compressing large log-files.
The start operation does clear the console input file and logs information about the UNIX user environment and the security limits of the Unix user.
start but displays the live console at restart. See
monitor command for details
Stops the Domino server via server -q and waits a given grace period (configurable via DOMINO_SHUTDOWN_TIMEOUT – default 10 minutes).
After this time the Domino server is killed via NSD if it cannot be shutdown and processes are still ruining after this time (see “kill” command below).
The Java controller will also be shutdown (if used).
This is specially important when invoking a shutdown on systems using systemd.
If you specify
stop live the live console is shown during shutdown.
stop but displays the live console during shutdown.
The live console is automatically closed after shutdown of the server
monitor command for details
Stops the Domino server via
server -q and waits a given grace period (configurable via
DOMINO_SHUTDOWN_TIMEOUT – default 10 minutes).
After this time the Domino server is killed via NSD if it cannot be shutdown and processes are still ruining after this time (see
kill command below).
The Java controller remains active if configured.
Stops the Domino server and restarts it using
start command with all implications and specially the time-out values for “stop”.
restart but displays the live console for server/start stop.
monitor command for details
Checks if the Domino server is running and prints a message.
Return code of the script:
0 = server is not running 3 = server is running
systemd has a very nice and detailed status command.
The default status check remains the status the existing status command.
This command is used to show the systemd status for the domino.service.
(the systemd command would be:
systemctl status domino.service
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 Tika server process tika kill -> kills the Tika server process
Enables, Disables and shows the startup status of the service.
This command works on Linux only for rc-system and also systemd.
It is implemented in the
rc_domino entry script.
service on -> enables the service service off -> disables the service service add -> deletes the service service del -> deletes the service service -> shows the startup status of the service
Attaches to the output and the input files of a running Domino server and allows a kind of live console from a telnet/ssh session using the input and output files.
stop terminates the live console.
Issue console commands from the linux command line.
rc_domino cmd "command" [n log lines]
The command needs to be specified in double-quotes like shown above.
The optional parameter log lines can be used to print the last n lines of log file (via tail) after waiting 5 seconds for the command to finish.
rc_domino cmd "show server" 200
Issues a remote console command, waits 5 seconds and displays the last 200 lines
Note: Command parameters always need to be enclosed in quotes.
rc_domino passes the parameters with quotes to the main
But if you are using another script or other binary that calls rc_domino (for example service), the parameters might not be enclosed in quotes any more.
The rc_domino script requires that you have the parameters in quotes.
Every blank will be interpreted as a delimiter for a new parameter.
Shows version of start script
Displays notes.ini setting specified.
rc_domino inivar server_restricted
Edit the notes.ini of the server.
vi is the default editor which can be changed via
EDIT_COMMAND config setting.
Note: You should not edit the notes.ini while the server is running.
You might corrupt the notes.ini. For a running server use “set config .. “ on the server console instead.
Also take care with umlauts and other special characters.
In this case it is always recommended to use “set config” on a Notes Client instead because this will ensure that the characters are converted correctly.
Lists server’s notes.ini. You can use this command to show the notes.ini or redirect the output to a grep command
Edit the start script configuration.
By default if no specific server/user configuration is present the default config is edited.
You can either specify config ‘
server’ or config ‘
default’ for the different configurations.
The two options are:
config server config default
Edit the systemd config file.
Show or edit the log file. By default
vi is used to edit the log file.
Optionally you can specify your own command e.g.
log more or
log head -100
Shows last log lines. by default 100 lines are displayed.
Optionally you can specify the number of log lines.
Shows last system log lines for the service from systemd. by default 100 lines are displayed.
Optionally you can specify the number of log lines.
Archives the current server text log-file. The file is copied, compressed and the current log file is set to an empty file without losing the current file-handles of the server process.
There might be a very short log file interruption between copying the file and setting it to an empty file.
The new log file contains a log-line showing the archived log file name.
You can add a string to the archive log name as an additional parameter.
This can be useful if you have enabled debugging and want to capture an error situation.
In that case run archivelog before and run it afterwards with a string as an additional parameter which will be added to the file name of the zip.
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.
rc_domino clearlog 30 90
Clears logs with 30 days expiration and clears backup logs with 90 days expiration independent of the configured days.
In normal cases you would just use “clearlog” without parameters and specify expiration settings in the configuration.
clearlog uses the following logic:
DOMINO_CUSTOM_LOG_CLEAR_SCRIPTis configured only the custom clear script is used else the following logic applies.
DOMINO_LOG_CLEAR_DAYSis set the following files will be removed if they meet the expiration times specified:
DOMINO_LOG_PATHis set expired files are removed from this directory and sub-directories.
Else all expired files from
/local/notesdata/IBM_TECHNICAL_SUPPORTand sub-directories are removed.
DOMINO_LOG_BACKUP_CLEAR_DAYSis set the following files will be removed if they meet the expiration times specified:
DOMINO_LOG_BACKUP_DIRis set the following expired files are removed from this directory
Else the same file pattern is used to remove files from the data-directory.
DOMINO_CUSTOM_LOG_CLEAR_DAYSis set and also
DOMINO_CUSTOM_LOG_CLEAR_PATHis set all expired files from this directory and sub-directories are removed that meet the specified expiration days
Generates a full NSD including call-stacks and memcheck.
You can pass additional parameters to NSD.
Generates a NSD without memcheck (nsd -nomemcheck).
Generates a sysinfo style NSD (nsd -info).
Terminates the Domino server (nsd -kill)
Shows the resources that the server uses. This includes processes, shared memory, MQs, semaphores.
The resources are checked on OS level and list the same information that is used by the
cleanup command below. The command is useful for a running server but also for a crashed server to check which resources might not have been cleaned up by fault recovery.
Remove hanging resources after a server crash (processes, shared memory, semaphores, message queues).
In contrast to the
NSD -kill option this routine removes ALL resources.
This includes all message queues, shared memory, semaphores allocated by the UNIX user used by the Domino server instance.
And also removes all processes started from the server binary directory (e.g.
NSD currently does only remove registered resources in the following files:
pid.nbf, mq.nbf, sem.nbf, shm.nbf
So this command is mainly useful if NSD cannot remove all resources due to corruptions or add-on programs or any other odd situation. It prevents you from having to manually remove resources and processes in such a corrupt state.
Note: Resources allocated by add-on applications using native OS-level operations are not registered.
Generate a memory dump from the currently running server.
Generate 3 NSDs collecting the call-stacks (nsd -stacks) and one additional full NSD.
This option is needed collecting troubleshooting data for server hang analysis.
Generate one NSD with call-stacks only (nsd -stacks)
Runs compact when server is shutdown (if the server is started an error message is displayed, you have to shutdown the server first).
DOMINO_COMPACT_OPTIONS to be configured and is mainly intended for system databases.
Terminates the server, runs compact and restarts the server.
DOMINO_COMPACT_OPTION to be configured and is mainly intended for system databases.
Runs fixup when server is shutdown (if the server is started an error message is displayed, you have to shutdown the server first).
Needs DOMINO_FIXUP_OPTIONS to be configured and is mainly intended for system databases.
Terminates the server, runs fixup and restarts the server.
DOMINO_FIXUP_OPTIONS to be configured and is mainly intended for system databases.
Allows you to configure one time compacting databases at next startup.
This functionality controls a text file ‘domino_nextstartcompact’ in your data directory.
If this file is present, the compact operations specified via the following settings are executed at next start
domino_nextstartcompact will be deleted at next startup.
This is for example to be intended to be used after a planned OS reboot or OS patch.
And it avoids separate steps executed by the OS level admin.
compactnextstart on --> enables the compact at next startup compactnextstart off --> disables the compact at next startup
Specifying no or any other option will show the current settings.
The status file used by default is domino_nextstartcompact in data directory. If this file is present the compact operations will run once and remove the file.
Reset Sametime Community server logs/diags as used in the ststart script