Dell EMC OpenManage Plug-in Version 3.0 for Nagios Core User’s Guide April 2018 Rev.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2015 -2018 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Chapter 1: Introduction to Dell EMC OpenManage Plug-in Version 3.0 for Nagios Core......................... 5 Chapter 2: What is new in Dell EMC OpenManage Plug-in version 3.0................................................. 6 Chapter 3: Key features...................................................................................................................7 Chapter 4: Support matrix...............................................................................................................
Appendix A: Appendix....................................................................................................................
1 Introduction to Dell EMC OpenManage Plug-in Version 3.0 for Nagios Core This guide provides information about using the Dell EMC OpenManage Plug-in Version 3.0 for Nagios Core and its various features such as discovering, monitoring, launching consoles, and troubleshooting of the supported Dell EMC devices. The guide also provides details of the supported Dell EMC devices and frequently asked questions by the customer.
2 What is new in Dell EMC OpenManage Plug-in version 3.0 The following table lists the new features and functionality of the Dell EMC OpenManage Plug-in version 3.0: Table 1.
3 Key features The key features of the Dell EMC OpenManage Plug-in Version 3.0 for Nagios Core are as described in the following table. Table 2. Key features Feature Functionality Device discovery Discovers the supported Dell EMC devices in the Nagios Core console. Once the discovery is complete, host and service definitions are created for each device. • • • Device information You can discover iDRAC devices either using SNMP or WSMan protocol or Redfish REST APIs .
4 Support matrix Dell EMC OpenManage Plug-in version 3.0 for Nagios Core supports the Dell EMC devices as listed in the following tables. Datacenter Scalable Solutions Table 3. Supported Datacenter Scalable Solutions. Datacenter Scalable Solutions (DSS) DSS 1500 DSS 1510 DSS 2500 Hyper-converged Infrastructure (HCI) Platforms Table 4.
PowerEdge Servers Table 5. Supported PowerEdge Servers.
Table 7. Supported Compellent Storage Arrays. (continued) Compellent SC8000 Compellent SC9000 EqualLogic PS-Series Storage Arrays Table 8. Supported EqualLogic PS-Series Storage Arrays. EqualLogic PS4000 EqualLogic PS6000 EqualLogic PS4110 EqualLogic PS6010 EqualLogic PS-M4110 EqualLogic PS6110 EqualLogic PS4210 EqualLogic PS6610 EqualLogic PS4100 EqualLogic PS6100 EqualLogic PSM4110 EqualLogic PS6210 EqualLogic PS6500 EqualLogic PS6510 PowerVault MD-Series Storage Arrays Table 9.
Table 10. Supported Network Switches (continued) S Series Z Series C Series FN Series M Series N Series S4048-ON N1524P N4032 S5000 N1548 N4032F S6000 N1548P S6000-ON N2024 S6010-ON N2024P S6100-ON N2048 S5048F N2048P NOTE: All the information of the discovered Dell EMC Network Switch will not be displayed if the firmware version is less than 9.11.2.8. You need to ensure that the firmware version is 9.11.2.8 or above.
5 Device discovery and inventory Topics: • • • • About device discovery About Dell EMC device discovery utility Discovering Dell EMC devices Device information About device discovery You can discover the supported Dell EMC devices with this plug-in in the Nagios Core console. The monitoring protocols for the supported Dell EMC devices are as follows: • • • Dell EMC Servers are discovered using SNMP or WSMan protocol or Redfish REST APIs. Dell EMC Chassis are discovered using WSMan protocol.
Table 11. Dell EMC Device Helper Utility options Options Description -h Displays the help message. --host Host IP address or HostName to be discovered. --File Provides a filename with path containing the IP addresses / Hostname / Subnet with mask, separated by new line. --subnet To get the Subnet with mask. --all This option is used to display detailed services. If --all parameter is added, the result displays all the detailed services. By default, only basic services are displayed.
Table 12. Dell EMC Device Helper Utility Mandatory Parameters --host --filename These parameters define the value of the Dell EMC device to be discovered. --subnet --snmp.version --http.user --http.password --output.file This parameter is mandatory for a Dell EMC device discovered through SNMP. This parameter is mandatory for a Dell EMC device discovered through WSMan / Redfish. This displays the location where the host file will be created in .
Table 13. Default services created for Dell EMC Servers based on the selected protocol (continued) Services SNMP WSMan Protocol Redfish Protocol Dell EMC Server Power Supply Status √ √ √ Dell EMC Server Temperature Probe Status √ √ √ Dell EMC Server SD Card Status X √ X Dell EMC Server FC NIC Status X √ X Dell EMC Server Warranty Information √ √ √ Table 14.
Table 15.
Table 18. Default services created for PowerVault MD-Series Storage Arrays based on SNMP protocol (continued) Services Dell EMC Storage MD-Series MD Information Dell EMC Storage MD-Series MD Traps Detailed Services Dell EMC Storage MD-Series Warranty Information Discovering Dell EMC devices You can discover all the supported Dell EMC devices using this plug-in.
• To discover using Redfish REST APIs using File Path: python dellemc_nagios_discovery_utility.py --file= --prefProtocol=3 --http.user=root --http.password=calvin --output.file=/usr/local/nagios/dell/config/ objects/ • To discover using SNMP using File Path: python dellemc_nagios_discovery_utility.py --file= --prefProtocol=1 --snmp.version=2 --output.file=/usr/local/nagios/dell/config/objects/ 5.
Table 19.
Table 19. Device Information (continued) Service Status • Dell EMC Network Switch Information Attributes Displayed This service provides the basic information of the Network Switch. • • • • • • • Warning The following states are possible: • • • • Description OK Unknown Critical Warning HostName Model ServiceTag Serial Number MACAddress ManagementIP Firmware Version For attributes information on various components, see About Monitoring Component Health of Dell EMC Devices.
6 Monitoring Dell EMC devices You can monitor the aspects of Dell EMC devices as explained in the following sections. Topics: • • • Overall health status of the Dell EMC devices Monitoring component health of Dell EMC devices Monitoring SNMP alerts Overall health status of the Dell EMC devices You can monitor the overall health status of the Dell EMC devices in the Nagios Core console. The overall health status is an aggregate status of the components of the supported Dell EMC devices.
Table 20. Overall health Status information (continued) Service Status Description Attributes displayed when using WSMan Attributes displayed when using SNMP Attributes displayed when using Redfish Dell EMC Chassis Overall Health Status Provides global Overall Chassis health status of Dell EMC Chassis. Not Available Not Available Dell EMC Storage PSSeries Member Overall Health Provides global Not Available health status of EqualLogic Storage Arrays.
Once the discovery utility is run with the relevant option, the corresponding services are created. These services run periodically and update the overall health of the components. The component’s status and information are displayed in the Nagios Core user interface. The format of the component information in the Status Information column is =, =. For example: Status=CRITICAL, FQDD=Fan.Embedded.1, State=Enabled Table 21.
Table 21. Dell EMC device’s component health information (continued) Service Status Description Attributes displayed when using WSMan Attributes displayed when using SNMP Attributes displayed when using Redfish NOTE: FirmwareVersio n and ProductName attributes will display Not Available. Dell EMC Server CPU Status Provides overall health status of the CPUs in Dell EMC Servers.
Table 21. Dell EMC device’s component health information (continued) Service Status Dell EMC Server FC NIC Status Description Attributes displayed when using WSMan Provides overall health status of the FC NIC in Dell EMC Servers. • • • • • Attributes displayed when using SNMP ConnectionStatu Not Available s FQDD Name FirmwareVersion LinkSpeed Attributes displayed when using Redfish Not Available Table 22.
Table 22. Dell EMC Chassis component health information (continued) Service Status Description Attributes Displayed Provides the worst case aggregate health status of the storage controllers in Dell EMC Chassis. • • • • • • • • Status FQDD CacheSize FirmwareVersion Name PatrolReadState SecurityStatus SlotType Provides the worst case aggregate health status of the enclosure in Dell EMC Chassis.
Table 23. EqualLogic component health information Service Status Description Attributes Displayed Provides the worst case aggregate health status of the physical disks in the EqualLogic member. • • • • • • Status Slot Model SerialNumber FirmwareVersion TotalSize Dell EMC Storage PS-Series Group Volume Status Provides the worst case aggregate health status of the EqualLogic Group volume status.
Table 25. PowerVault MD warranty information Service Status • • • Description Warning Unknown Critical Attributes Displayed when using SNMP • • • • • Device Type Ship Date(UTC) Start Date(UTC) End Date(UTC) Days Remaining Table 26. Network Switch component health information Service Description Attributes Displayed when using SNMP Dell EMC Network Switch Fan The following states are Status possible: Provides the worst case aggregate Fan status of the Network Switch.
For more information about monitoring the health of the Compellent controllers, see the specific Dell Compellent Controllers User’s Guide at Dell.com/support. The Dell EMC Chassis enclosure status will display the Primary Status of the Enclosure only. For more information, see PowerEdge VRTX Chassis console or the PoweEdge VRTX chassis User’s Guide at Dell.com/support. NOTE: Table 27.
The services are displayed in the right pane. Monitoring SNMP alerts About SNMP alert monitoring You can asynchronously receive the SNMP alerts forwarded from the devices. Once an SNMP alert is received, the respective device’s service will display the alert summary message and alert severity of the last received alert in the Nagios Core console. Table 28.
Table 28. Dell EMC trap information (continued) Service Status Description Dell EMC Storage PS-Series Group Traps The following states are possible: Provides trap Information of the EqualLogic PS-Series storage Arrays.
7 Launching Dell EMC device specific consoles To launch console for a supported Dell EMC device: 1. In Nagios Core console, under Current Status, select any of the following: • • • Hosts Services Host Groups > 2. Click (Perform Extra Host Actions icon) adjacent to the Dell EMC device. The respective Dell EMC console is launched in a new window.
8 Warranty information for Dell EMC devices With this feature, you can access the warranty information for the discovered Dell EMC devices. This feature allows you to monitor the Dell EMC device’s warranty details in the Nagios Core console. An active Internet connection is required to retrieve the warranty information. If you do not have direct internet access and are using proxy settings to access the internet, ensure that you resolve the host name api.dell.com in the etc/hosts file.
• • You have an active Internet connection. The discovered device has a valid service tag. Once a device has been successfully discovered, its warranty information is displayed under the Status Information column. To view the details for a Dell EMC device, 1. Discover a Dell EMC device. 2. Click on the Warranty Information under services. The details for the selected device are displayed in the Service State Information page.
9 Removing Dell EMC devices You can remove a Dell EMC device that you do not want to monitor. 1. Navigate to /dell/config/objects, and delete the corresponding .cfg file. 2. For completing the removal of the Dell EMC device, restart the Nagios Core services by running the following command: service nagios restart.
10 Knowledge Base messages for the generated alerts You can get more information about the SNMP alerts generated by the discovered Dell EMC devices from the KB messages for that device in the Nagios Core console. Viewing KB messages To view the KB messages for an SNMP alert generated by a discovered Dell EMC device complete the following steps: 1. Log in to the Nagios Core console. 2. In the left pane, click on Services under Current Status. 3.
11 Troubleshooting This section lists the problems that you may encounter while using the Dell EMC OpenManage Plug-in for Nagios Core and their workarounds. Ensure that you meet the requirements, or perform the steps listed in this section. SNMP traps are not received from the Dell EMC devices in the Nagios Core Console for Ubuntu setup. Resolution :Replace #!/bin/sh to #!/bin/bash in /libexec/eventhandlers/submit_check_result and then, restart SNMPTT and Nagios service.
The discovery script is not creating the host and service definition file for IPv4 or IPv6 addresses or hosts 1. 2. 3. 4. OMSDK is installed. The IP addresses or hosts are reachable. SNMP or WSMan or Redfish is enabled on the given IP addresses or hosts. The appropriate protocol parameters are passed during discovery. The Dell EMC device’s IP address or host name changes after discovery of the device Remove the old configuration file and rediscover the Dell EMC device using a new IP address or hostname.
Dell EMC OpenManage Plug-in specific services are displaying the message, “Redfish Error while communicating with host” 1. Redfish is enabled on the IP addresses or Hosts. 2. The IP addresses or hosts provided are reachable. Dell EMC OpenManage Plug-in specific services are displaying the message, “Component Information = UNKNOWN” NOTE: This is an expected message if the component is not available in the discovered Dell EMC device.
Unable to view the KB information from the device trap after the Nagios Management Server IP address is changed The new IP address has to be updated in the following configuration files: • • • Dell_Agent_free_Server_Traps.conf Dell_Chassis_Traps.conf Dell_EqualLogic_Traps.
12 Frequently asked questions 1. Question: Can you provide information on Licensing of Dell EMC OpenManage Plug-in for Nagios Core? Answer: You can install and use this plug-in for free. 2. Question: What are the Dell EMC hardware models supported by the plug-in? Answer: For the list of supported Dell EMC platforms, see Support Matrix. 3. Question: I have earlier generation of servers (9th Generation – 11th Generation) in my data center.
A Appendix Configuring SNMP parameters for iDRAC using the iDRAC web console 1. Launch the iDRAC (12th and 13th generation of PowerEdge servers) web console and navigate to iDRAC Settings > Network > Services in the console. For 14th generation of PowerEdge servers Launch the iDRAC web console and navigate to iDRAC Settings > Services 2. Configure the SNMP Agent properties: a. Set Enabled to True and SNMP Protocol to All (SNMP v1/v2/v3). b. Set SNMP Community Name with a community string. c.
