Configuring the Domino SNMP Agent for z/OS
Complete these steps, once per LPAR, to configure the Domino® SNMP Agent for IBM® z/OS®.
About this task
Before using the Domino SNMP Agent, ensure that TCP/IP and SNMP are properly installed and configured on the LPAR. Also, verify that the Domino executable and the Domino data directories are in your search path. Only community-based security (SNMPv1 / SNMPv2 formats) is supported.
If you do not have SNMP configured on your LPAR, see the following IBM documentation to configure SNMP:
- z/OS Communications Server: IP Configuration Guide, SC31-8775
- z/OS Communications Server: IP Configuration Reference, SC31-8776
The SNMP agent and subagents record trace information via the z/OS UNIX™ System Services syslog daemon using the daemon facility. If you are using SNMP, set up the syslog daemon. For detailed information regarding syslogd and specifying the daemon facility in the /etc/syslog.conf configuration file, see the z/OS Communications Server manuals in the preceding list.
To verify that SNMP is configured correctly, enter the following command from within Unix System Services:
osnmp -h host name walk system
The output should resemble the following sample output:
1.3.6.1.2.1.1.1.0 = SNMPv3 agent version 1.0 with DPI version 2.0
1.3.6.1.2.1.1.2.0 = 1.3.6.1.4.1.2.3.13
1.3.6.1.2.1.1.3.0 = 1192800
1.3.6.1.2.1.1.4.0 = userid
1.3.6.1.2.1.1.5.0 = hostname
1.3.6.1.2.1.1.6.0 = location
1.3.6.1.2.1.1.7.0 = 76
1.3.6.1.2.1.1.8.0 = 950000
1.3.6.1.2.1.1.9.1.2.1 = 1.3.6.1.4.1.2.11.7.1
1.3.6.1.2.1.1.9.1.2.2 = 1.3.6.1.4.1.2.11.7.2
1.3.6.1.2.1.1.9.1.3.1 = z/OS SNMP Agent
1.3.6.1.2.1.1.9.1.3.2 = z/OS TCP/IP SNMP Subagent
1.3.6.1.2.1.1.9.1.4.1 = 0
1.3.6.1.2.1.1.9.1.4.2 = 1800
If the output from the osnmp command does not resemble the sample output, SNMP is not correctly configured. Verify that you have SNMP configured correctly by reviewing the z/OS Communications Server manuals prior to continuing. You need to be aware of the following when setting up SNMP for Domino:
Procedure
To start the Domino SNMP agent
Procedure
Results
The value returned should have an OID number that starts with 1.3.6.1.4.1.334.72. This confirms that the SNMP Agent is receiving the request, forwarding it to lsnmp, and that lsnmp is returning a valid value.
If you do not see the appropriate responses shown in the sample output, or if the getnext response is for an OID outside of the Domino MIB, additional debugging is required. Start an SNMP Agent trace at level 255.
To determine whether there are additional things to check for and to obtain information about setting up an SNMP Agent trace, see informational APAR II13477.
To stop the LNSMP agent use
About this task
Enter this command:
lnsnmp.sh stop
After you complete the z/OS-specific portion of the Domino SNMP Agent configuration, complete the rest of the non-platform-specific configuration.