Dell OpenManage Plug-in Version 1.
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. 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 © 2015 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents 1 Introduction to Dell OpenManage Plug-in Version 1.0 for Nagios Core............................................................................................................................ 5 2 Support matrix.......................................................................................................7 Dell PowerEdge Servers........................................................................................................................ 7 3 Device Discovery and Inventory........
The discovery script is not creating the host and service definition file for IPv4 or IPv6 addresses or hosts when the protocol selected is 2 (WS-MAN).......................................................24 The Dell device’s IP address or host name changes after discovery of the device......................... 24 The Nagios Core Console is not displaying the Dell devices that are discovered using the Dell discovery script......................................................................................
1 Introduction to Dell OpenManage Plug-in Version 1.0 for Nagios Core This guide provides information about using the Dell OpenManage Plug-in Version 1.0 for Nagios Core and its various features such as discovering, monitoring, launching consoles, and troubleshooting of the supported Dell devices. The guide also provides details of the supported Dell devices and frequently asked questions by the customer. The Dell OpenManage Plug-in Version 1.
Feature Functionality Launching iDRAC console Launches the respective iDRAC console to further troubleshoot and manage the supported Dell devices.
2 Support matrix Dell OpenManage Plug-in for Nagios Core supports the Dell devices listed in the following table. Dell PowerEdge Servers NOTE: In the PowerEdge server name format yxxx; y denotes alphabets, where M denotes Modular, R denotes Rack, T denotes Tower, and x denotes numbers.
Device Discovery and Inventory 3 About Device Discovery You can discover 12th and later generations of Dell PowerEdge servers with the Plug-in using agent-free method of discovery. You can opt for SNMP or WS-MAN protocol. At a time you can only discover a particular Dell device using SNMP or WS-MAN protocol and not both. You must use Dell Device Discovery Utility to discover Dell devices. If the discovery is successful, then for the discovered devices, host and service definition files are created.
Table 2. Dell Device Discovery Utility options Options Short Description Description -h help Use to view information about options. -H host Use to input IP address or fully qualified domain name (FQDN) of the host device. -S subnet Use to input subnet with mask. -F file Use to input filename with absolute path. The file must contain a list of IP addresses or FQDN of host devices separated by a new line. -P protocol Option for SNMP or WS-MAN protocol.
Table 3. Default services created based on selected protocol Services SNMP WS-MAN Protocol Dell Server Overall Health Status √ √ Dell Server Information √ √ Dell Server Traps (If SNMPTT integration is configured for Dell plug-in.
Table 4. Parameters File Protocol Communication Parameters Description SNMP snmp.version Use to input the SNMP version. Default version is 2. snmp.community Use to input the user macro for SNMP community string. snmp.retries Use to input the number of times an SNMP request must be sent when a timeout occurs . Default retry value is 1. snmp.timeout Use to input SNMP timeout value in seconds. Default timeout value is 3 seconds. snmp.port Use to input the SNMP port value.
To discover Dell servers: 1. Log in to Nagios Core with Nagios administrator privileges. 2. Navigate to the directory /dell/scripts. 3. Run the Dell Server Discovery Utility with options: perl dell_agent_free_server_discovery.pl or perl dell_agent_free_server_discovery.pl -h The script syntax and information on options are displayed. For more information see About Dell Discovery Utility.
• The discovered Dell servers are displayed in the Map view in the Nagios Core console. Device Information About Device Information The dell server information service provides the basic information about the system. By default this service is polled once a day. Table 5. Device Information Service Status Description Dell Server Information The following states are possible: This service provides the • basic device inventory • information.
2. To view the services associated with the hosts in the Nagios Core, select Services under Current Status. The services are displayed in the right pane.
4 Monitor Dell Devices Yon can monitor the following aspects of Dell devices. Overall Health You can monitor the Dell devices for their overall health status. About Overall Health Overall health status is an aggregate status of the components of the Dell devices. Overall health status of a device is polled periodically based on the configured interval. By default, the Dell Server Overall Health Status service is scheduled once an hour. Table 6.
Service Status Description Attributes Displayed when using WS-MAN Attributes Displayed when using SNMP • Chassis Intrusion • Storage NOTE: Status of Storage attribute is representative of cumulative health status of storage components like physical disk, virtual disk, controller, and so on. Viewing Overall Health Before you monitor the health of the discovered Dell devices in your data center environment, ensure that the discovered devices are reachable.
Service Dell Server Virtual Disk Status Dell Server Fan Status Status Description Attributes Displayed when using WS-MAN Attributes Displayed when using SNMP • Size (GB) • FreeSpace (GB) • FirmwareVersio • n FirmwareVersio n • Media Type • FreeSpace (GB) • Status • Status • FQDD • FQDD • State • State • Size (GB) • Size (GB) • WritePolicy • WritePolicy • ReadPolicy • ReadPolicy • Layout • Layout • StripeSize • StripeSize • Media Type • Media Type Status
Service Status Description Attributes Displayed when using WS-MAN CPUs in Dell servers. Dell Server Power Supply Status Dell Server Temperature Probe Status Dell Server Voltage Probe Status Dell Server Controller Status Dell Server Amperage Probe Status Dell Server SD Card Status 18 Provides overall Not Available health status of the power supply in Dell servers. Provides overall Not Available health status of the temperature probe in Dell servers.
Service Status Description Attributes Displayed when using WS-MAN SD card in Dell servers. • InitializedState • Size (GB) • AvailableSpace (GB) Attributes Displayed when using SNMP NOTE: Nagios console displays a component’s status as CRITICAL in the Status Information column when the actual status is Unknown.
Table 8. Server Trap Information Service Status Description Dell Server Traps The following states are possible: Provides trap Information of the Dell server raised through agent• OK free method. • Warning Displays the last received SNMP • Unknown alert. To view all the SNMP alerts • Critical that were received, select Reports → Alerts → History. Viewing SNMP Alerts Prerequisites: • Nagios Core with SNMPTT is installed and configured and the Dell integration on SNMPTT is configured.
Launching iDRAC Web Console 5 To launch console for an iDRAC device: 1. 2. In Nagios Core console, under Current Status, select any of the following: • Hosts • Services • Host Groups → Dell Agent-Free Servers Click (Perform Extra Host Actions icon) adjacent to the Dell device.
Removing Dell Devices You can remove a Dell 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 device, restart the Nagios Core services by running the command: service nagios restart.
Troubleshooting 7 This section lists the problems that you may encounter while using the Dell OpenManage Plug-in Version 1.0 for Nagios Core and their workarounds. Ensure that you meet the requirements, or perform the steps listed in this section. The Dell OpenManage Plug-in for Nagios Core installation script is failing 1. You have adequate permissions to run the script. Recommended: Nagios Administrator. 2. The prerequisites as mentioned in the Installation Guide are met. 3.
4. The appropriate protocol credentials are correctly configured in the following files before running a discovery: dell_resource.cfg .dell_device_comm_params.cfg 5. For an IPv6 address, ensure that the Perl Module Socket6 is installed in the same Perl library path. 6. At least one of the applicable service is enabled in the following service template: dell_server_services_template.cfg .
3. After you install SNMPTT, ensure that the Trap Integration is performed. To perform Trap Integration, from /dell/install, run the command: install.sh trap 4. Once the trap integration is complete, restart the SNMPTT service, run the command: service snmptt restart The Dell OpenManage Plug-in specific services are displaying the message, “Error while creating SNMP Session” 1. The recommended versions of Net-SNMP and Net-IP are installed.
2. The binary /libexec/eventhandlers/submit_check_result is present. 3. The trap configuration file Dell_Agent_free_Server_Traps.conf and the binary submit_check_result have appropriate permissions. The Overall Health status is not getting refreshed after receiving a Dell device alert If the Overall Health service is not created for a discovered Dell device, then the Dell device trap will not trigger an Overall health status.
Frequently Asked Questions 1. 8 Question: Can you provide information on Licensing of Dell OpenManage Plug-in for Nagios Core? Answer: You can install and use this plug-in for free. 2. Question: What are the Dell hardware models supported by the plug-in? Answer: For the list of supported Dell platforms, see Support Matrix. 3. Question: I have earlier generation of servers (9th Generation – 11th Generation) in my data center.
you to monitor SNMP alerts generated from Dell servers and supports one-to-one iDRAC web console launch to perform further troubleshooting, configuration, and management activities. Some of the capabilities provided here are not available in other plug-ins present on Nagios Exchange. 7. Question: What are the languages supported by the plug-in? Answer: The plug-in currently supports only English language.
A Appendix Configuring SNMP settings from web console 1. Launch the iDRAC (12th and later generation of Dell 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 V2c protocol.
