IBM Support

MustGather: SNMP on IBM i

Troubleshooting


Problem

This document describes the steps needed to collect the appropriate documentation to troubleshoot SNMP issues on IBM i.

Resolving The Problem

Function Description
SNMP - Simple Network Management Protocol collects various statistics about a system on a network. A 'Manager' can request this data from an SNMP agent provided the community name (SNMPv1) or SNMPv3 username and password is set correctly. The host can also send unsolicited Traps (or SNMPv3 Informs from R740 or higher) to the manager signaling important events or a message from a third-party application. For a further overview of SNMP, see technote N1011620.

Related Jobs and Tasks
SNMP Agent jobs (started with command STRTCPSVR *SNMP)
QSNMPSA - The SNMP subagent job.
QTMSNMP - The SNMP agent job. Data is passed from the QTMSNMPRCV job to this one for processing.  Most error messages are shown in this job
QTMSNMPRCV - The receiver job. SNMP get requests are received from the SNMP manager through this job. It listens on port 161 (UDP)
QTMSNMPINF - (V7R4M0 or higher only) Handles the sending of SNMPv3 Inform messages

SNMP Trap Manager jobs (started with command STRTRPMGR)
QTRPRCV - The SNMP Trap Manager receiver job. It receives traps from SNMP agents running on other systems.  It listens on port 162 (UDP)
QTRPMGR - The SNMP Trap manager job. It manages the traps received through QTRPRCV and optionally forwards them onto another SNMP Trap Manager


Materials required for analysis of the most common SNMP Agent issues

  •  Job logs for QTMSNMP, QTMSNMPRCV, and QSNMPSA
  •  PTF listing
  •  Screen captures of all pages of CFGTCPSNMP Option 1, and CFGTCPSNMP Option 2 (for SNMPv1) and CFGTCPSNMP option 3 (for SNMPv3)
  •  Start communication and job traces:

    TRCCNN SET(*ON) TRCTYPE(*IP) TRCTBL(SNMP) SIZE(160000)
    and
    STRTRC SSNID(SNMP) JOB((*ALL/QSNMPSA *ALL) (*ALL/QTMSNMP *ALL) (*ALL/QTMSNMPRCV *ALL)) JOBTRCTYPE(*TRCTYPE) TRCTYPE((*SNMP *VERBOSE))

     
  •  Re-create issue
     
  •  End communication and job traces
    TRCCNN SET(*OFF) TRCTBL(SNMP) OUTPUT(*STMF) TOSTMF('/path/filename.pcap' *YES)
      replacing '/path/filename.pcap' with your own path and file name, for example. '/home/usera/ftp_failure.pcap'

    ENDTRC SSNID(SNMP) PRTTRC(*YES)
     
  • Send collected spooled output and .pcap file

Other materials required for less common issues

  1. For debug of issues involving sending SNMP Inform messages to an external SNMP Trap Manager (V7R4M0 or higher only):
    Collect same materials as detailed in common issues but with the inclusion of the QTMSNMPINF job log, and modify the STRTRC to be:
    STRTRC SSNID(SNMP) JOB((*ALL/QSNMPSA *ALL) (*ALL/QTMSNMP *ALL) (*ALL/QTMSNMPRCV *ALL) (*ALL/QTMSNMPINF)) JOBTRCTYPE(*TRCTYPE) TRCTYPE((*SNMP *VERBOSE))

  2. For debug of IBM i SNMP Trap Manager issues:
    Collect same materials as detailed in common issues but with the inclusion of the QTRPMGR and QTRPMGRRCV jobs (and QTMSNMPINF if the IBM i is at R740 or higher and configured to receive SNMPv3 Informs), and modify the STRTRC statement to include these additional jobs

Related Information

Technote N1011620

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]

Historical Number

486270962

Document Information

Modified date:
11 November 2019

UID

nas8N1013694

Page Feedback