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
-
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 thenet-snmp-utils
package if it is available. -
Configure the SNMP daemon by editing
/etc/snmp/snmpd.conf
or runningsnmpconf -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.
-
-
Configure the daemon to listen on a public interface. Most default installations only listen on
127.0.0.1
. -
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
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 thenet-snmp-utils
package on the Turbonomic VM.Stop the SNMP service.
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
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