IBM FlashSystem. SNMP Guide

IBM FlashSystem SNMP Guide

IBM FlashSystem SNMP Guide

Note Before using this information and the product it supports, read the information in Notices on page 9. This edition applies to IBM FlashSystem and to all subsequent releases until otherwise indicated in new editions. Copyright IBM Corporation 2013. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents IBM FlashSystem SNMP Guide.......................... 1 SNMP configuration................................. 1 Enabling SNMP................................. 1 SNMP community strings.............................. 1 SNMP system information strings........................... 2 MIB file.................................... 2 Traps...................................... 2 Trap sink list.................................. 2 Enabling traps.................................. 2 Testing traps.................................. 2 Trap resending timeframe.............................. 3 Mailing traps.................................. 3 System traps.................................. 3 System message notification............................. 3 Environmental state notifications........................... 3 Temperature state notification........................... 4 Power state notification.............................. 4 Fan state notification............................... 5 Battery state notification............................. 5 Fibre Channel state notification............................ 6 Fibre Channel configuration notification......................... 6 InfiniBand channel state notification.......................... 7 InfiniBand channel configuration notification....................... 7 Logical unit notification.............................. 7 System state notification.............................. 7 Flashcard state notification.............................. 8 Flashcard health notification............................. 8 Notices.................................... 9 Trademarks................................... 10 Terms and conditions................................ 11 Copyright IBM Corp. 2013 iii

iv IBM FlashSystem : SNMP Guide

IBM FlashSystem SNMP Guide Learn about setting up, configuring, and using Simple Network Management Protocol (SNMP) on the IBM FlashSystem. The SNMP standards provide a framework for the definition of management information along with a protocol for the exchange of that information. Your storage system supports the SNMP Version 2c. The SNMP model contains managers and agents. A manager is a software module responsible for managing the configuration on behalf of the network management application users. Agents are devices, such as your storage system, that are responsible for maintaining local management information and delivering that information to a manager via SNMP. Both the manager and the agent can initiate management information exchanges. SNMP configuration Learn about initial SNMP configuration. You can configure the SNMP agent with the web management interface. For details about each of the following subsections, consult the Web Interface Guide. Table 1. Default SNMP configuration Feature Default setting Details SNMP community strings Read: Read Write: Read/write SNMP system information Description: Unconfigured strings Location: Unconfigured Contact: Unconfigured SNMP trap IPs None configured SNMP agent Enabled SNMP traps All enabled except the system message notification Enabling SNMP The default SNMP agent state is enabled. The enabled or disabled state is preserved through power cycles. When the agent is disabled, the system s SNMP object identifier (OID) tree is not available and no traps are sent for system events. SNMP community strings The SNMP community string is similar to a user ID or password that allows access to the system s SNMP information tree of object identifiers (OIDs). If the community string is correct, the system returns the requested information. If the community string is incorrect, the system discards the request and does not respond. Copyright IBM Corp. 2013 1

The types of community strings for the storage system follow: v The SNMP read-only community string enables a remote device to retrieve read-only information. v The SNMP read/write community string allows a remote device to read information and to modify settings. The default settings for the community strings are a read-only community string of read and a read/write community string of read/write. It is standard practice for network managers to change all the community strings so that unauthorized persons cannot see information about the internal network. SNMP system information strings The SNMP standards define how system information is reported by the agent. This information can be set through the web management interface. MIB file The Management Information Base (MIB) file is a database that describes a set of values that are defined for hardware nodes on the system. The network manager makes virtual connections to the storage system, which returns information to the manager regarding the device s status. The agent contains the MIB database. The system s MIB file is available for download through the SNMP panel on the web management interface. The manager uses this database to make requests to the agent and to interpret the information received from the system. Traps Traps are messages that are issued in response to system events. The storage system can be configured to send unsolicited messages to managers when it detects a significant event. The SNMP standard refers to this type of message as a trap. Trap sink list You can create a trap sink list to specify what hosts receive traps that are generated by the SNMP agent. A trap sink defines a host and a community string pair. When a trap event occurs, the SNMP agent sends a trap to each host in the trap sink list by using a community string. This community string is for host-side access to trap monitoring software, such as Net-SNMP s snmptrapd application, rather than the system s SNMP agent access. You can configure the trap sink list by using the SNMP configuration wizard on the web management interface. By default, no trap sinks are defined. Enabling traps You can individually disable or enable traps. The state for each trap state can be viewed and set through the SNMP Traps pane on the web management interface. Testing traps You can test the trap configuration to ensure that the trap function works when needed. 2 IBM FlashSystem : SNMP Guide

