Completing the configuration of the Domino® SNMP Agent

After you have performed the platform-specific configuration steps, complete the configuration of the Domino® SNMP Agent by following these steps which apply to all platforms. Repeat these steps as necessary for each Domino® partition.

Starting the Domino® server add-in tasks

Procedure

To support SNMP queries, start the QuerySet add-in task. Enter this command on the Domino® Server console:
```
load quryset
```
To support SNMP traps for Domino® events, start the Event Interceptor add-in task. Enter this command on the Domino® Server console:
```
load intrcpt 
```
To support Domino® statistic threshold traps, start the Statistic Collector add-in task. Enter this command on the Domino® Server console:
```
load collect
```
Arrange for the add-in tasks to be restarted automatically the next time that Domino® is restarted. Add quryset and/or intrcpt and collect to the ServerTasks variable in Domino's NOTES.INI file.

Configuring traps for Domino® events

After the Domino® SNMP Agent is configured, the SNMP management console is able to receive traps for basic SNMP events for that server (for example, server down). Additional configuration is required to receive traps for Domino® events. Create the appropriate event handlers in the Domino® Monitoring Configuration database. The Event Handler's Notification Method must be set to SNMP Trap, and the Notification Server must be set to an asterisk.

Configuring statistic threshold traps

You can receive SNMP traps for Domino® statistics that exceed a specified value when you have created appropriate statistic event generators and appropriate event handlers in the Domino® Monitoring Configuration database. Domino® must also be running the Statistic Collector and Event Interceptor add-in tasks. The Notification Method of the event handler must be set to SNMP Trap, and the Notification Server must be set to an asterisk.

Enabling the SNMP Agent to start or stop a Domino® server

You can start or stop Domino® servers from a remote management console using the Domino® SNMP Agent. To do so, enable the Domino® SNMP Agent to start or stop a specific server.

About this task

By default, the Domino® SNMP Agent does not allow the remote server to start or stop. You do not need to modify a server's Configuration Settings unless you want to enable the Domino® SNMP Agent to start or stop that server.

If the server ID is password protected, the Domino® SNMP Agent cannot be used to remotely restart a Domino® server. SNMP cannot pass a password parameter to the server.

Note: It may not be possible for SNMP to start a server until that server has identified itself to the Domino® SNMP Agent. To prevent this situation, include information about the server in the lnsnmp.ini file.

The Allow Server Start and Allow Server Stop configuration options are on the SNMP tab of the server Configuration Settings document; select Yes for each option.

Note: If you select Only if the server is unresponsive for Allow Server Stop, the SNMP agent can be used to stop this server only if the server is not responding to the Domino® SNMP Agent's pulse checks.

To initiate a server start or server stop, the remote management console must set the lnServerTblSetState MIB object. In the case of a non-partitioned server, the lnNotesServerSetState MIB object can also be used.

Enabling the SNMP Agent to reboot the system

You can reboot the system from a remote management console using the Domino® SNMP Agent. To do so, enable the Domino® SNMP Agent to reboot the system.

About this task

By default, the Domino® SNMP Agent does not allow remote system reboot. You do not need to modify a server's Configuration Settings document unless you want to enable the Domino® SNMP Agent to reboot the system.

Note: Rebooting is not supported on the z/OS® platform.

For a partitioned server, all running partitions must configured to allow a system reboot. If one running partition is configured to not allow a system reboot, then the reboot is not performed.

The Allow System Reboot configuration option is on the SNMP tab of the server Configuration Settings document. Choose one:

No -- (default) SNMP may not be used to reboot this system.
Yes -- SNMP may be used to reboot this system.
Only if the server is unresponsive -- SNMP may be used to reboot this system only if the server is not responding to the Domino® SNMP Agent's pulse checks.

Note: On a partitioned server SNMP will reboot the system only if all active partitions allow it.

To initiate a system reboot, the remote management console must set the lnRemoteReboot MIB object.