VMware vRealize Operations Management Pack for SNMP

Management Packs for vRealize Operations Manager 3.0

You can find the most up-to-date technical documentation on the VMware website at:

https://docs.vmware.com/

If you have comments about this documentation, submit your feedback to

docfeedback@vmware.com

VMware, Inc.3401 Hillview Ave.Palo Alto, CA 94304www.vmware.com

Copyright © 2020 VMware, Inc. All rights reserved. Copyright and trademark information.

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 2

Contents

1 VMware vRealize Operations Management Pack for SNMP 4

2 Introduction 5

3 Installing SNMP 6

4 Configuring SNMP 7Adding a Credential 8

Loading Custom MIBs to vRealize Operations Manager for SNMP 9

List of MIBs in SNMP Adapter 10

5 Monitoring Network Devices Selectively 14Example: Monitoring Fan State for a Cisco Switch 14

VMware, Inc. 3

VMware vRealize Operations Management Pack for SNMP 1The VMware vRealize Operations Management Pack for SNMP guide provides information about installing and configuring the Management Pack for SNMP.

Intended AudienceThe information in this guide is intended for anyone who wants to install and configure the Management Pack for SNMP.

VMware Technical Publications GlossaryVMware Technical Publications provides a glossary of terms that might be unfamiliar to you. For definitions of terms as they are used in VMware technical documentation, go to http://www.vmware.com/support/pubs.

VMware, Inc. 4

Introduction 2The Simple Network Management Protocol (SNMP) is a standard Internet protocol for managing devices on IP networks. The SNMP adapter is an embedded adapter for vRealize Operations Manager that collects metrics from devices that support SNMP. These devices typically include routers, switches, servers, workstations, and printers.

SNMP displays management data on SNMP managed devices as variables, which are organized in hierarchies. Management Information Base (MIB) files describe these hierarchies and contain object identifiers (OIDs) that identify each variable.

The SNMP adapter uses MIB files to identify the metrics that have to be collected from a particular device. When you install the SNMP adapter, the installation utility places a set of standard MIB files in the conf/mib folder. You can import additional MIB files after you install the SNMP adapter. The MIB files that are added will appear in the MIB list drop-down menu.

The SNMP adapter supports devices that are configured with SNMP v2C and V3. The SNMP adapter supports auto-discovery of devices when you add a range or pool of IP addresses while configuring the adapter. The SNMP adapter does not support the device with V3 Auth Only, the v3 device must have both Authentication and Privacy Protocols enabled.

The SNMP adapter ships a range of MIB files, and metrics are created for all the OIDs that have the data type that the Management Pack supports. By default, all metrics are created but none are enabled. You can enable metrics by using Policies to monitor network devices and its components.

VMware, Inc. 5

Installing SNMP 3Install the VMware vRealize Operations Management Pack for SNMP from the vRealize Operations Manager interface.

Prerequisites

n Download the PAK file from VMware Marketplace.

n Save the PAK file to a temporary folder on your local system.

Procedure

1 Log in to the vRealize Operations Manager user interface with administrator privileges.

2 In the menu, select Administration and in the left pane select Solutions > Repository.

3 On the Repository tab, click Add/Upgrade.

4 Browse to locate the temporary folder and select the PAK file.

5 Click Upload. The upload might take several minutes.

6 Read and accept the EULA, and click Next.

Installation details appear in the window during the process.

7 When the installation is complete, click Finish.

What to do next

Configure an adapter instance for the management pack.

VMware, Inc. 6

Configuring SNMP 4After you install the Management Pack, configure an instance for SNMP.

To monitor any network device, ensure that the SNMP adapter is enabled and is running.

Procedure

1 In the menu, click Administration and then in the left pane, click Other Accounts.

2 Click Add Account and then click SNMP Adapter.

3 Configure the adapter instance.

Option Description

Name Enter a name for the adapter instance.

Description Enter a description for the adapter instance.

Start IP Enter a start IP address.

Note The test connection fails if the Start IP does not belong to the defined Credential. The Start IP provided should match the defined credentials.

End IP Enter an end IP address. The discovery process finds all the devices that have IP addresses within this range.

Note In a range of IPs, only those IPs that belong to the defined Credential are monitored. The IPs that you define should match with credentials that you have selected. The IPs that do not match the credentials are skipped.

Port The default port for SNMP is 161.

VMware, Inc. 7

Option Description

MIB File Select the MIB file specific to the component you want to monitor.