You can request the system to send out test traps for each of its trap types. This request ensures that the trap sinks are correct and that the receiving host is correctly configured. The test trap looks exactly like a trap for an actual system event, but with sample information. For example, the test trap for a system message notification sends the message This is a trap test. To initiate test traps, use the SNMP Traps pane on the web management interface. Trap resending timeframe Resending traps can aid in alerting administrators about a system issue. You can configure the system to periodically resend a trap message. For example, if a temperature sensor triggers a warning notification that is in regard to a temperature state, the system can resend this trap every few hours. This notification ensures that the warning state is not overlooked. Each notification type can be individually configured for the resend timeframe you want. You can edit these values by using the Traps pane in the SNMP panel on the web management interface. By default, traps are configured to have the periodic resend option turned off. Mailing traps You can configure the system to mail traps to aid in remote monitoring of the system. The system can send traps to specified email addresses. Email reports containing system event messages are sent periodically depending on their rate of occurrence. This function can be configured and enabled through the mail service option. To configure the mail service, use the mail service configuration wizard on the web management interface. System traps There are different types of SNMP V2 traps that are generated because of various system events. Each trap contains a time stamp, the trap OID, a brief message, and, if applicable, the relevant system object and state variable. Trap OIDs and definitions are in the MIB file. System message notification Learn about the system message notification trap. Table 2. System message notification Trap name systemmessagenotif Trap message A message that describes a change in the state. System message traps are general messages about the system. They range from warning messages or error messages about error-correcting code (ECC) events or power failures to informational messages that require no response. Environmental state notifications The temperature, power, fan, and battery notifications are all environmental notifications, and they have similar behavior. Each reports a state change in the overall state of the sensor group of that category. In most cases, if only one sensor changes to the warning state, the overall state becomes warning even when the remaining sensors are good. IBM FlashSystem SNMP Guide 3

The most common states are Good, Warning, and Error. When the overall state changes to the Error state, one or more sensors is in a Warning state and the system shuts down to prevent damage to system components. Another of the states is Not Present. This state means that a sensor is missing in the group. Other possible states are Test and Communication Error. The Test state usually indicates testing software is testing sensors in this group. When the periodic battery test is running, the battery overall state is Test. The Communication Error state means that the SNMP agent has failed to retrieve the overall state. Consult the event log or contact support to resolve the problem. For online support, see the IBM Support portal. Temperature state notification Learn about the temperature state notification trap. Use the following table to review the temperature state notifications. Table 3. Temperature state notification trap Trap name State variable name State variable values Variable meaning temperaturenotif trapenvstate -1 commerror An error occurred while reading the sensors states. 0 good All sensors are good. 1 warning One or more sensors are in the Warning state. 2 error One or more sensors are in the Error state. 3 notpresent One or more sensors are missing. 4 test The sensors are in the Test state. Also, the sensors are in the Trap test notification state. This trap indicates a change in the overall state of all temperature sensors. The temperature table OID to read the individual temperature sensor values and states is temperaturetable. If the overall state is Warning, the fans must be serviced or the system must be moved into a different environment. If the temperature goes into Error state, the levels are dangerously high and the system will shut down. Power state notification Learn about the power state notification trap. Table 4. Power state notification trap Trap name State variable name State variable values Variable meaning powernotif trapenvstate -1 commerror An error occurred while reading the sensors states. 0 good All sensors are good. 1 warning One or more sensors are in the Warning state. 2 error One or more sensors are in the Error state. 3 notpresent One or more sensors are missing. 4 test The sensors are in the Test state. Also, the sensors are in the Trap test notification state. 4 IBM FlashSystem : SNMP Guide

