Dell EMC OpenManage Plug-in Version 2.
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. Copyright © 2017 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents 1 Introduction to Dell EMC OpenManage Plug-in Version 2.1 for Nagios Core................................................... 6 2 What is new in Dell EMC OpenManage Plug-in version 2.1............................................................................. 7 3 Key features.................................................................................................................................................. 9 4 Support matrix.............................................................
Configuring the Dell EMC warranty information parameters..................................................................................... 35 Viewing warranty information.........................................................................................................................................36 9 Removing Dell EMC devices.........................................................................................................................
Configuring SNMP trap destination address for iDRAC using RACADM ................................................................
1 Introduction to Dell EMC OpenManage Plug-in Version 2.1 for Nagios Core This guide provides information about using the Dell EMC OpenManage Plug-in Version 2.1 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 2.1 The following table lists the new features and functionality of the Dell EMC OpenManage Plug-in version 2.1: Table 1.
New Feature Description View Knowledge Base (KB) messages You can get more information about the SNMP alerts through the KB articles associated with those alerts. You can view the KB messages for 14th generation PowerEdge servers and HCI Platforms. 8 What is new in Dell EMC OpenManage Plug-in version 2.
3 Key features The key features of the Dell EMC OpenManage Plug-in Version 2.1 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. To discover Dell Servers through iDRAC with Lifecycle Controller, you can opt for either SNMP or WSMan protocol.
4 Support matrix Dell EMC OpenManage Plug-in version 2.1 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. 12th generation of PowerEdge servers 13th generation of PowerEdge servers 14th generation of PowerEdge servers FM120x4 C4130 R640 M420 C6320 R740 M520 FC230 R740xd M620 FC430 R940 M820 FC630 C6420 R220 FC830 R320 M630 R420 M830 R520 R230 R620 R330 R720xd R430 R820 R530 R920 R530xd T320 R630 T420 R730 T620 R730xd R830 R930 T130 T330 T430 T630 PowerEdge Chassis Table 6. Supported PowerEdge chassis.
Compellent SC-Series Storage Arrays Table 7. Supported Compellent Storage Arrays. Compellent Series 40 Compellent SC4020 Compellent SC8000 EqualLogic PS-Series Storage Arrays Table 8. Supported EqualLogic PS-Series Storage Arrays. EqualLogic PS4100 EqualLogic PS6100 EqualLogic PSM4110 EqualLogic PS6210 EqualLogic PS6500 EqualLogic PS6510 PowerVault MD-Series Storage Arrays Table 9. Supported PowerVault MD-Series Storage Arrays.
5 Device discovery and inventory Topics: • About device discovery • About Dell EMC device discovery utility • About protocol parameters • Discovering Dell EMC devices • Device information • Viewing Dell EMC devices in the Nagios Core console About device discovery You can discover the supported Dell EMC devices with this plug-in in the Nagios Core console.
About Dell EMC device discovery utility To run the Dell Device Discovery Utility, navigate to /dell/scripts, and run the following PERL script: perl dell_device_discovery.pl –h All the available Dell EMC device discovery utility options are displayed. perl dell_device_discovery.pl -H | -F | -S [-P ] [-c ] [-t ] [f] [-d] Table 10.
Based on the options you selected during discovery, the following services are associated with that host: • If you run perl dell_device_discovery.pl without the -d option, then only the basic services are created by default and displayed in the user interface under Services. NOTE: SNMPTT must be configured for you to be able to receive traps. • If you run perl dell_device_discovery.
Services Dell EMC Chassis I/O Module Status Dell EMC Chassis Power Supply Status Dell EMC Chassis KVM Status Dell EMC Chassis Enclosure Status (This service is applicable to PowerEdge VRTX Chassis only) Dell EMC Chassis Controller Status (This service is applicable to PowerEdge VRTX Chassis only) Dell EMC Chassis Physical Disk Status (This service is applicable to PowerEdge VRTX Chassis only) Dell EMC Chassis Virtual Disk Status (This service is applicable to PowerEdge VRTX Chassis only) Dell EMC Chassis PC
Table 15. Default services created for PowerVault MD-Series Storage Arrays based on SNMP protocol Services Basic Services Dell EMC Storage MD-Series MD Overall Health Status Dell EMC Storage MD-Series MD Information Dell EMC Storage MD-Series MD Traps Detailed Services Dell EMC Storage MD-Series Warranty Information Choosing the services to monitor for a Dell EMC device By default, all the available services are created for a Dell EMC device during discovery as supported by the protocol you have selected.
Protocol communication parameters Description WSMan wsman.username Use to input the user macro for WSMan service account user name. wsman.password Use to input the user macro for WSMan service account password. wsman.port Use to input the WSMan port value. Default value is 443. wsman.timeout Use to input WSMan timeout value in seconds. Default timeout value is 60 seconds. wsman.retries Use to input the number of times a WSMan request must be sent when a timeout occurs. Default retry value is 2.
• 4 For the -P option, Opt for a protocol: NOTE: Ensure that the IP list that you provide in the file is new-line separated. When prompted to confirm the discovery of the Dell EMC device (s), press Y and then Enter to continue. To exit the discovery process, press any other key followed by Enter or press Enter to exit. 5 Once the discovery utility script is run, verify the Nagios configuration by running the command /bin/nagios v /usr/local/nagios/etc/nagios.cfg.
Service Status Dell EMC Chassis Information • Critical • Warning Dell EMC Storage SC-Series Information Dell EMC Storage PS-Series Member Information 20 NOTE: Chassis Tag is applicable only for modular servers and Node ID is applicable only for PowerEdge FM120x4 The following states are possible: This service provides the basic device inventory information for • OK PowerEdge M1000e, PowerEdge • Unknown VRTX, and PowerEdge FX2/ FX2s chassis.
Service Dell EMC Storage PS-Series Group Information Dell EMC Storage MD-Series Information Status Description Attributes Displayed The following states are possible: This service provides the basic device inventory information for • OK EqualLogic Groups • Unknown • Critical • Warning The following states are possible: This service provides the basic device inventory information for • OK PowerVault MD-Series Storage • Unknown Arrays • Critical • Warning • RAID Status • Group Name • Group
2 To view the services associated with the hosts in the Nagios Core, select Services under Current Status in the left pane. The services are displayed in the right pane.
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.
Service Status Description Attributes displayed when using WSMan Attributes displayed when using SNMP • Amperage • Memory • Processor • Cooling Unit NOTE: Signifies the overall Fan redundancy status. • Storage • Chassis Intrusion • Fan NOTE: Signifies the overall Fan status without considering the redundancy status. Dell EMC Chassis Overall Health Status Provides global Overall Chassis health status of Dell EMC Chassis.
Health polling of servers is done through iDRAC with LC and the corresponding objects are shown in their respective health service with proper severity health color. Monitoring component health of Dell EMC devices You can monitor the health of individual components of the supported Dell EMC devices. About monitoring component health of Dell EMC devices This is a periodic poll based health monitoring of a Dell EMC device’s component level health status.
Service Status Dell EMC Server Fan Status Dell EMC Server Battery Status Dell EMC Server Intrusion Status Dell EMC Server Network Device Status Dell EMC Server CPU Status Dell EMC Server Power Supply Status Dell EMC Server Temperature Probe Status 26 Monitoring Dell EMC devices Description Provides overall health status of the fans in Dell EMC Server without considering the redundancy status. Provides overall health status of the battery in Dell EMC Servers.
Service Dell EMC Server Voltage Probe Status Dell EMC Server Controller Status Dell EMC Server Amperage Probe Status Dell EMC Server SD Card Status Dell EMC Server FC NIC Status Dell EMC Server Warranty Information Status Description Provides overall health status of the voltage probe in Dell EMC Servers. Provides the worst case aggregate health status of the storage controllers in Dell EMC Servers. Provides overall health status of the amperage probe in Dell EMC Servers.
Table 20. Dell EMC Chassis component health information Service Status Dell EMC Chassis Physical Disk The following states are possible: Status • OK Applicable only to PowerEdge • Warning VRTX chassis. • Unknown • Dell EMC Chassis Virtual Disk Status Applicable only to PowerEdge VRTX chassis.
Service Dell EMC Chassis Controller Status Applicable only to PowerEdge VRTX chassis. Dell EMC Chassis Enclosure Status Applicable only to PowerEdge VRTX chassis. Dell EMC Chassis IO Module Status Dell EMC Chassis Slot Information Dell EMC Chassis KVM Status Dell EMC Chassis Warranty Information Status Description Attributes Displayed when using WSMan Provides the worst case aggregate health status of the storage controllers in Dell EMC Chassis.
Service Status Description Attributes Displayed when using WSMan • Days Remaining Table 21. EqualLogic component health information Service Status Description Dell EMC Storage PS-Series Member Physical Disk Status The following states are possible: Provides the worst case aggregate health status of the • OK physical disks in the EqualLogic member.
Service Status Description Provides warranty information status for the Compellent storage arrays. Dell EMC Storage SC-Series Controller Warranty Information Attributes Displayed when using SNMP • • • • • • • • ServiceTag Service Level Details Item number Device Type Ship Date(UTC) Start Date(UTC) End Date(UTC) Days Remaining Table 23.
Monitoring component health status of Dell EMC devices To monitor the component health status of Dell EMC devices: 1 In Nagios Core user interface, under Current Status, select Services. 2 Select the associated service to monitor the health of Dell EMC device. Health monitoring of Dell EMC devices is performed through iDRAC with LC and corresponding details are shown in their respective component health service with proper severity health color.
Service Status Dell EMC Storage SC-Series Management The following states are possible: Traps • OK • Warning Dell EMC Storage SC-Series Controller Traps Dell EMC Storage MD-Series Traps • Unknown • Critical The following states are possible: • • OK Warning • Unknown • Critical The following states are possible: • • OK Warning • Unknown • Critical Description Provides trap information of the Compellent SC-Series storage Arrays Provides trap Information of the Compellent SC-Series storag
7 Launching Dell EMC device specific consoles To launch console for a supported Dell EMC device: 1 2 In Nagios Core console, under Current Status, select any of the following: • Hosts • Services • Host Groups > 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.
NOTE: While configuring the Warranty information parameters, ensure the following: • Provide positive numeric values only. In case any value other than a numeric is provided, the warranty information severity will be in the Unknown state while the warranty details will be displayed. • Do not change any of the other key values in the dell_pluginconfig.cfg file other than the numerical values.
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 (KB) 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.
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 failing to execute 1 The discovery script has appropriate permissions. Recommended: Nagios Administrator. 2 The appropriate arguments are provided while running the script. The discovery script is not creating the host and service definition file for IPv4 or IPv6 addresses or hosts when the protocol selected is 1 (SNMP) 1 Net-SNMP is installed. 2 The IP addresses or hosts are reachable. 3 SNMP is enabled on the given IP addresses or hosts.
The Nagios Core Console is not displaying the Dell EMC devices that are discovered using the Dell EMC discovery script 1 The host and service definition files exist in the /dell/config/objects folder. 2 The Nagios service has been restarted after running a discovery. 3 The host and service definition files have appropriate permissions.
3 The appropriate WSMan parameters are correctly configured in the following files: dell_resource.cfg .dell_device_comm_params.cfg 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. If the component is available and you are still receiving the message, then this message is due to protocol time-out.
1 Install JAVA. 2 Navigate to /dell/install, run the command: ./install.sh java 3 Restart Nagios Core services. 4 Rediscover the Dell EMC device. The Overall Health status is not getting refreshed after receiving a Dell EMC device alert If the Overall Health service is not created for a discovered Dell EMC device, then the Dell EMC device trap will not trigger an Overall health status.
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 later generation of PowerEdge servers) web console and navigate to Network > Services in the console. 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 Click Apply to submit the configuration. NOTE: The Plug-in communicates with iDRAC using only SNMP v1 or SNMP v2 protocol.
4 In the right pane, click on theSNMP and Email Settings tab and then perform the following actions: • In the IP Destination List section, populate the Destination Address fields as per your requirement and ensure that its respective State checkboxes are selected and then click Apply. • Configure the Community String and the SNMP Alert Port Number at the bottom of the IP Destination List section as required and then click Apply.