The SNMP adapter supports only specific data types with OIDs that it collects from the attached MIB file.You can attach any MIB file but the SNMP adapter can not create metrics for all OIDs even when the data for a component exists with that OID. The SNMP adapter supports the following datatypes for the MIBs.

n integer

n integer32

n counter

n counter32

n gauge

n gauge32

n timeticks

n counter64

For details of MIB files that are supported and validated, see List of MIBs in SNMP Adapter.

For details on adding custom MIBs in vRealize Operations Manager for SNMP adapter, see Loading Custom MIBs to vRealize Operations Manager for SNMP.

Credential Select the credential from the drop-down menu or click the plus icon to add new credentials. For details, see Adding a Credential.

Note With SNMP V3, the Authentication Protocols supported are MD5 and SHA and the Privacy Protocols supported are AES and DES.

Collector / Group Select the collector on which you want to run the adapter instance. A collector gathers objects into its inventory for monitoring. The collector specified by default is selected for optimal data collecting.

Note Ensure that the network latency between the collector and the device is as per the vRealize Operations Manager guidelines.

4 Click Validate Connection.

The validation starts with the defined Start IP. The connection fails if the Start IP is invalid or if it does not match with the selected credential. For all the devices that the credentials match with, objects for each device will be created under Inventory > SNMP Adapter Instance .

Adding a CredentialYou must add a credential for an SNMP adapter instance. The credential can be of SNMP v2C or V3.

You can add the credential before you create the adapter instance and select the correct credential while configuring the adapter instance. You can also add the credential while configuring the adapter instance.

Procedure

1 In the menu, click Administration and then in the left pane, click Other Accounts.

2 Click Add Account and then, click SNMP Adapter.

3 To add new credentials, click the plus icon next to the Credential drop-down menu.

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 8

4 Enter the credential details.

Option Description

Credential Kind Select SNMPv2c or SNMPv3 from the drop-down menu.

Credential Name Enter a name for the credential.

Community Enter the community string for the v2c credential kind. The following options are available only when you select SNMPv3 as Credential Kind.

Option Description

Username Enter the user name for the credential.

Authentication Protocol Select the authentication protocol from the list.

n MD5

n SHA

Authentication Password Enter the authentication password

Privacy Protocol Select the privacy protocol from the list.

n AES

n DES

Privacy Password Enter a password for the credential.

5 Click Ok to save the credential.

Loading Custom MIBs to vRealize Operations Manager for SNMPYou can load your custom MIB if a device requires MIB files that are not shipped with SNMP Management Pack.

Prerequisites

Copy the MIB files and all itsdependent MIB files under conf/mibs. The default installation location of SNMP is $ALIVE_BASE/user/plugins/inbound/snmp_adapter3/conf/mibs folder.

Procedure

1 For a multinode environment, enable SSH to all vRealize Operations Manager nodes.

2 Provide executive permission to update the Mibs.sh file and run the MIB file update script to import the MIB files. The MIB update script is available in the $ALIVE_BASE/user/plugins/inbound/snmp_adapter3/conf folder.

3 Check the mib-import.log file for any errors. The script generates the mib-import.log file in the conf folder. Errors commonly occur when the dependent MIB files are not present in the conf/mibs folder.

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 9

4 Open the conf/describe.xml file in a text editor and increase the version number. For example, if the version is '7', then change it to '8'.

5 Repeat the procedure from Step 1 through Step 4 in all vRealize Operations Manager nodes.

6 Log in to vRealize Operations Manager as an administrator.

7 In the Administration page, click Support > Redescribe and then, click REDESCRIBE.

The custom MIB files are added to the SNMP Management Pack. You can select the custom MIB from the MIB File drop-down menu while configuring the adapter instance.

Note Only those MIB files which have levels with numeric data will appear in drop-down menu.

Results

List of MIBs in SNMP AdapterThe SNMP adapter uses MIB files to determine the metrics to collect from a particular device. When you install the SNMP adapter, the installation utility places a set of standard MIB files in the conf/mib folder. You can import additional MIB files after you install the SNMP adapter.

List of MIBs Supported and Validated

n RFC1158-MIB.mib

n RFC1213-MIB.mib

n RFC1229-MIB.mib

n RFC1231-MIB.mib

n RFC1243-MIB.mib

n RFC1253-MIB.mib

n RFC1269-MIB.mib

n RFC1271-MIB.mib

n RFC1285-MIB.mib

n RFC1315-MIB.mib

n RFC1316-MIB.mib

n RFC1381-MIB.mib

n RFC1382-MIB.mib

