MGE IBM Tivoli Netview Integration kit Readme file /AC This text is extracted from the pdf User manual /AC Table of Contents 1 Introduction 2 Installation 3 UPS Supervision and Operation 3.1 UPS discovery 3.1.1 Automatic discovery (UPS with SNMP MIB) 3.1.2 Manual discovery (UPS without SNMP MIB) 3.2 UPS monitoring 3.2.1 UPS status 3.2.2 UPS configuration 3.3 Alarms 3.3.1 SNMP trap alarms 3.3.2 Threshold alarms 3.3.2.1 Polling and threshold alarm configuration 3.3.2.1.1 " MGEUPS " SmartSet declaration 3.3.2.1.2 MGE UPS SYSTEMS data collection activation 1 Introduction ============== This document is not a Tivoli NetView User's Guide but intends to describe how to install and use the SNMP Package for any MGE UPS SYSTEMS Uninterruptible Power Supply. This document will provide you with all the necessary information about how to install and configure the MGE UPS SYSTEMS Uninterruptible Power Supply and the Tivoli NetView network management platform. 2 Installation ============== The MGE UPS control software requires Tivoli NetView Release 7.1 and the Aix 5.1 Operating System. If not running, execute the command /usr/OV/bin/ovstart to start NetView applications. To install the application: * Log on the NMS station as root. * Create the /opt/NMS_UPS/ directory. * Copy the NNS_UPS.tar(.Z) file on the system under /opt/NMS_UPS/ directory. * Go to the /opt/NMS_UPS/ directory. * Uncompress the file using the " gunzip " and " tar " commands # mkdir /opt/NMS_UPS # cd /opt/NMS_UPS # gunzip NMS_UPS.tar.Z (Only for a file downloaded from www.mgeups.com) # tar xvf ./NMS_UPS.tar * Run the install command # ./install.sh Note: This product may be uninstalled when using the -remove option # ./install.sh -remove Warning: During uninstallation, some NetView original files will be converted back to their status before the package installation. The file list is printed at the beginning of the procedure, before a confirmation prompt. If the UPS have already been discovered, shut any NetView session down and execute the following command to force the symbol update: # cd /usr/OV/bin # ./ovstop netmon # ./ovtopofix -a # ./ovstart netmon # netview& 3 UPS Supervision and Operation =============================== 3.1 UPS discovery ----------------- 3.1.1 Automatic discovery (UPS with SNMP MIB) UPS discovered by NetView are displayed in the Internet/IP sub maps: * Under NetView, double click on the " IP Internet " icon * In the " IP Internet " sub map, double click on a sub-network containing UPSs * In the sub-net map double click on the segment containing the UPSs * Any UPS appears with the battery symbol (Green background means IP Communication is OK, Red color is displayed otherwise) 3.1.2 Manual discovery (UPS without SNMP MIB) UPS with no SNMP MIB (XML-Web Card or XML-@gent) but with an IP interface, may be manually configured to be displayed with the correct symbol. * In the NetView map, select the node corresponding to the UPS (same IP address or DNS name) * Right click and select the menu " Edit->Change Symbol Type " * In the "Change Symbol Type" window, select the symbol class "Device" and the "MGE_UPS" symbol. * Validate with " Ok " If the UPS Ethernet card has a Web Interface, it may be useful to have the " UPS Properties " menu selectable (WEB access home page). To do so, it is necessary to set the node field "vendor" to " MGE UPS SYSTEMS " : * Right click on the UPS symbol * Select the "Edit->Modify/Describe->Object" menu * In the " Object Description " window, select " General Attributes " and then the " View/Modify Object Attributes " button * In the " Attributes for Object " window, "vendor" field, select the " MGE UPS SYSTEMS " value * Press OK to Validate * Quit the " Object Description " window (OK button) * Check that the contextual menu " UPS Properties (Web) " is selectable (right click on the symbol) Important : For XML@agent, the URL home page for the "UPS properties" command must be change in the /usr/OV/registration/C/mg_web file. Please uncomment the following line: /* Command "/usr/OV/bin/netscapeRemote -raise -remote openURL'(\'http://$(/usr/OV/bin/nvUtil n $OVwSelections \"%Selection Name%\")/mgeups/default.htm\')'";*/ And comment this one: Command "/usr/OV/bin/netscapeRemote -raise -remote openURL'(\'http://$(/usr/OV/bin/nvUtil n $OVwSelections \"%Selection Name%\")/\')'"; 3.2 UPS monitoring ------------------ Any UPS with a SNMP card is manageable with NetView. Specific menus allows to : * Monitor performance data: Battery status, load * Display configuration information * Access to the UPS control Web page 3.2.1 UPS status Select a UPS in the NetView map (Right click on the symbol) The following menus are selectable in the menu bar " Monitor->UPS " option. These menus display graphs and tables of UPS specific data. For any UPS with Web/SNMP card, the " UPS Properties (web) " menu displays the UPS Web management page: The others menus display SNMP data: * "General ": UPS configuration * "Output Load ": Output Load graph * "Battery Level ": Battery Level graph * "Remaining Time ": Battery Remaining time graph * "Analysis ": display graph about: > "input": Input voltage and frequency > "output ": Output voltage and frequency > "environment ": Temperature, humidity * "Status ": display table about current status > "Battery ": battery status > "environment ": alarm status > "input ": input status > "output ": output status See the "Help->On Application" menu to get more details about the displayed data Example : 3.2.2 UPS configuration The menu bar "Administer->UPS" option displays UPS configuration data. The "Agent conf" menu displays the SNMP/HTTP configuration of the embedded agent The "Managers" menu shows the UPS manager table : 3.3 Alarms ---------- Two kinds of alarms are configured for MGE UPS SYSTEMS: * SNMP trap Alarms * Threshold Alarms 3.3.1 SNMP trap alarms SNMP trap alarms require a pre declaration of the management station in the UPS manager table. There are three ways to configure the UPS to send traps to the manager: a. The HTML page " UPS Properties->Manager Table" if the card supports it, b. The MIB Browser : Manual configuration example for manager number X: OID number Designation / Value 1.3.6.1.4.1.705.1.2.2.1.1.X Manager number = X 1.3.6.1.4.1.705.1.2.2.1.2.X Device number = 0 1.3.6.1.4.1.705.1.2.2.1.3.X Manager type = 9 (other). 1.3.6.1.4.1.705.1.2.2.1.4.X Protocol level = 4 (snmpv1) 1.3.6.1.4.1.705.1.2.2.1.5.X Manager description = "Tivoli Netview" for example 1.3.6.1.4.1.705.1.2.2.1.6.X Manager IP address = YYY.YYY.YYY.YYY format 1.3.6.1.4.1.705.1.2.2.1.7.X Community name = "public" for example 1.3.6.1.4.1.705.1.2.2.1.8.X Severity level = 2 for example 1.3.6.1.4.1.705.1.2.2.1.9.X Acknowledgement type = 2 (mgnoack) c. Telnet commands should the interface card supports it, The UPS SNMP traps are displayed in the NetView alarm browser, in the " UPS Events " category. Example : " upsOnBattery " trap 3.3.2 Threshold alarms To allow UPS monitoring even with no manager pre-declaration on the UPS (see § 3.3.1), a polling of the most critical data is pre-configured on the NetView station (see § 3.3.2.1 to make it operational). Polling is followed by a threshold comparison to generate an alarm if exceeded. Polled data (*) Threshold Message Severity 100 - upsmgBatteryLevel > 70 Battery level is low Critical UpsmgInputLineFailCause > 1 Bad Input Power status Critical 2 - upsmgBatteryFaultStatus > 1 Battery Fault Critical 2 - upsmgBatteryReplacement >1 Battery to be replaced status Critical (*) Name of the SNMP data with possible arithmetic expression applied before threshold comparison 3.3.2.1 Polling and threshold alarm configuration During installation, the application pre-configure the SNMP data polling. Polling is not activated by default. The effective start of the polling requires the following operations : * "MGEUPS" "SmartSet" declaration in the NetView database * MGE UPS SYSTEMS data collection activation 3.3.2.1.1 " MGEUPS " SmartSet declaration "MGEUPS" SmartSet declaration defines the UPS setup on the supervised network. This "SmartSet" limits the polling to the MGE UPS. * On the management station, select the " Tools->Data Collection and Threshold " menu: * Click on any MGE UPS SYSTEMS data collection (" BatteryReplacement " for example) * In the " Mib Object Collection Summary " window, click on the " Add " button * In the "List of SmartSets" window, click on the "Edit" button * In the " SmartSet Editor " window click on the " Add " button * Set the name to "MGEUPS" * In the "Definition 1" window, click on the "Modify" button (see above) * In the "Modify definition 1" window, select the "isMGEUPS" attribute and validate with the "OK" button. * Click on the "Ok" button to close the " Add SmartSet " window. * Click on the "Close" button to close the " SmartSet Editor " window 3.3.2.1.2 MGE UPS SYSTEMS data collection activation Pre configured data collections use a NetView SmartSet " MGEUPS " to limit the polling to MGE UPS's. After this SmartSet is declared (see § 3.3.2.1.1), MGE UPS SYSTEMS data collection can be activated: * On the management station, select the " Tools->Data Collection and Threshold " NetView menu : * Click on a MGE UPS SYSTEMS data collection: > " BatteryConsumed " > " upsmgInputLineFailCause " > " BatteryFault " > " BatteryReplacement " * Click on the " Resume " button, * Repeat the operation for the 3 others collect, * Click on the " OK " button to validate.