The storage system contains multiple sensors to measure voltages and currents throughout the system. The power state trap is an indication of the overall state of these sensors and follows the same format as the temperature trap. A Warning state means that some of the voltage or current levels are outside the specification range, or that ac power is lost. If a critical sensor goes into an Error state, the system shuts down to prevent damage. Fan state notification Learn about the fan state notification trap. Table 5. Fan state notification trap Trap name State variable name State variable values Variable meaning fannotif trapenvstate -1 commerror An error occurred while reading the sensors states. 0 good All sensors are good. 1 warning One or more sensors are in the Warning state. 2 error One or more sensors are in Error state. 3 notpresent One or more sensors are missing. 4 test The sensors are in the Test state. Also, the sensors are in the Trap test notification state. The fan trap indicates a change in the overall fan state. Unlike the other environmental groups, fans in most systems have built-in redundancy. If a single fan of a redundant group goes into a Warning or Error state (meaning it is stopped or reporting slow rotation speed), the overall state never goes beyond Warning. If a warning state persists, the fans might require service, but there is no immediate danger. However, if all fans of a redundant group are stopped or slowed, the overall state changes to Error. In this case, the system temperatures can rise to critical levels and cause a system shutdown. Battery state notification Learn about the battery state notification trap. Table 6. Battery state notification trap Trap name State variable name State variable values Variable meaning batterynotif trapenvstate -1 commerror An error occurred while reading the sensors states. 0 good All sensors are good. 1 warning One or more sensors are in the Warning state. 2 error One or more sensors are in the Error state. 3 notpresent One or more sensors are missing. 4 test The sensors are in the Test state. Also, the sensors are in the Trap test notification state. The battery sensors include the battery and charger voltages and currents, plus each battery s charge percentage. When the battery state is Warning, the batteries might be in use or charging because ac power is lost. If an Error notification is issued, the batteries might need to be serviced, or one or more of the batteries have voltages that threaten the system s ability to back up data in the event of a power loss. IBM FlashSystem SNMP Guide 5

Fibre Channel state notification Learn about the Fibre Channel state notification trap. Table 7. Fibre Channel state notification trap Trap name Trap object State variable name State variable values Variable meaning fcstatenotif The Fibre Channel port object trapfcstate -2 test The sensors are in the Trap test notification state. -1 commerror An error occurred while reading the sensors states. 0 none No state is available. 1 online One or more sensors is in the Warning state. 2 offline A device is plugged into the FC port, but the linkup procedure is not complete. 3 disabled The port is disabled. 4 no light Nothing is plugged into the FC port. The Fibre Channel state trap is sent when a Fibre Channel port s state changes. If the state changes to Disabled, it is likely that the system is powering off. Fibre Channel configuration notification Learn about the Fibre Channel configuration notification trap. Table 8. Fibre Channel configuration notification trap Trap name Trap message Trap object fcconfignotif A message that describes the state change The Fibre Channel port object This trap is sent whenever a Fibre Channel port s configuration is changed, such as a different topology or link speed. 6 IBM FlashSystem : SNMP Guide

InfiniBand channel state notification Learn about the InfiniBand channel state notification trap. Table 9. InfiniBand state notification trap Trap name ibstatenotif Trap object The InfiniBand port object State variable name State variable values Variable meaning trapibstate -2 test The ports are in the Trap test notification state. -1 unknown An error occurred while reading the port state. 0 none No state is available. 1 online The port is online and functional. 2 offline A device is plugged into the port, but the linkup procedure is not complete. 3 disabled The port is disabled. The InfiniBand channel state notification trap is issued when an InfiniBand port s state is changed. InfiniBand channel configuration notification Learn about the InfiniBand channel configuration notification trap. Table 10. InfiniBand channel configuration notification trap Trap name Trap message Trap object ibconfignotif A message that describes the state change The InfiniBand port object This trap is sent whenever an InfiniBand port s configuration is changed. Logical unit notification Learn about the logical unit notification trap. Table 11. Logical unit notification trap Trap name Trap Message lunnotif A message that describes the state change The logical unit notification trap is issued for events such as adding or removing a logical unit, resizing a logical unit, or changing its access policies. System state notification Learn about the system state notification trap. Table 12. System state notification trap Trap name Trap message Trap object systemstatenotif A message that describes the state change The system object relevant to the event The system state notification is sent when system operations start or complete. IBM FlashSystem SNMP Guide 7

