On a HAProxy Enterprise server, the SNMP stack is split into two main components and one optional component:

  • The Operating system SNMP daemon, called snmpd. It listens on a network interface on port 161/UDP and handles SNMP requests from clients.

  • The SNMP plugin for HAProxy, called hapee-snmp-lb. This plugin collects data from hapee-1.7-lb for snmpd.

  • The HAProxy Enterprise SNMP daemon: called hapee-snmp (optional and does not require configuration or update).

The diagram below illustrates the flow:

HAProxy Enterprise SNMP Daemon

HAProxy Enterprise SNMP Daemon

Install the operating system's SNMP daemon

Run the following command:

$ # RedHat / CentOS
$ yum install net-snmp

$ # Ubuntu / Debian
$ apt-get install snmpd

Note

Skip this step if your system already has an SNMP daemon installed.

Install the HAProxy Enterprise SNMP plugin

For the package hapee-1.7r2-snmp-lb, run this command:

$ # RedHat / CentOS
$ yum install hapee-1.7r2-snmp-lb

$ # Ubuntu / Debian
$ apt-get install hapee-1.7r2-snmp-lb

Configure the system SNMP daemon

  1. Edit the file /etc/snmp/snmpd.conf to have the snmp daemon listen on the correct address:

    • Comment out agentAddress udp:127.0.0.1:161.

    • Uncomment agentAddress udp:161,udp6:[::1]:161.

    • Enable the SNMP server snmpd:

      view systemonly included .1.3.6.1.4.1.23263

    • Add the SNMP extension: pass_persist:

      pass_persist  .1.3.6.1.4.1.23263.4.3.1.3 /opt/hapee-1.7/bin/hapee-snmp-lb

  2. Create a new read-only socket:

    $ # RedHat / CentOS
$ stats socket /var/run/hapee-extras/hapee-lb.sock user hapee-lb group hapee mode 660 level user

$ # Ubuntu / Debian
$ stats socket /var/run/hapee-extras/hapee-lb.sock user hapee-lb group Debian-snmp mode 660 level user

    Note

    On RedHat and CentOS runs snmpd as root; hence there is no need for a specific user or group on the socket.

    On Debian and Ubuntu runs snmpd as Debian-snmp.

  3. Restart HAProxy.

  4. Restart snmpd.

Note

There is nothing to configure for this software, as the package provides its configuration and it does not require any update.