Installing and running NSD as a Microsoft Windows service
You can manually install Notes® System Diagnostics (NSD) as a Microsoft Windows (Win32) service. When NSD is registered as a service, you can enter commands to start or stop the service, trigger NSD processing, generate status and trace messages, and request status information that can be written to a log file. You can also uninstall the NSD service.
About this task
Enter all NSD commands from a Microsoft Windows console window. For example, to install the NSD service, open a Microsoft Windows console window, navigate to the location of the NOTES.INI file, and enter the following command:
nsd -svcinst
All of the options described in this topic are available only on Notes and Domino® running on Microsoft Windows platforms.
Installing the NSD service
About this task
Use this command to install the NSD service:
-svcinst
The -svcinst command Installs the NSD Win32 service. Once installed and started, Notes and Domino fault recovery uses the Win32 service for all attempts to invoke NSD. Note that -svcinst only installs the service; it must be started separately by doing one of the following:
- Running NSD -svcstart
- Using the Services control panel applet to start it
- Rebooting the system which causes the service to restart
The -svcinst command is usually paired with -svcstart which starts the service. For example, enter the following:
nsd -svcinst -svcstart
Running the NSD service
About this task
Use the following commands to start and stop the NSD service:
-svcstart
The -svcstart command starts the NSD Win32 service. Once started, Notes and Domino fault recovery uses the Win32 service for all attempts to invoke NSD. This option is only useful when the NSD Win32 service is installed and not started. For example, enter:
nsd -svcstart
-svcstop
The -svcstop command stops the NSD Win32 service. Once stopped, Notes and Domino fault recovery runs NSD as a child process for all attempts to invoke NSD. This option is only useful when the NSD Win32 service is installed and started. For example, enter:
nsd -svcstop
Using the NSD service
About this task
Use the -svclog and -svcreport commands to manage the NSD service. For example, you can generate status and trace messages and request status information that can be written to a log file.
When specified with another service option, for example, svcinst, -svclog causes status and trace messages to be appended to a log file NSDSVC.LOG in the data\IBM_TECHNICAL_SUPPORT directory. This option is only useful when specified with another service option. For example, enter:
nsd -svcinst -svclog
The -svcreport command requests status information about the NSD Win32 service from Microsoft Windows, which is then written to the console (stdout), and appended to the file NSDSVC.LOG (if -svclog is also specified). This option is only available on Microsoft Windows versions of Notes and Domino. For example, enter:
nsd -svcreport
Uninstalling the NSD service
About this task
The uninstall command unregisters NSD as a Win32 system service. NSD -svcuninst does not remove any files from the system. Use the following command to uninstall the NSD service:
-svcuninst
The -svcuninst command uninstalls the NSD Win32 service. Once uninstalled, Notes and Domino fault recovery runs NSD as a child process for all attempts to invoke NSD. This option is only useful when the NSD Win32 service is installed.
The uninstall command is usually paired with the -svcstop command. For example, enter the following to stop the NSD service, and then uninstall it:
nsd -svcstop