Dell EMC OpenManage Plug-in Version 3.
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. © 2020 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 3.1 for Nagios Core....................................... 5 2 What is new................................................................................................................................. 6 3 Key features................................................................................................................................ 8 4 Support matrix..................................................................................
11 Troubleshooting ....................................................................................................................... 48 12 Frequently asked questions........................................................................................................53 A Appendix...................................................................................................................................
1 Introduction to Dell EMC OpenManage Plug-in Version 3.1 for Nagios Core This guide provides information about usage of Dell EMC OpenManage Plug-in Version 3.1 for Nagios Core and features such as discovering, monitoring, launching consoles, and troubleshooting of the supported Dell EMC devices. Also providing details on the supported Dell EMC devices and frequently asked questions by the customer.
2 What is new Table 1. New features and functionality of Dell EMC OpenManage Plug-in version 31 New Feature Description Support for new Dell EMC devices With this version, you can discover and monitor the following new Dell EMC devices: • • • • • Dell EMC PowerEdge MX7000 Modular Chassis PowerVault ME4 Storage Arrays Support for iDRAC9 based PowerEdge servers OEM Servers Dell EMC Network Switches For more details on device support, see Support matrix in the "Dell EMC OpenManage Plug-in Version 3.
New Feature Description • • • • HCI Console Launch for HCI devices Dell EMC Network Switches Dell EMC OpenManage Enterprise Modular console for MX7000 PowerVault Manager console for ME4 devices View warranty information This feature allows you to view the warranty information for OEM servers, Dell EMC Network Switches, Dell EMC MX7000 Modular Chassis and ME4 Storage Arrays. View Knowledge Base (KB) messages.
3 Key features Table 2. key features of the Dell EMC OpenManage Plug-in Version 3.1 for Nagios Core 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. • • • • Discover of Dell EMC PowerEdge MX7000 modular chassis and Dell EMC Storage ME4 using Rest protocol. Discover iDRAC devices either using SNMP or WSMan protocol or Redfish protocol .
4 Support matrix Dell EMC OpenManage Plug-in version 3.1 for Nagios Core supports the Dell EMC devices as listed in the following tables. Table 3. Support for operating system Operating System RHEL 7.7 RHEL 8.0 Ubuntu 18.04.3 Ubuntu 16.04.3 SLES 15 SP1 and 12 SP4 Table 4. Support for Nagios core Nagios Core 3.5.1 4.4.5 Datacenter Scalable Solutions Table 5. Supported Datacenter Scalable Solutions.
VxRail Devices VxFlex Nutanix XC Devices VxRail P470F XC630-10 VxRail V470 XC730xd-24 VxRail V470F XC640-10 VxRail S470 XC740-12 VxRail E560 XC740-12C VxRail E560F XC740-12R VxRail G560 XC740-24 VxRail G560F XC640-4 VxRail P570 XC6420-6 VxRail P570F XC-940-24 VxRail P570 XC640-4 Xpress VxRail S570 XC730-16G XC730xd-12 XC730xd-12C XC730xd-12R XC6320-6AF XC430-8 XC630-10AF XC630-10P XC730xd-12R Xpress XC730xd-12S XC730xd-24 XC730xd-24S PowerEdge Servers Table 7.
12th generation of PowerEdge servers 13th generation of PowerEdge servers iDRAC 9 based PowerEdge servers R920 R730 R7415 T320 R730xd R7425 T420 R830 R240 T620 R930 R340 R720 T130 R740xd2 C6320p T330 R840 C6320 T430 R940XA R420xr T630 T140 C5230 T340 FC640 MX740C MX840C R6515 R6525 C6525 XR2 C4140 R7515 R7525 PowerEdge Chassis Table 8. Supported PowerEdge chassis.
EqualLogic PS-Series Storage Arrays Table 10. Supported EqualLogic PS-Series Storage Arrays. EqualLogic PS-Series EqualLogic PS4000 EqualLogic PS6000 EqualLogic PS4110 EqualLogic PS6010 EqualLogic PS4210 EqualLogic PS6610 EqualLogic PS4100 EqualLogic PS6100 EqualLogic PS6210 EqualLogic PS6110 EqualLogic PS6500 EqualLogic PS6510 PowerVault MD-Series Storage Arrays Table 11. Supported PowerVault MD-Series Storage Arrays.
S Series Z Series C Series FN Series M Series N Series S3124F Z9332F C9000 PowerEdge FN410T MX5108n N1148T MX9116n N1148P S3148 S3148P S3148F N1108T S3048 N1524 S4048 N1524P S4048-ON N1548 S6010-ON N1548P S5048F N2024 S3100 N2024P S3048 N2048 S4048T-ON N2048P S5048F-ON S4112F S4112T S4128F S4128T S4148F S4148T S4148U S4148FE S4248FB S4248FBL S5296F S5248F S5224F S5212F S5232F NOTE: MX5108n and MX9116n switches supports firmware version 10.5.0.
5 Device discovery and inventory Topics: • • • • About device discovery About Dell EMC device discovery utility Discovering Dell EMC devices Device information About device discovery The monitoring protocols for the supported Dell EMC devices are as follows: • • • • Dell EMC PowerEdge MX7000 modular chassis and PowerVault ME4 Storage Arrays are discovered using REST protocol. Dell EMC Servers are discovered using SNMP or WSMan protocol or Redfish protocol.
Table 14. Dell EMC Device Helper Utility options Options Description -h Displays the list of available options --host Host IP address or Host Name that are discovered. --File Provides a filename with path containing the IP addresses/ Hostname/Subnet with mask, which is 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.
Options Description --force --force rewrites the config file. --warranty.criticalDays Warranty critical days Allowed value is [1-365]. Default value is 10. NOTE: The value of Warranty critical days should be less than Warranty warning days. --warranty.warningDays Warranty warning days Allowed value is [1-365]. Default value is 30. --nagios.type Decides the output format of the host file Allowed options are 0 for .cfg format and 1 for .xml format. Default values are 0.
Services SNMP WSMan Protocol Redfish Protocol Dell EMC Memory Status √ √ √ Dell EMC Server Physical Disk Status √ √ √ Dell EMC Server Disk Group Status √ √ √ Dell EMC Server Fan Status √ √ √ Dell EMC Server Battery Status √ √ X Dell EMC Server Intrusion Status √ √ X Dell EMC Server Network Device Status √ √ √ Dell EMC Server Voltage Probe Status √ √ √ Dell EMC Server Controller Status √ √ √ Dell EMC Server Amperage Probe Status √ √ X Dell EMC Server CPU Status √
Services 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 Disk Group Status (This service is applicable to PowerEdge VRTX Chassis only) Dell EMC Chassis PCIe Devices Status (This service is applicable to PowerEdge VRTX Chassis and PowerEdge FX2/FX2s Chassis only) Dell EMC Chassis Management Module Status Dell EMC Chassis Temperature Probe Status NOT
Table 20.
GUI service name and component name The following table lists GUI naming and its component naming list for the respective host group Table 23.
Host Group Device Name NGM Dell EMC Storage EqualLogic Dell EMC Networking GUI Service Name Component Name Key attributes for excludeinstance Dell EMC Chassis Server Slot Information ComputeModule ServiceTag Dell EMC Chassis Storage Slot Information StorageModule ServiceTag Dell EMC Chassis Enclosure Status Enclosure FQDD Dell EMC Chassis Controller Status Controller FQDD Dell EMC Chassis Physical Disk Status PhysicalDisk FQDD Dell EMC Storage ME4 series Disk Group VirtualDisk FQDD
Host Group Device Name MDArray ME4 GUI Service Name Component Name Key attributes for excludeinstance Dell EMC Storage PS-Series Member Information Member Dell EMC Storage PS-Series Member Overall Health Status Member Dell EMC Storage MD-Series Traps Trap Dell EMC Storage MD-Series Information System Dell EMC Storage MD-Series Warranty Information warranty Dell EMC Storage MD-Series Overall Health Status System Dell EMC Storage ME4 Overall Health Status Subsystem Dell EMC Storage ME4 Tr
Host Group Device Name Dell EMC Networking F10 Nseries GUI Service Name Component Name Key attributes for excludeinstance Dell EMC Storage SC-Series Physical Disk Status Disk Name Dell EMC Storage SC-Series Controller Information Controller Dell EMC Storage SC-Series Overall Health Status System Dell EMC Storage SC-Series Controller Warranty Information warranty Dell EMC Storage SC-Series Controller Overall Health Status Controller Dell EMC Network Switch Traps Traps Dell EMC Network Switc
Host Group Device Name GUI Service Name Component Name Dell EMC Network Switch vFlash Status Flash Dell EMC Network Switch Physical Port Status Port Key attributes for excludeinstance Name Component Services To list added or to be added services for Host Level and Host Group Level The following command lists all the component services that are discovered only: • --listservices: Lists all the added or to be added services for monitoring To list added or to be added component services for discover
To add or remove component services for a discovered host Syntax: The following script or syntax helps user to add and remove services that are discovered: python dellemc_nagios_discovery_service_utility.py --host= -addservices= --removeservices= -output.file= Example: python dellemc_nagios_discovery_service_utility.py --host=100.98.67.123 -addservices="NIC,Disk,Controller" --removeservices="StorageEnclosure,VDisks" output.
NOTE: If the other Dell EMC discovery utility parameters are not passed, the command will run with default values. NOTE: Ensure that the Dell EMC device is discovered either using IP address or FQDN and not both at a given instance. 4. By default, Dell EMC Server is discovered using Redfish Protocol. If the WSMan protocol parameters are not passed in the command, the discovery will happen through SNMP. Based on your requirements, the value of --prefProtocol can be changed.
Service Dell EMC Chassis Information Status The following states are possible: • Dell EMC Storage SC-Series Controller Information The following states are possible: • Dell EMC Storage SC-Series Information OK OK The following states are possible: • OK Description Attributes Displayed Mode, iDRAC Group Manager Status and iDRAC Group Name is applicable only for 14G Servers • • This service provides the basic device inventory information for PowerEdge M1000e, PowerEdge MX7000, PowerEdge VRTX, P
Service Status Description Attributes Displayed Dell EMC Storage MD-Series Information The following states are possible: This service provides the basic device inventory information for PowerVault MD-Series Storage Arrays • • • • • • Dell EMC Storage ME4 Information The following states are possible: • Dell EMC Network Switch Information OK OK The following states are possible: • OK Overall Storage Array Service Tag Product ID Web URL Storage Name This service provides the basic • device i
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 Attributes displayed when using Redfish/ REST Dell EMC Chassis Overall Health Status NOTE: ME4 and MX7000 uses REST protocol Provides global Overall Chassis health status of Dell EMC Chassis. Not Available Overall Chassis Dell EMC Storage PSSeries Member Overall Health Provides global Not Available health status of EqualLogic Storage Arrays.
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. 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.
Service Status Description Attributes Displayed Attributes when using WSMan Displayed when using SNMP Attributes displayed when using Redfish the NIC in Dell EMC servers. • • • • • • • LinkSpeed FirmwareVersion ProductName • • • LinkSpeed FirmwareVersion ProductName FQDD LinkSpeed FirmwareVersion ProductName NOTE: FirmwareVersi on and ProductName attributes will display as Not Available.
Service Status Description Attributes Displayed Attributes when using WSMan Displayed when using SNMP Attributes displayed when using Redfish Dell EMC Server Amperage Probe Status Provides overall • health status of • the amperage • probe in Dell EMC servers. Status Location State • • • Dell EMC Server SD Card Status Provides overall health status of the SD card in Dell EMC servers.
Service Status Description Attributes Displayed Provides the worst case aggregate health status of the Disk Group s in Dell EMC Chassis.
Service Status Description Attributes Displayed • Slot Dell EMC Chassis Server Slot Information Provides the worst case aggregate health status of the Server slot in Dell EMC Chassis. • • • • • • Status SlotNumber HostName Model ServiceTag iDRACIP Dell EMC Chassis Storage Slot Information Provides the worst case aggregate health status of the Storage slot in Dell EMC Chassis.
Service Status Description Attributes Displayed • AssociatedPool Dell EMC Storage PS-Series Group Storage Pool Information Provides the worst case aggregate health status of all the EqualLogic storage arrays in a storage pool. • • • Name MemberCount VolumeCount Dell EMC Storage PS-Series Group Warranty Information Provides warranty information status for the EqualLogic storage arrays.
Service Status • • • • Dell EMC Storage ME4 Controller Description Attributes Displayed OK Warning Unknown Critical Provides storage controller information for the PowerVault ME4 storage arrays. • • • • • • Item number Device Type Ship Date(UTC) Start Date(UTC) End Date(UTC) Days Remaining • • Controller Service StorageControllerCodeVersi on HardwareVersion • ManufacturingDate Dell EMC Storage ME4 Fans Provides storage fan information for the PowerVault ME4 storage arrays.
Service Status Dell EMC Storage ME4 Volume Status Description Attributes Displayed Provides storage volume information for the PowerVault ME4 storage arrays. • • • View Manufacturingdate Name Table 32. 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.
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 33. Units and description Unit Description GHz Giga Hertz W Watt GB Giga Byte RPM Revolutions Per Minute A Ampere V Volts MB Mega Bytes By default, the preceding services are scheduled once every four hours.
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. Viewing Dell EMC devices in the Nagios Core console To view the Dell EMC devices in the Nagios Core console, ensure that the devices are already discovered and inventoried. You can view the discovered Dell EMC devices in Nagios Core in the Hosts or the Services view: 1.
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 34. Dell EMC trap information Service Status Description Dell EMC Server Traps The following states are possible: Provides trap Information of the Dell EMC Server raised through agent-free method.
Service Status • • • Dell EMC Network Switch Traps Warning Critical Unknown The following states are possible: • • • • Description OK Warning Critical Unknown Provides trap Information of the Dell EMC Network Switch. Viewing SNMP alerts Prerequisites: • • Nagios Core with SNMPTT is installed and configured and the Dell integration on SNMPTT is configured. SNMP Trap destination is configured with Nagios Core server in the supported Dell EMC devices.
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 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.
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. For example: To view the warranty service information for VRTX Chassis, click on Dell EMC Chassis Warranty Information.
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 that is 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 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. Nagios console displays "Error:: No response from Host: IP/hostname" on modifying passphrasee Resolution: If passphrase is changed, users needs to rediscover the devices.
excludeinstance=" operator ''"] Resolution: To show these instances, script is run with value for the other than For example : [- excludeinstance=" operator 'NA'"] 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.
OMSDK installation may fail with pip version 10.0 and above Resolution: Follow any one of the below step: 1. Downgrade pip version to lower than 10.0 and then install omsdk 2. To Force install omsdk using: pip install --ignore-installed omsdk-1.2.387-py2.py3-none-any.whl 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.
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.