n RFC1398-MIB.mib

n RFC1406-MIB.mib

n RFC1407-MIB.mib

n RFC1414-MIB.mib

n RFC1493-MIB.mib

n CISCO-ENVMON-MIB.mib

n CISCO-COMMON-MGMT-MIB.mib

n CISCO-PROCESS-MIB.mib

n CISCO-MEMORY-POOL-MIB.mib

n CISCO-ENTITY-FRU-CONTROL-MIB.mib

n ENTITY-MIB.mib IF-MIB.mib

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 10

List of MIBs Supported But Not Validated

n VMWARE-TUNNEL-SERVER-MIB.mib

n UDP-MIB.mib SNMPv2-CONF.mib

n RFC1229-MIB.mib

n RFC-1155.mib

n dcs3rmt.mib

n CISCO-COMMON-MGMT-MIB.mib

n VMWARE-VROPS-AGENTCAP-MIB.mib

n VMWARE-VRNI-MIB.mib

n VMWARE-TC-MIB.mib

n VMWARE-SRM-EVENT-MIB.mib

n VMWARE-HEARTBEAT-MIB.mib

n VMWARE-ESX-AGENTCAP-MIB.mib

n SNMP-USER-BASED-SM-MIB.mib

n SNMP-COMMUNITY-MIB.mib

n RFC1382-MIB.mib

n qlaspCfg.mib

n LLDP-V2-MIB.mib

n IP-MIB.mib

n INET-ADDRESS-MIB.mib

n IEEE8021-TC-MIB.mib

n CISCO-VTP-MIB.mib

n CISCO-ENVMON-MIB.mib

n 10892.mib

n RFC1406-MIB.mib

n DELL-RAC-MIB_NPS_6.1.mib

n baspStat.mib

n VMWARE-VA-AGENTCAP-MIB.mib

n VMWARE-RESOURCES-MIB.mib

n VMWARE-NSX-MANAGER-MIB.mib

n SNMPv2-TC.mib

n SNMP-MPD-MIB.mib

n RFC1414-MIB.mib

n RFC1381-MIB.mib

n RFC1315-MIB.mib

n RFC1271-MIB.mib

n RFC-1212.mib

n MX7000.mib

n IANA-RTPROTO-MIB.mib

n IANAifType-MIB.mib

n dellcm.mib dcstorag.mib

n CISCO-QOS-PIB-MIB.mib

n adptinfo.mib

n VMWARE-VROPS-MIB.mib

n VMWARE-VMINFO-MIB.mib

n VMWARE-ROOT-MIB.mib

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 11

List of MIBs Supported But Not Validated

n VMWARE-OBSOLETE-MIB.mib

n VMWARE-CIMOM-MIB.mib

n TCP-MIB.mib RMON2-MIB.mib

n RFC1493.mib

n RFC1316-MIB.mib

n RFC1285-MIB.mib

n Q-BRIDGE-MIB.mib

n OME.mib

n IPV6-FLOW-LABEL-MIB.mib

n INTELLAN.mib

n IEEE8023-LAG-MIB.mib

n IEEE8021-BRIDGE-MIB.mib

n IANA-ENTITY-MIB.mib

n CISCO-TC.mib BRIDGE-MIB.mib

n VMWARE-VRNI-AGENTCAP-MIB.mib

n VMWARE-VC-EVENT-MIB.mib

n UUID-TC-MIB.mib

n TOKEN-RING-RMON-MIB.mib

n SNMPv2-SMI.mib

n SNMPv2-MIB.mib

n RMON-MIB.mib

n rfc1514.mib

n RFC1407-MIB.mib

n RFC1398-MIB.mib

n RFC1269-MIB.mib

n RFC1243-MIB.mib

n RFC1231-MIB.mib

n RFC-1215.mib

n RFC1212-MIB.mib

n RFC1158-MIB.mib

n RFC1155-SMI.mib

n RFC1065-SMI.mib

n qlgcadptinfo.mib

n qlaspStat.mib

n LLDP-V2-TC-MIB.mib

n INTELLAN_new.mib

n IANA-ADDRESS-FAMILY-NUMBERS-MIB.mib

n dcs3fru.mib DcAsfSrv.mib

n CISCO-SMI.mib

n CISCO-PROCESS-MIB.mib

n CISCO-MEMORY-POOL-MIB.mib

n baspTrap.mib

n VMWARE-PRODUCTS-MIB.mib

n VMWARE-NSX-MANAGER-AGENTCAP-MIB.mib