Flashcard state notification Learn about the flashcard state notification trap. Table 13. Flashcard state notification trap Trap name Trap object State variable name State variable values Variable meaning fcardstatenotif The flashcard port object trapfcardstate -2 test The flashcards are in the Trap test notification state. -1 unknown An error occurred while reading the port state. 0 shutdown The flashcard is shut down. 1 starting The flashcard is starting. 2 formatting The flashcard is being formatted. 3 uninitialized The flashcard is uninitialized and must be formatted before it is usable. 4 good The flashcard is operational. 5 shutting down The flashcard is shutting down. 6 fault The flashcard is not readable or writeable. 7 read-only fault The flashcard is not writeable. 8 dstroying The flashcard is going through the dstroy process, which destroys all data on the card. The flashcard state notification trap is sent when the state of the flashcard is changed. Flashcard health notification Learn about the flashcard health notification trap. Table 14. Flashcard health notification trap Trap name fcardhealthnotif Trap object The flashcard object State variable name State variable values Variable meaning trapfcardhealthstate -2 test The flashcards are in the Trap test notification state. -1 unknown An error occurred while reading the health state. 0 good The health of the flashcard is good. 1 warning The health of the flashcard is degraded and service is required. 8 IBM FlashSystem : SNMP Guide

Notices This information was developed for products and services offered in the U.S.A. The manufacturer may not offer the products, services, or features discussed in this document in other countries. Consult the manufacturer's representative for information on the products and services currently available in your area. Any reference to the manufacturer's product, program, or service is not intended to state or imply that only that product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any intellectual property right of the manufacturer may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any product, program, or service. The manufacturer may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to the manufacturer. For license inquiries regarding double-byte character set (DBCS) information, contact the Intellectual Property Department in your country or send inquiries, in writing, to the manufacturer. The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: THIS PUBLICATION IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. The manufacturer may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to websites not owned by the manufacturer are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this product and use of those websites is at your own risk. The manufacturer may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact the manufacturer. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, IBM License Agreement for Machine Code, or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the Copyright IBM Corp. 2013 9

same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning products not produced by this manufacturer was obtained from the suppliers of those products, their published announcements or other publicly available sources. This manufacturer has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to products not produced by this manufacturer. Questions on the capabilities of products not produced by this manufacturer should be addressed to the suppliers of those products. All statements regarding the manufacturer's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. The manufacturer's prices shown are the manufacturer's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to the manufacturer, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. The manufacturer, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. The manufacturer shall not be liable for any damages arising out of your use of the sample programs. Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows: (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. If you are viewing this information in softcopy, the photographs and color illustrations may not appear. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml. INFINIBAND, InfiniBand Trade Association, and the INFINIBAND design marks are trademarks and/or service marks of the INFINIBAND Trade Association. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. 10 IBM FlashSystem : SNMP Guide

Terms and conditions Permissions for the use of these publications are granted subject to the following terms and conditions. Applicability: These terms and conditions are in addition to any terms of use for the IBM website. Personal Use: You may reproduce these publications for your personal, noncommercial use provided that all proprietary notices are preserved. You may not distribute, display or make derivative works of these publications, or any portion thereof, without the express consent of IBM. Commercial Use: You may reproduce, distribute and display these publications solely within your enterprise provided that all proprietary notices are preserved. You may not make derivative works of these publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of IBM. Rights: Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the Publications or any information, data, software or other intellectual property contained therein. IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by IBM, the above instructions are not being properly followed. You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations. IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE. Notices 11

12 IBM FlashSystem : SNMP Guide

Printed in USA