Smarts NCM or VoyenceControl: How do I use the snmpGet tool?

Products

• VMware

Issue/Introduction

Symptoms:


How do I use the snmpGet tool installed by Smarts Network Configuration Manager (Smarts NCM) or VoyenceControl?
How do I get SNMP ObjectID values from a device in Smarts NCM?


Unknown device
Need device SNMP data

Environment

VMware Smart Assurance - NCM

Resolution

To use the Smarts NCM snmpGet command, do the following:

1. Ensure that SNMP is enabled on the target device. SNMP must be enabled on the target device for the Smarts NCM snmpGet tool to successfully retrieve data.
2. On a Smarts NCM Application Server (AS), Combination Server (CS), or Device Server (DS), log in to a Linux shell as root   .
3. Set the VOYENCE_HOME environment variable by running the following command:
   
   source /etc/voyence.conf
   
   
4. Use the Smarts NCM snmpGet tool to query a device for an SNMP ObjectID (OID) value by running the following command:
   
   $VOYENCE_HOME/tools/snmpGet $DEVICE_IP $DEVICE_OID -$SNMP_VERSION -C$COMMUNITY_STRING
   
   
   Where:
   
   
   • DEVICE_IP = the management IP address of the device
   • DEVICE_OID = the OID you intend to get (ex. 1.3.6.1.2.1.1.2.0 for a sysObjectID, aka. sysOID)
   • SNMP_VERSION = V1, V2 or V3
   • COMMUNITY_STRING = the SNMP community string configured in the device

Additional Information

Examples
The following commands get the sysObjectID value of a Cisco Catalyst 5500 Switch, then write the results to a file named Cat5500_sysObjectID.txt in the current directory:

source /etc/voyence.conf

$VOYENCE_HOME/tools/snmpGet $DEVICE_IP 1.3.6.1.2.1.1.2.0 -V2 -C$COMMUNITY_STRING > Cat5500_sysObjectID.txt

• DEVICE_IP = (Device management IP address)
• COMMUNITY_STRING = (Valid read-only or read-write SNMP community string)

Contents of example Cat5500_sysObjectID.txt output file:

SNMP++ Get to <device IPv4 address redacted> SNMPV1 Retries=1 Timeout=1000ms Community=<community string redacted>
Oid = 1.3.6.1.2.1.1.2.0
Value = 1.3.6.1.4.1.9.5.17

The following commands get the sysDescr (system description) OID value of a Cisco Catalyst 5500 Switch, then write the results to a file named Cat5500_sysDescr.txt in the current directory:

source /etc/voyence.conf

$VOYENCE_HOME/tools/snmpGet $DEVICE_IP 1.3.6.1.2.1.1.1.0 -V2 -C$COMMUNITY_STRING > Cat5500_sysDescr.txt

 

• DEVICE_IP = (Device management IP address)
• COMMUNITY_STRING = (Valid read-only or read-write SNMP community string)

Contents of example Cat5500_sysDescr.txt output file:

SNMP++ Get to <device IPv4 address redacted> SNMPV1 Retries=1 Timeout=1000ms Community=<community string redacted>
Oid = 1.3.6.1.2.1.1.1.0
Value = Cisco Systems WS-C5500
Cisco Catalyst Operating System Software, Version 6.4(1)
Copyright (c) 1995-2003 by Cisco Systems