n SNMP-TARGET-MIB.mib

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 12

List of MIBs Supported But Not Validated

n SNMP-FRAMEWORK-MIB.mib

n RFC1253-MIB.mib

n RFC1213-MIB.mib

n P-BRIDGE-MIB.mib

n mib-imports.props IF-MIB.mib

n iDRAC-SMIv1.mib

n HOST-RESOURCES-TYPES.mib

n HCNUM-TC.mib

n ENTITY-MIB.mib

n DELL-RAC-MIB.mib

n dellrac.mib

n CISCO-ENTITY-FRU-CONTROL-MIB.mib

n CISCO-CDP-MIB.mib

n VMWARE-VCOPS-EVENT-MIB.mib

n VMWARE-TUNNEL-SERVER-AGENTCAP-MIB.mib

n VMWARE-SYSTEM-MIB.mib

n VMWARE-ENV-MIB.mib

n qlaspTrap.mib

n IP-FORWARD-MIB.mib

n IEEE8021-Q-BRIDGE-MIB.mib

n iDRAC-SMIv2.mib

n HOST-RESOURCES-MIB.mib

n baspCfg.mib

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 13

Monitoring Network Devices Selectively 5With SNMP adapter, metrics are created using MIB as the base object. Metrics are created only for the OIDs that Management Pack supports. These metrics are then monitored for all the devices that are attached with MIB file while configuring the adapter instance.

While creating a symptom, the SNMP adapter does not allow you to choose a specific device, you can only choose a specific component at a specific index from the existing inventory. For example, if you have to monitor all three Cisco fan modules for 'shutdown' status, you can create three symptoms for each fan module at each index(1,2 and 3), but you cannot choose a specific device. The symptoms will be generated for all devices that has fan modules at index (1,2 and 3).

If there are three Cisco switches (10.107.119.1, 10.107.119.2 and 10.107.119.3) in the environment, then each device has three fan modules at index 1, 2 and 3. When you create an alert using the symptoms, these alerts will be generated for all three Cisco switches. The following scenario explains how to selectively monitor a specific device using vRealize Operations Manager 'Custom Groups' and 'Policies'.

This chapter includes the following topics:

n Example: Monitoring Fan State for a Cisco Switch

Example: Monitoring Fan State for a Cisco SwitchLet us consider the scenario of monitoring fan state for a Cisco Switch alone using vRealize Operations Manager 'Custom Groups' and 'Policies'.

Prerequisites

In this example:

n CISCO-ENVMON-MIB gives the current state of the fan present at OID 1.3.6.1.4.1.9.9.13.1.4.1.3 (ciscoEnvMonFanState)

n For Cisco Switch with IP 10.107.119.1, there are three Fan components and you want to monitor Fan state for Cisco Switch 10.107.119.1 for any/all Fan modules

n The possible states of a Fan module are normal, warning, critical, shutdown, not present, and not functioning

VMware, Inc. 14

Procedure

1 Create an adapter instance for the range of devices that you want to monitor for Fan State. While creating the adapter instance, attach CISCO-ENVMON-MIB to adapter instance as shown in the following figure.

You have added a range of devices. For the credentials that match, the objects for each device are created under the adapter instance.

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 15

2 Create a new custom group in Environment > Custom Groups . While creating a custom group, select the policy and add only the device(s) that have to be monitored. In this example, add 10.107.119.1.

3 Go to Administration > Policies and click Collect Metrics and Policies. Search for 1.3.6.1.4.1.9.9.13.1.4.1.3 or ciscoEnvMonFanState and then set the state to Local for the OID as shown in the following figure.

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 16

4 In the Apply Policy to Groups tab, select Switch-One-CustomGroup.

5 In the Alerts page, click Configuration > Alert Definition.

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 17

6 Create a new alert definition with the name 'Fan Is Administratively down on Cisco device' and select the Base Object Type as 'CISCO-ENVMON-MIB.mib'.

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 18

7 Create Symptoms for each fan module at index 1, 2 and 3 for status 'shutdown' at OID 1.3.6.1.4.1.9.9.13.1.4.1.3. Attach these symptoms to alert definition.

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 19

8 Restrict the alert to the policy 'Switch-One-Policy' so that this alert will be generated only for the Cisco Switch with IP 10.107.119.1.

9 Click Update.

After a few collection cycles, alert is generated only for Cisco Switch with IP 10.107.119.1 as shown in the following figure.

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 20

VMware vRealize Operations Management Pack for SNMP

VMware, Inc. 21