Enabling SNMP

Turbonomic requires that SNMP is enabled and configured in order to discover Guest Processes. While these steps will change slightly between OS versions, this topic gives you the general instructions:

Enabling SNMP v2

  1. Obtain and install the SNMP server package for your Linux distribution and version. This is commonly called net-snmp in most package managers. Also install the net-snmp-utils package if it is available.

  2. Configure the SNMP daemon by editing /etc/snmp/snmpd.conf or running snmpconf -i at the command line in order to verify that:

    • SNMP v2c is enabled.

    • A read-only community name has been set. This community name will be used by Turbonomic to communicate with the SNMP agent on the VM.

      Note:

      The community name you select must have at least read-only access to all OIDs in the system.

  3. Configure the daemon to listen on a public interface. Most default installations only listen on 127.0.0.1.

  4. Start the SNMP daemon process.

These long form and short form sample snmp.conf files illustrate the necessary changes.

Long form, VACM:


# First, map the community name "mycommunity1" into a "security name"
# sec.name  source          community
    com2sec notConfigUser  default      mycommunity1
# Second, map the security name into a group name:
# groupName securityModel securityName
    group   notConfigGroup v2c           notConfigUser
# Finally, grant the group read-only access to any UUID.
# group context sec.model sec.level prefix read   write  notif
    access  notConfigGroup ""      any       noauth    
    exact  all none none

Short form, older syntax:

rocommunity mycommunity1 default system

Verify Your SNMP Setup

Verify that your SNMP setup is successful by running the following command from a remote machine, replacing the community string and IP address:

snmpwalk -Os -v 2c -c COMMUNITY_STRING IP_ADDRESS iso.3.6.1.2.1.1.1

If successful, the command returns the kernel version of the machine (similar to the output of uname -a).

Enabling SNMP v3

  1. Obtain and install the SNMP server package for your Linux distribution and version.

    Most package managers call this package net-snmp. To verify your configuration as mentioned in the final step, you should also install the net-snmp-utils package on the Turbonomic VM.

  2. Stop the SNMP service.

  3. Create the SNMPv3 user.

    net-snmp-config --create-snmpv3-user [-ro] [-A authpass] [-X privpass] [-a MD5|SHA] [-x DES|AES] [username]

    For example, the command:

    i. net-snmp-create-v3-user -ro -A snmpv3authPass -a SHA -X snmpv3encPass -x AES snmpv3user

    Results in output similar to the following example:

    adding the following line to /var/lib/net-snmp/snmpd.conf:
createUser snmpv3user SHA "snmpv3authPass" AES snmpv3encPass adding the following line to /etc/snmp/snmpd.conf:
rouser snmpv3user

  4. Verify your SNMP setup.

    To verify the configuration, run the following command on the Turbonomic VM:

    snmpwalk -Os -v 2c -c COMMUNITY_STRING IP_ADDRESS iso.3.6.1.2.1.1.1