Configuring Master SNMP Agent for systemd

On the Linux platform, the Domino® SNMP Agent uses the SMUX protocol, per RFC 1227, to communicate with the system's Master SNMP Agent. Some Linux distributions include a Master SNMP Agent that supports the SMUX protocol; others do not.

About this task

On the Linux platform, starting in Domino 14.5, the NET-SNMP Master Agent called NET-SNMPD is not included. You need to install your own NET-SNMP Master Agent packages from the Net-SNMP website, which contain many optional components, from which you might want to create and/or configure your own Master SNMP Agent for use with Domino.

Installing and configuring NET-SNMP to run as a systemd service

Procedure

  1. Run the following commands to install the NET-SNMP packages:
    yum install net-snmp
    yum install net-snmp-utils
  2. Verify the NET-SNMP install with the following command.
    snmpwalk --version
  3. Create a new service file for SNMP at the following location:
    /etc/systemd/system/snmpd.service
  4. Refer to the /opt/hcl/domino/notes/latest/linux/dominosnmp.service file or add the following in the service file.
    [Unit]
    Description=Simple Network Management Protocol (SNMP) Daemon
    Documentation=man:snmpd(8)
    After=syslog.target, network.target
    
    [Service]
    ExecStart=/usr/sbin/snmpd -Lsd -Lf /dev/null -p /run/snmpd.pid
    ExecReload=/bin/kill -HUP $MAINPID
    PIDFile=/run/snmpd.pid
    
    [Install]
    WantedBy=multi-user.target
  5. Enable the snmpd service with the following commands:
    systemctl daemon-reload
    systemctl enable snmpd
  6. Restart the system and after the startup, verify that the snmpd service is running by entering the following command:
    systemctl status snmpd

Configuring NET-SNMPD

Procedure

Update the /etc/snmp/snmpd.conf file with appropriate trap destinations and community names for your remote management infrastructure. Trap destinations are set using the trapsink directive. Community names are set using the rocommunity and rwcommunity directives.
Note: If you use the install-dominosnmp.sh provided with Domino, you do not need to create or configure your own NET-SNMP Master Agent. Both have been done for you.