Configuring the Domino SNMP Agent for Linux

Complete these steps, once per platform, to configure the Domino® SNMP Agent for Linux.

Before you begin

Starting with Domino 14.5, a NET-SNMP Master Agent and net-snmp.sh are not provided with the installation. You must download and install a NET-SNMP Master Agent and its dependent RPM packages and then refer to Configuring Master SNMP Agent for systemd to set up your master agent technology for use with Domino. You should configure appropriate trap destinations and community names for your remote management infrastructure.

About this task

Before using the Domino SNMP Agent, make sure TCP/IP and SNMP are properly installed and configured on the server. Verify that your Master SNMP Agent supports the SMUX protocol, per RFC 1227. Ensure that the Domino executable and the Domino data directories are in your search path.

Note: Starting with Domino 14.5, LNSNMP is moved to the “systemd” service instead of the “init” service. The LNSNMP process under systemd is referred to as the “dominosnmp” service.
Important: As you configure the Domino SNMP Agent for Linux, you should run the following commands as the root user.

Procedure

  1. Install LNSNMP. Run this script to install lnsnmp.exe under systemd:
    /opt/hcl/lotus/notes/latest/linux/install-dominosnmp.sh
    • Copies the dominosnmp.service file from the install location to the systemd location (default /etc/systemd/system/).
    • Appends the configuration of the Master SNMP Agent to accept LNSNMP as an SMUX peer, as well as the following configurations:
      smuxpeer 1.3.6.1.4.1.334.72 NotesPasswd
      rocommunity public
      view    systemview    included   .1.3
    • Restarts the Master SNMP Agent and Domino SNMP Agents as follows:
      systemctl restart snmpd
      systemctl restart dominosnmp
  2. LNSNMP systemctl commands. Make use of these systemctl as needed:
    • Start the LNSNMP process:
      systemctl start dominosnmp
    • Stop the LNSNMP process:
      systemctl stop dominosnmp
    • Show status of LNSNMP process:
      systemctl status dominosnmp
    • Enable or disable LNSNMP process under systemd:
      systemctl enable dominosnmp
      systemctl disable dominosnmp
    • Restart the LNSNMP process:
      systemctl restart dominosnmp
    Note: The Domino SNMP Agent is set up to run automatically under systemd. This means that once the Domino SNMP Agent is installed under systemd, it will always be running at startup, even when Domino is not. If you need to upgrade Domino, stop the LNSNMP process before beginning the upgrade process. To set up the Master SNMP Agent under systemd, see Configuring Master SNMP Agent for systemd.
  3. Remove the old init.d. For Domono versions earlier than 14.5, if you had the init service configuration and used lnsnmp.sh for the start/stop service, you must do one of these to remove the lnsnmp.sh script.
    • For United Linux-based releases, such as SLES, enter this command:
      rm /etc/init.d/lnsnmp
    • For Red Hat Linux releases, enter this command:
      Rm /etc/rc.d/inti.d/lnsnmp