Network Management Station (NMS) Reference Guide

Transcription

1 Network Management Station (NMS) Reference Guide

2 Network Management Station (NMS) - Reference Guide 2 Network Management Station (NMS) - Reference Guide 2 All rights reserved. No part of this reference guide can be reproduced or transmitted by any means, electrical, mechanical, photocopying, recording or otherwise, without the expressed, written consent of American Power Conversion Corporation. No patent liability is assumed with respect to the use of any of the information provided within this reference guide. American Power Conversion assumes no responsibility for any errors or omissions within this guide. In addition, neither is any liability assume for any damages that may result from the use of the information contained within. Governing Law This statement shall be construed, interpreted and governed by the laws of the Commonwealth of Massachusetts. LICENSES & TRADEMARKS APC, Measure-UPS, PowerChute, and PowerNet are trademarks or registered trademarks of American Power Conversion Corporation. All other trademarks, product and corporate names are the property of their respective owners and used here for informational purposes only. Copyright American Power Conversion Corporation, 1996, 1997, 1998, 2000, All Rights Reserved. Reproduction in whole or in part without permission is prohibited. AMERICAN POWER CONVERSION CORPORATION APC Corporate 132 Fairgrounds Road P.O. Box 278 West Kingston, RI United States of America Toll Free (U.S. and Canada): Tel: Version 7 August, 2001

3 3 Contents Network Management Station (NMS) - Reference Guide 3 About This Guide 5 Who Should Read This Guide...5 Associated Documents... 5 Abbreviations...5 APC s Web Site... 5 NMS Configuration Overview 6 NMS Updates 7 Novell ManageWise 8 PowerNet MIB Installation...8 PowerNet MIB Browsing... 9 HP OpenView for UNIX Network Node Manager 11 General Considerations...11 PowerNet MIB Installation...11 Adding an Object to Network Map...12 Setting NMS to Monitor Thresholds...12 Displaying UPS Data in Graph Form...13 PowerNet MIB Browsing...13 Solstice SunNet Manager 15 General Considerations...15 PowerNet MIB Installation...15 Adding an Object to the Network Map...16 Setting the NMS to Monitor Thresholds...17 Displaying UPS Data in Graph Form...17 Using Command Line To Perform a SET...18 PowerNet MIB Browsing...18 HP OpenView for Windows 20 General Considerations...20 PowerNet MIB Installation...20 Loading Trap Definitions...21 PowerNet MIB Browsing...22 HP OpenView for Windows NT 23 General Considerations...23 PowerNet MIB Browsing...23

4 4 Network Management Station (NMS) - Reference Guide 4 Tivoli NetView for Windows NT 25 General Considerations...25 PowerNet MIB Browsing CA Unicenter TNG for Windows NT 27 Installing the PowerNet MIB...27 PowerNet MIB Browsing Cabletron SPECTRUM for Windows NT 28 Compiling the PowerNet MIB...28 Other SPECTRUM MIB Tools Window Functions...29 Cabletron SPECTRUM for Solaris 29 Importing the PowerNet MIB...29 Other SPECTRUM MIB Tools...30 Considerations for Other NMS Platforms 31 IBM NetView for AIX...31 Ungermann Bass NetDirector...31

5 5 Network Management Station (NMS) - Reference Guide 5 About This Guide This guide provides: An overview of NMS configuration process. MIB Installation information for some common NMS platforms. Who Should Read This Guide This guide is for anyone responsible for using an NMS SNMP browser to manage any APC UPS that connects to a network through APC PowerNet Agents or PowerNet Adapters. Associated Documents This guide is a reference to using an NMS SNMP browser to manage a UPS. For information on the PowerNet MIB, see the PowerNet Agents - MIB Reference Guide, which is included on the installation CD, in PDF format. For information about PowerChute plus, PowerNet Agents or PowerNet Adapters, see the appropriate User s Guides. Refer to your APC UPS Owners Manual for operational information for your specific UPS system. Copies of the appropriate PowerChute plus and PowerNet User s Guides are provided on the installation CD-ROM, in PDF format. Abbreviations This guide uses the terms Agent or PowerNet Agent as an informal reference to any of APC s PowerNet Agent applications, Adapter as an informal reference to any of APC s PowerNet Adapters, and PowerNet Manager as an informal reference to any of APC s PowerNet Manager applications. This guide also uses the term, server, to refer to any server, workstation or other device that can use any of APC s Agents, Adapters or PowerNet Managers. APC stands for American Power Conversion; MIB stands for management information base; NMS stands for network management system or station; OID stands for object identification; SNMP stands for simple network management protocol; UPS stands for uninterruptible power supply or source. APC s Web Site For more information on any APC product, please visit APC s web site at APC is continuously updating the information you can obtain from its web site, including its product documentation.

6 6 Network Management Station (NMS) - Reference Guide 6 NMS Configuration Overview To configure an NMS to monitor/control a UPS via its PowerNet Adapter/Agent: Procedures vary from NMS-to-NMS. If you are using an NMS described in this guide, refer to this guide's NMS-specific information. In all other cases, refer to your NMS documentation, to configure your NMS. 1) Add Adapter IP address, or Agent IP/IPX address, to network files: Add address, and any alias, to appropriate configuration files, or to domain-name server. See your specific operating system's documents for more detail. 2) Add UPS to network management map: Create a manageable object for Adapter/Agent's UPS. This step is not needed if NMS automatically identifies new nodes as they initialize. 3) Load PowerNet MIB: If an APC PowerNet Manager is not available, or you want to use the NMS MIB browser, the information the NMS can access from the UPS through its Adapter/Agent is defined by the PowerNet or RFC1628 MIB OIDs. The PowerNet MIB, RFC1628, or both, must be loaded at each NMS that will monitor a UPS through that UPS's Adapter/Agent. These MIBs are on disks sent with the Adapter/Agent and are also available on the Enterprise Managment CD-ROM. This file briefly describes loading MIBs on some common NMSs. NMSs have differences in how they load and configure a MIB: See your NMS documents for more detail; See APC's PowerNet MIB Reference Guide (included on the installation CD in PDF format) for detail on PowerNet and RFC1628 MIBs. Also, since the new PowerNet MIB can have OIDs not in previous MIB releases, older PowerNet MIB versions/files, must be removed before compiling the new PowerNet MIB.

7 7 NMS Updates Network Management Station (NMS) - Reference Guide 7 APC updates documentation periodically to describe new products or improvements in older products. However, NMS vendors regularly update products to enhance operation or fix known bugs. APC documentation cannot always reflect those changes immediately. Therefore, APC includes Release Notes with its PowerChute plus and PowerNet products that provide the most recent information available to APC regarding its product interactions with a specific NMS. NMS information provided by APC is for reference only: NMS information can become outdated at any time. Refer to your NMS documents for more detail on information in this file, or in APC Release Notes. Special Note about APC's PowerNet Management Applications: If you use any of the following NMS platforms, you may want to use the PowerNet manager which APC developed for your NMS to make management of PowerNet Adapters/Agents much easier than using NMS MIB browsers: Cabletron Spectrum for Windows NT Cabletron Spectrum for Solaris Tivoli NetView for Windows NT CA Unicenter TNG for Windows NT Novell ManageWise IBM NetView for AIX (formerly NetView/6000 ) HP OpenView for UNIX Network Node Manager HP OpenView for Windows HP OpenView for Windows NT Solstice SunNet Manager APC's management applications display status and power quality in user-friendly, graphical formats, while pull-down menus make UPS configuration and diagnostic testing simple to perform.

8 8 Network Management Station (NMS) - Reference Guide 8 Novell ManageWise This section provides information on how to: Install APC's PowerNet MIB OIDs. Browse PowerNet MIB OIDs. See your Novell documents for more detail. PowerNet MIB Installation To install the PowerNet MIB on a NetWare workstation: 1) Insert DOS PowerNet MIB disk in disk drive. 2) From Windows Program manager: a) Double-click the main Program group. b) Double-click the File Manager icon. c) Open the nms\snmpmibs\current subdirectory, and: 1) Delete any older APC MIB files, or move them to \nms\snmpmibs\allmibs subdirectory. 2) Copy the powernet.mib file into the subdirectory. d) Open nms\snmpmibs\profiles subdirectory, and: 1) Delete any older APC profiles (*.prf files). 2) Copy the APC profiles file into this subdirectory. e) Exit File Manager. 3) From Windows Program manager: a) Double-click Novell-NMS Program group. b) Double-click Novell Management System icon. c) Select SNMP MIB Compiler... in the Tools menu. d) When the SNMP MIB Compiler dialog box appears, click Compile. The NMS workstation can now use the compiled powernet.mib file to control and monitor an APC UPS through its Adapter or Agent.

9 9 Network Management Station (NMS) - Reference Guide 9 PowerNet MIB Browsing The Novell SNMP MIB browser allows you to verify that data can be received from the Adapter/Agent. Although you can install the PowerNet MIB before you install an Adapter/Agent, you cannot browse Adapter/Agent PowerNet MIB OIDs until the Adapter/Agent is installed, configured and on the network. From the Novell Management System program: 1) Select SNMP MIB Browser... in the Tools menu. 2) When SNMP MIB Browser dialog box appears, select SNMP Adapter (by IP address) or SNMP Agent (by IP or IPX address): a) Click the circle beside IP (or IPX) in the agent box to select for IP (or IPX) address. b) Use the scroll bar beside the IP (or IPX) Address: box to look at listed addresses. c) If the desired address is listed, select that address. d) If the address is not listed, select any address in the Address: box, then type in the new address. This address remains displayed unless you select another address. It is added to the list when you exit dialog box. 3) Go to Step 4, to create a profile to be used to poll the PowerNet Adapter/Agent, or to Step 5, to select an existing profile. 4) To create a profile: a) Click Add in dialog box's Profile section. b) When the SNMP Profile Editor dialog box appears, select Group, Table, or Scalar in the Category box, depending on the type of data you want to look at when using the MIB browser. Build the profile using only one category: Group, Table, or Scalar. Do not combine category selections. c) In the Choices: box, use the scroll bar to find a selection to use. d) Highlight the selection. e) Click Add to add the selection into the display window to right of the Add button. f) Repeat steps c through e to add other selections. To remove an unwanted entry from selections display window, highlight selection and click Remove. g) When all selections are added, name the new profile: 1) Click the Profile Name: box. 2) Type in an up to 8-character name. h) If you want to perform SETs to the Adapter/Agent that uses the new profile, make sure the string specified in the Community: box allows for write access. i) To set up the profile to continuously poll the Adapter/Agent:

10 10 Network Management Station (NMS) - Reference Guide 10 1) Click the Polled circle. 2) Select 15 in Poll Interval box pull-down menu. Selecting 15 will cause the least amount of timing problems. j) Click Save to exit to the MIB Browser dialog box. k) Type the description into the Description of Selected Profile: window. 5) Scroll through Directory:...\snmpmibs\profiles to select profile to be used for the Adapter/Agent (either a profile created in step 4, or a previously existing profile). 6) Click OK to exit the dialog box while saving the changes/selections made in steps 2 through 5. 7) When the browser table for selected Adapter/Agent appears, perform a SET (Step 8) and a GET (Step 9) to verify that the Adapter/Agent is communicating with Novell NMS. If the community name used by the NMS does not match the Adapter/Agent's community name, a GET results in the error message: No Response. This message also occurs when a GET is sent to an Adapter/Agent that is not on line. 8) To perform a SET: a) If the red traffic-light icon is lit (polling), click that icon to stop the polling. The green traffic-light should light. Polling must stop before doing a SET. If not, Novell responds to a SET attempt with: "A SET operation is not allowed while polling, please disable polling." b) In the Attribute Value list, click the value listed for the Attribute Name you want to change, and press <Enter>. Not all attributes can be SET: Many are read-only. If a read-only attribute is selected above, Novell responds with an error message. Also, you must select from the Attribute Value list, and not from the Attribute Name list. Otherwise, Novell responds with: "Please select a valid column." c) When the Edit Attribute Value dialog box appears, select a value (if a pull-down menu is available), or type in a value, and then click OK. The community name used for the SET must match the Adapter/Agent's assigned community name. If not, this error message box appears: "The Set failed [nosuchname ] attribute (attributename) could not be set." If this message appears, click the lock icon, change the community name and then retry the SET. d) At this point the selected attribute should be highlighted. Click the hand icon to perform the SET. If hand icon does not gray out (become inactive), the SET failed. ManageWise will generate a failure alert. Close browser table window, and redo step 3 on, to retry MIB browsing. 9) To verify the SET performed in step 8, perform a GET, as follows: a) Click the green traffic-light icon to restart the polling. b) Observe the attribute changed in step 8 to verify the value has changed.

11 11 Network Management Station (NMS) - Reference Guide 11 HP OpenView for UNIX Network Node Manager This section provides information on how to do the following: Install APC's PowerNet MIB OIDs. Add a UPS (or Adapter) to network management map. Set NMS to monitor thresholds. Display UPS data in graph form. Browse PowerNet MIB OIDs. General Considerations This section s procedures do not need to be performed if the workstation has APC's PowerNet Manager for UNIX installed, unless you plan to also use the NMS MIB browser to browse PowerNet MIB OIDs. The PowerNet MIB procedures in this section, with the minor changes noted in the procedure, can be used to install and browse the PowerNet MIB on IBM NetView for AIX. PowerNet MIB Installation To install PowerNet MIB on an HP OpenView for HP-UX or IBM NetView for AIX, perform the following steps: 1) Log into the workstation as super user and insert the tar-formatted UNIX PowerNet MIB disk into disk drive. 2) Create a temp directory (unless one exists) using the mkdir command. For example: mkdir/usr/temp<enter> 3) Type tar xvf/dev/(name of disk drive)<enter> to copy the powernet.mib file from the disk drive into the temp directory. For example: tar xvf /dev/rfd0 powernet.mib<enter> copies file from raw floppy device 0. If installing the powernet.mib on an NMS that has existing powernet.mib files, when the NMS asks you if you want to write over older versions, click OK. 4) Start the NMS program: a) Type cd /usr/ov/bin<enter>. b) Type./ovw<Enter>. Type./nv6000<Enter> for IBM NetView for AIX. 5) Select Load/Unload MIBs: SNMP... from the Options menu. 6) When the Load/Unload MIBs dialog box appears, click Load... 7) Enter the path to the temp directory that the PowerNet MIB file was copied into, followed by powernet.mib. For the example here: /usr/temp/powernet.mib. 8) Click OK. If installing the powernet.mib on an NMS that has existing powernet.mib files, when the NMS asks you if you want to write over older versions, click OK. The NMS can now use the compiled powernet.mib file to control and monitor a UPS through its Adapter/Agent.

12 12 Network Management Station (NMS) - Reference Guide 12 Adding an Object to Network Map A newly installed Adapter needs to be added to the management map (if the map has not discovered the Adapter automatically already): 1) Bring up the submap in which you wish to place the Adapter. 2) From the menu, select Edit: Add Object. 3) Select the appropriate object type from the group of available objects. 4) Using the middle mouse button, drag the generic symbol subclass device to the submap. When the Add Object dialog box appears, enter a name for the Adapter in the Selection and Label fields. Setting NMS to Monitor Thresholds The NMS can be setup to notify you if defined UPS conditions change, such as whether or not UPS is on battery. This is outside of the normal traps sent by the Adapter/Agent to notify the NMS of operational conditions. For example, to set NMS up to monitor a UPS's time on battery threshold: 1) Select Data Collection and Thresholds: SNMP... from the Options menu. 2) In the MIB Data Collection dialog box, double-click the following to select each, in the order given: a) private (from directory, mgmt, experimental and private) b) enterprises (only entry) c) apc (from variable listing) d) products (from products and apcmgmt) e) hardware (from hardware, software and system) f) ups (from ups, measureups and minisnmpadapter) g) upsbattery h) upsbasicbattery i) upsbasicbatterytimeonbattery 3) Enter an instance of 0 and click OK. 4) Enter the host name (or IP address) in the Source field, and click Add. 5) To be notified when the UPS is running on battery for more than 5 seconds, chose the following and click OK: a) Don't store check threshold b) Polling interval = 5s c) Threshold >5 6) Click OK in the MIB Data Collection dialog box. To verify the upsbasicbatterytimeonbattery threshold setting, pull the plug on the UPS. After about 5 seconds, the event will be recorded in the Threshold Event Log. Similar thresholds can be set for upsbasicbatterystatus and upsadvtestdiagnosticsresults.

13 13 Network Management Station (NMS) - Reference Guide 13 Displaying UPS Data in Graph Form UPS data can be displayed as a graph. For example, to graph the UPS input voltage: 1) From the Monitor menu select MIB values: Browse MIB: SNMP. 2) When the SNMP MIB Browser dialog box appears, double-click the following to select each, in the order given: a) private (from directory, mgmt, experimental and private) b) enterprises (only entry) c) apc (from variable listing) d) products (from products and apcmgmt) e) hardware (from hardware, software and system) f) ups (from ups, measureups and minisnmpadapter) g) upsinput h) upsadvinput i) upsadvinputlinevoltage 3) Once upsadvinputlinevoltage is selected, click Graph. The input voltage will now be graphed in a separate dialog box. PowerNet MIB Browsing The HP OpenView Network Node Manager management system's MIB browser allows you to use SETs and GETs to control and monitor the Adapter, UPS and Measure-UPS (if attached to the UPS), as well as to verify that data can be received from a newly installed Adapter. You can install the PowerNet MIB before you install a PowerNet Adapter or agent, but you cannot browse PowerNet MIB OIDs for a PowerNet Adapter or agent until MIB is installed. Also, a reception failure-type message will be received when an attempt is made to browse the PowerNet MIB if that MIB has not been compiled by HP OpenView. From the HP OpenView Network Node Manager management system program: 1) Double-click the IP Internet symbol. 2) Double-click the symbol of network segment to be browsed. 3) Single-click the symbol for Adapter/Agent to be browsed. 4) Select the MIB Browser: SNMP... option from the Tools menu. 5) When the SNMP MIB Browser dialog box appears, double-click, or click once and use Down Tree button, to select the following, in the order given: a) private (from directory, mgmt, experimental and private) b) enterprises (only entry) c) apc (from variable listing) d) products (from products and apcmgmt)

14 14 Network Management Station (NMS) - Reference Guide 14 e) hardware (from hardware, software and system) f) ups (from ups, measureups and minisnmpadapter) 6) The MIB Object ID box now displays the following major OID groups: upsident upsconfig upsbattery upscontrol upsinput upstest upsoutput upscomm 7) Enter the community name to be used for the GET command in the community name field. 8) Select the group (as listed in step 6) or a specific OID you want to use for the GET command: a) For all of a group's OID values, click that group, then click Start Query. b) For just upsbasic or upsadv group OID values, double-click the group (or click once and then click the Down Tree button), click the advanced or basic subset, then click Start Query. c) For a specific OID, use the mouse and the Down Tree button to move down selections until only that OID is displayed, then click Start Query. 9) When an OID value is displayed in the MIB Values box, a SET can be performed: A time out message appears in the Messages section of the dialog box if the PowerNet Adapter/Agent is not communicating with the NMS, or if the GET community name used by an NMS SET does not match the case-sensitive community name assigned to the UPS PowerNet Adapter/Agent. If the problem is due to an incompatibility in community names, use the Community Name box to correct. a) Click the OID value in the MIB Values box. b) When the value appears in the SNMP Set Value box, use the mouse and keyboard to change that value. If selected value does not appear in the SNMP Set Value box, then it is a read-only OID, and a SET cannot be done. If you are unsure of what values are allowed for an OID, click Describe. If you are performing the SET following a GET done at an individual OID level (as described in step 8c), a Describe MIB Variable dialog box appears that identifies the allowable values, or directs you to the applicable table to look up the values. Use step 8, if needed, to access the Describe MIB Variable dialog box. 10) Once a new value is entered in the SNMP Set Values block, click Set. If a SET supplies an unacceptable value, a parsing-type error is reported in the Messages box. If this problem occurs, redo step 8 using an allowable value. 11) Use step 8 to verify the OID data changed by doing a SET at any level (group down to individual) to display the current value in the MIB Values box. 12) Repeat steps 8, 9 and 10 to GET or SET any other UPS OID values.

15 15 Network Management Station (NMS) - Reference Guide 15 Solstice SunNet Manager This section provides information on how to do the following: Install APC's PowerNet MIB OIDs onto a SunNet Manager workstation. Add a UPS (or Adapter) to network management map. Set SunNet Manager to monitor thresholds. Display UPS data in graph form. Browse PowerNet MIB OIDs. See your SunNet Manager documentation for more detail on subjects covered in this section. General Considerations SunNet Manager does not use a direct copy of APC's PowerNet MIB. The PowerNet MIB must first be copied from the disk to a temporary directory using a tar format statement, then converted for use by SunNet Manager by running a schema file. PowerNet MIB Installation To install the PowerNet MIB on a SunNet Manager workstation: 1) Insert UNIX PowerNet MIB disk into disk drive. 2) Change the directory, as follows: cd /opt/sunwconn/snm/agents<enter> 3) Copy the powernet.mib file from disk drive into new directory. For example: tar xvf /vol/dev/aliases/floppy0 powernet.mib<enter> copies the file from floppy drive 0. 4) Run mib2schema on the powernet.mib file to create the necessary powernet.mib.* files. Typing../bin/ mib2schema powernet.mib<enter> creates: powernet.mib.oid powernet.mib.schema powernet.mib.traps 5) Run../bin/build_oid<Enter>.

16 16 Network Management Station (NMS) - Reference Guide 16 Adding an Object to the Network Map An element can be added to the network map in three ways: 1) It can be added to same submap as the device it is powering, thus appearing next to that device. 2) It can be added to subview of the device it is powering, and the device can inherit the status of the UPS. 3) It can be added to a separate UPS view (or cloud) where all UPS elements would reside. To add a UPS glyph to a submap (or subview): 1) Access the device submap or subview, or UPS view, into which you want to place the UPS element. To create a UPS view submap: a) Enter the submap in which you want the UPS view to appear. b) From the Edit menu, use the right-most mouse button to select Create, View and Subnet, in that order. 2) From the Edit menu, use the right-most mouse button to select Create, Component and lanbox, in that order. 3) When the Properties dialog box appears, identify the Adapter as follows: a) Enter the SNMP RdCommunity name. The default name is public, all lowercase. b) Enter the SNMP WrCommunity name. The default name is private, all lowercase. c) Enter name of the PowerNet Adapter, as specified in /etc/hosts, or on the name server. 4) Once the Adapter is fully identified, scroll down in the top section of the Properties dialog box until the SNMP Vendor Proxy parameter appears: a) Select PowerNet-MIB. Make sure the MIB version matches the version of the PowerNet Agent running on the PowerNet Adapter. b) Scroll down and select snmp-mibii and ping. c) Select a color. d) Click Apply. 5) Repeat the above steps to add any other elements to the network maps.

17 17 Network Management Station (NMS) - Reference Guide 17 Setting the NMS to Monitor Thresholds The SunNet Manager platform can be setup to notify you if defined UPS conditions change. This is outside of the normal traps sent by the Adapter or Agent to notify the NMS of operational conditions. For example, to set a threshold for the UPS going on battery: 1) Use the right-most mouse button to select the UPS to be monitored. 2) Chose Event Report, PowerNet-MIB and upsbasicbattery. 3) When the Event Report Request Properties dialog box appears: a) Enter a name for the threshold monitor process. b) Set the Interval to how often you want to check the condition. c) Under Attribute, select upsbasicbatterytimeonbattery. d) For Relation 1, select Not Equal To. e) For Threshold 1, enter 0. f) Set Priority to Medium. g) Click Apply. h) Click Start. 4) Enter an instance of 0 and click OK. To verify the threshold setting, pull the UPS plug. The UPS status icon should change to on-battery, its composite status indicator message should also report On Battery, and the UPS alarm should beep. The on-line line status icon and the On Line composite status message conditions should return within moments of plugging the UPS back in. Similar thresholds can be set for upsbasicbatterystatus and upsadvtestdiagnosticsresults. Displaying UPS Data in Graph Form UPS data can be displayed as a graph. For example, to graph the UPS input voltage: 1) Use the right-most mouse button to select the UPS glyph. 2) Chose Data Report, PowerNet-MIB and upsadvinput. 3) When the Data Report dialog box appears: a) Enter a name for the graph monitor process. b) Set the Interval to 5 (or however often you want to sample data). c) Under Attribute, use the left mouse button to select upsadvinputmaxlinevoltage. d) Under Graph Tool, select Absolute Values. e) Click Apply. f) Under Attribute, use the left mouse button to select upsadvinputminlinevoltage. g) Click Apply. 4) Click Start. A graph of minimum and maximum voltages appears.

18 18 Network Management Station (NMS) - Reference Guide 18 Using Command Line To Perform a SET If you need to perform a SET to a PowerNet MIB OID without using the SunNet Manager's graphical unit interface (GUI) application, you can use the command line. The following is an example of a command line SET to reboot a UPS at IP address : snm_cmd -S 2 -t g upsadvcontrol -n upsadvcontrolrebootups -f powernet.mib Before you can use the command line as shown above, you must add the following line to the snmp.hosts file: public private 10/opt/SUNWconn/snm/agents/powernet.mib.schema PowerNet MIB Browsing The SunNet Manager management system allows you to verify that data can be received from the installed PowerNet Adapter or Agent in two ways: Using a SunNet Manager Console: Quick Dump Report that reports values for a selected OID category without the option to change (using SETs) those values. Using a SunNet Manager - Set: dialog box that allows you to use GETs and SETs. SunNet Manager Console: Quick Dump Report To access a SunNet Manager Console: Quick Dump Report for a specific OID category, from the SunNet Management workstation: 1) Open the SunNet Manager application. 2) Double-click the network map glyph (icon) for the network segment that contains the icon for the APC PowerNet Adapter's UPS. 3) Click the icon for the APC UPS to be browsed. For this step, you must use the right-most mouse button. For steps that follow, you can use any mouse button. 4) Click the Quick Dump option in menu that appears. 5) Click PowerNet-MIB in menu that appears. 6) Click the UPS OID category that contains the OID value(s) you want to browse in the list that appears. SunNet Manager responds by reporting values for all OIDs in the selected group in the SunNet Manager Console: Quick Dump Report. Some categories have only one OID.

19 19 Network Management Station (NMS) - Reference Guide 19 SunNet Manager - Set: Dialog Box To access the SunNet Manager Console - Set: dialog box, from the SunNet Management workstation: 1) Open the SunNet Manager application. 2) Double-click the network map glyph (icon) for network segment that contains icon for the APC PowerNet Adapter's UPS. 3) Use the right-most mouse button to click the icon for the APC UPS to be browsed. For this step, you must use the right-most mouse button. For steps that follow, you can use any mouse button. 4) Click the Set Request option in menu that appears. 5) Click PowerNet-MIB in menu that appears. 6) In the list that appears, click the UPS OID category you want to browse. 7) When the SunNet Manager Console - Set: dialog box appears, it lists the OIDs under Attribute Name: in a 3- column report box, but it does not identify any OID values. Click Get to have SunNet Manager list the current values (under Current Value:). SunNet Manger also identifies (under New Value:) OID values that can change: a) A pull-down menu is provided in the New Value: column, to select value options. b) A line is placed in the New Value: column, to define text-entry value options. If no line or menu is provided, the OID is read-only. 8) To use a SET: a) Select or define the new value for OID (or OIDs). b) Click Set. c) Click Get to see if the SET value is now in the Current Value: list. At this point you can click Category to access a new OID category, or exit the dialog box and reperform the above procedure to access an OID category that is not listed in response to using the Category button.

20 20 Network Management Station (NMS) - Reference Guide 20 HP OpenView for Windows This section provides information on how to do the following: Install APC's PowerNet MIB OIDs on an HP OpenView for Windows workstation Browse PowerNet MIB OIDs. See your HP OpenView documentation for more detail on subjects covered in this section. General Considerations A failure message will be received when an attempt is made to browse the PowerNet MIB if that MIB has not been compiled. The procedures outlined in this section do not need to be performed if the workstation has (or will have) PowerNet Manager for HP OpenView for Windows installed, unless you want to have the ability to use the NMS browser for GETs and SETs to PowerNet MIB OIDs. PowerNet MIB Installation To install the PowerNet MIB on an HP OpenView for Windows workstation: 1) Insert the DOS, tar-formatted, PowerNet MIB disk into the workstation s floppy disk drive. 2) Double-click the Main Program group from the Windows Program Manager: a) Double-click the File Manager icon. c) Double-click the OV directory d) Double-click the MIBS subdirectory, and: 1) Delete any older APC MIB files (such as apc-snmp.mib). 2) Copy the powernet.mib file into the /OV/MIBS subdirectory. d) Exit File Manager. 3) From Program Manager, double-click the HP OpenView program group. 4) Double-click the HPOV icon. 5) From the Control menu: a) Select the SNMP Manager option. b) Select the Manage Database... menu option. 6) When the SNMP Manager dialog box appears, click Select... 7) When the Add File dialog box appears, double-click the mibs selection listed in the Directories: section. 8) In the File Name: section, double-click powernet.mib. 9) When the SNMP Manager box reappears (with POWERNET.MIB under Files to be added to database), click Add to add the powernet.mib file to HP OpenView for Windows SNMP management capabilities. 10) When the compile process successfully finishes, click Close to exit the SNMP Manager. At this point, HP OpenView for Windows can use the compiled powernet.mib file to control and monitor an APC UPS through either a PowerNet Adapter or PowerNet Agent.

21 21 Network Management Station (NMS) - Reference Guide 21 Loading Trap Definitions Before HP OpenView for Windows can properly format APC traps, HP OpenView for Windows must be configured to use the APCUPS.TDF file, as follows: 1) Open HP OpenView: a) Under the Windows Program Manager, double-click the HP OpenView program group. b) Double-click the HPOV icon. 2) Select Customize Traps... from the Monitor menu in the HP OpenView for Windows tool bar. 3) Click Load Traps at the right side of the Customize Traps Alarms dialog box. 4) Double-click C:\ in the box at the right side of the Load Traps Definition File dialog box. 5) Using the mouse pointer and left mouse button: a) Scroll down the directories list until the directory used to install PowerNet Manager is displayed b) Double-click the displayed PowerNet Manager installation directory. 6) In the left-hand box, double-click apcups.tdf. 7) In the Load Device Traps dialog box, double-click the APC enterprise-specific id: ) When prompted, click yes to load the trap definitions. Any new traps will be written into HP Openview for Windows. However, existing trap definitions will not be replaced automatically. See steps 13 and 14 for information about how to use an xnmevents command and the apctraps.fmt file to update existing traps. 9) Select Unconfigured/Default from the displayed Device Class Number at the top of box displayed in the upper left of the Load Device Traps dialog box. 10) Click Ignore Device Class. 11) Repeat steps 8 and 9 for HP Visual OpenView. 12) Click OK. 13) Make sure that the HP Openview services are running. 14) At a command prompt, type the following command: xnmevents -replace <path/apctraps.fmt> where path is the full path for the directory that contains the apctraps.fmt file, as well as all other PowerNet MIB files.

22 22 Network Management Station (NMS) - Reference Guide 22 PowerNet MIB Browsing The HP OpenView for Windows MIB browser allows you to use SETs and GETs to monitor and control a UPS through a PowerNet Adapter or Agent. You can install the PowerNet MIB before you install a PowerNet Adapter or Agent. However, you cannot browse the MIB OIDs until the Adapter or Agent is installed. From the HP OpenView for Windows management program: 1) Select the SNMP Manager option from the Control menu. 2) Select the Define Query... menu option. 3) In the SNMP Manager - Define Query dialog box, select the PowerNet Adapter or Agent by name or IP address from the pull-down menu for the Name: definition in the Device section of the dialog box. The Adapter or Agent IP address appears in the Network Address: box whether a name or IP address is selected in the Name: box. 4) In the Variables section, click the Up button twice to display the following list in the Available box: directory [mgmt] experimental [private] 5) Double-click [private]. 6) Use the Down button to select the following items, in the order shown, from the Available box selections: a) [enterprises] (only entry) b) [apc] (from the available options) c) [products] (from [products] and [apcmgmt]) d) [hardware] (from [hardware], [software], and [system] ) e) [ups] (from [ups], [measureups], and [minisnmpadapter] ) 7) When you select [ups], an SNMP Table dialog box displays the current values for all UPS OIDs. You could select all three OID categories for display in the SNMP Table, or double-click any selection to go down to smaller groups of OIDs, all the way down to an individual OID. 8) To perform a SET: a) Click the OID name or value you want to change. b) Edit the value displayed in the box at top of dialog box: 1) Use the pull-down menu to select a predefined value. 2) Type in a text value where no predefined setting exists. c) Click the checkmark. d) Click Set. e) Repeat steps a through d for each OID value you want to change.

23 23 Network Management Station (NMS) - Reference Guide 23 9) When all SETs are done, click Start to verify that the new values appear in the SNMP Table. HP OpenView for Windows NT This section provides information on how to browse PowerNet MIB OIDs using a server which is running Windows NT 3.51 or 4.0 with HP OpenView 5.x. APC s PowerNet Manager for HP OpenView for Windows NT application automatically loads PowerNet MIB and trap definitions during the PowerNet Manager installation. See your HP OpenView documentation for more detail on subjects covered in this section. General Considerations A failure message will be received when an attempt is made to browse the PowerNet MIB if that MIB has not been compiled. The procedures outlined in this section do not need to be performed if the workstation has (or will have) PowerNet Manager for HP OpenView for Windows NT installed, unless you want to have the ability to use the NMS browser for GETs and SETs to PowerNet MIB OIDs. PowerNet MIB Browsing The HP OpenView for Windows NT MIB browser allows you to use SETs and GETs to monitor and control a UPS through the UPS PowerNet Adapter or Agent. From the HP OpenView for Windows NT management program: 1) Select the SNMP MIB Browser option from the Tools menu to open the Browse MIB dialog box. 2) In the Name or address: dialog box field, type in the name or IP address of the device you want to browse. You can bypass this step by clicking on the desired device in a segment map before you select SNMP MIB Browser. 3) If you want to perform SETs, type in the SET (read/write access) community name for the device you want to browse in the Community name: field. 4) In the MIB tree display area of the dialog box, click the plus (+) boxes shown in the tree to navigate down to the PowerNet MIB OIDs: At any point in the process described in this step, and in step 5, you can select a category, then get a report on all OIDs under that category by clicking on the Start Query button. You can then review the OID values in the MIB values: field, or use the File menu s Save As... option to create a *.txt file containing the MIB values. Under internet, select private Under private, select enterprises Under enterprises, select apc Under apc, select products Under products, select hardware

24 24 Network Management Station (NMS) - Reference Guide 24 Under hardware, select ups 5) At this point, the major PowerNet MIB OID categories are listed in the MIB tree under ups: upsident upsconfig upsbattery upscontrol upsinput upstest upsoutput upscomm You can navigate down even further, to a subclass of a major category (for example, either upsbasicident or upsadvident under upsident), or to an individual OID (for example, upsbasicidentmodel under upsbasicident), or you can select a major category and click Start Query to get a report on all of the OIDs in that category. Although you do not need to go all the way down the MIB tree to access the current value for a PowerNet MIB OID, if you want to get the PowerNet MIB s description for a specific OID, you must navigate down the MIB tree and select that OID, then click the Describe button. 8) You can perform a SET to an OID only after you have queried that OID, and the current value is displayed in the MIB value: display field. When it is: a) Click the OID you want to SET. When you do, the OID s current value appears in the SNMP set value: field and the Set button becomes active. b) Edit the OID value in the SNMP set value: field to match the value you want to SET for the OID. The PowerNet MIB provides descriptions of valid SET values for all OIDs which can be SET. However, to access an OID s description, you must have that OID selected in the MIB tree. c) Click Set. 9) When done performing SETs, click Start Query to verify the new values appear in the MIB values: field. 10) If any problems are encountered while attempting to browse PowerNet MIB OIDs: Make sure the IP address (or system name), and the community name, you are using are both correct. Make sure the SET value you are using is supported by the PowerNet Agent and the PowerNet MIB OID. Make sure the PowerNet Agent is running, or the PowerNet Adapter is connected to the network and the UPS. Ping the IP address to test its network connectivity.

25 25 Network Management Station (NMS) - Reference Guide 25 Tivoli NetView for Windows NT This section provides information on how to browse PowerNet MIB OIDs using a server which is running Windows NT 4.0 with Tivoli NetView 5.0. APC s PowerNet Manager for Tivoli NetView for Windows NT application automatically loads PowerNet MIB and trap definitions during the PowerNet Manager installation. See your NetView documentation for more detail on subjects covered in this section. General Considerations A failure message will be received when an attempt is made to browse the PowerNet MIB if that MIB has not been compiled. The procedures outlined in this section do not need to be performed if the workstation has (or will have) PowerNet Manager for Tivoli NetView for Windows NT installed, unless you want to have the ability to use the NMS browser for GETs and SETs to PowerNet MIB OIDs. PowerNet MIB Browsing The Tivoli NetView for Windows NT MIB browser allows you to use SETs and GETs to monitor and control a UPS through the UPS PowerNet Adapter or Agent. From the Tivoli NetView for Windows NT management program: 1) From the Tools menu, select MIB, then select Browser, to open the Browse MIB dialog box. 2) In the Name Node or Address: dialog box field, type in the name or IP address of the device you want to browse. You can bypass this step by clicking on the desired device in a segment map. 3) If you want to perform SETs, type in the SET (read/write access) community name for the device you want to browse in the Community Name: field. 4) In the MIB tree display area of the dialog box, click the Down Tree button located next to the MIB Object ID text box plus (+) boxes shown in the tree to navigate down to the PowerNet MIB OIDs: At any point in the process described in this step, and in step 5, you can select a category, then get a report on all OIDs under that category by clicking on the Get Values button. You can then review the OID values in the MIB Values text box, or use the File menu s Save As... option to create a *.txt file containing the MIB values. Under internet, select private Under private, select enterprises Under enterprises, select apc Under apc, select products Under products, select hardware Under hardware, select ups

26 26 Network Management Station (NMS) - Reference Guide 26 5) At this point, the major PowerNet MIB OID categories are listed in the MIB tree under ups: upsident upsconfig upsbattery upscontrol upsinput upstest upsoutput upscomm You can navigate down even further, to a subclass of a major category (for example, either upsbasicident or upsadvident under upsident), or to an individual OID (for example, upsbasicidentmodel under upsbasicident), or you can select a major category and click Start Query to get a report on all of the OIDs in that category. Although you do not need to go all the way down the MIB tree to access the current value for a PowerNet MIB OID, if you want to get the PowerNet MIB s description for a specific OID, you must navigate down the MIB tree and select that OID, then click the Properties button. 8) You can perform a SET to an OID only after you have queried that OID, and the current value is displayed in the MIB values display field. When it is: a) Click the OID you want to SET. When you do, the OID s current value appears in the New Value field and the Set button becomes active. b) Edit the OID value in the New Value field to match the value you want to SET for the OID. The PowerNet MIB provides descriptions of valid SET values for all OIDs which can be SET. However, to access an OID s description, you must have that OID selected in the MIB tree. c) Click Set. 9) When done performing SETs, click Get Value to verify the new values appear in the MIB Values field. 10) If any problems are encountered while attempting to browse PowerNet MIB OIDs: Make sure the IP address (or system name), and the community name, you are using are both correct. Make sure the SET value you are using is supported by the PowerNet Agent and the PowerNet MIB OID. Make sure the PowerNet Agent is running, or the PowerNet Adapter is connected to the network and the UPS. Ping the IP address to test its network connectivity.

27 27 Network Management Station (NMS) - Reference Guide 27 CA Unicenter TNG for Windows NT This section provides information on how to browse PowerNet MIB OIDs using a server which is running Windows NT, version 4.0, with CA Unicenter TNG, version 2.1. Installing the PowerNet MIB Before Unicenter TNG can use the PowerNet MIB information, you must configure TNG to use the PowerNet MIB. The powernet.mib file is installed to the PowerNet Manger installation directory specified during the installation. To configure TNG to use this MIB, copy the powernet.mib file to the <TNG>\Schema\included directory (where <TNG> is the Unicenter TNG installation directory). For example: cd C:\Program Files\PowerNet SNMP Manager\ copy powernet.mib C:\TNG\Schema\included PowerNet MIB Browsing Once the PowerNet MIB is installed, you can browse MIB OID values, as follows: 1. Access the WorldView map. 2. Select ObjectView from the Start menu. 3. Enter the network address and hostname of a PowerNet Agent or Adapter in the appropriate ObjectView dialog box fields. 4. Select powernet.mib from the list provided in the Model Name field. 5. Select the PowerNet MIB information in the Vender Information folder which is located in the left pane of the ObjectView dialog box. 6. Select the desired MIB attributes to display the values for these attributes in the right pane of the ObjectView dialog box. For more information on how to use ObjectView, consult your CA Unicenter TNG documentation.

28 28 Network Management Station (NMS) - Reference Guide 28 Cabletron SPECTRUM for Windows NT This section provides information on how to browse PowerNet MIB OIDs using a server which is running Windows NT 4.0 with Cabletron SPECTRUM 4.0, rev 3. Compiling the PowerNet MIB Before Cabletron SPECTRUM can use the PowerNet MIB information, you must use the MIB Editor to add the PowerNet MIB objects to the MIB tree. The powernet.mib file is installed to the PowerNet Manger installation directory specified during the installation. To compile this MIB, do the following: 1. Open the SPECTRUM MIB Tools window by running mibtools.exe or as follows: a. Select Icon Subviews from the View menu. b. Select Utilities from the Icon Subviews options. c. Select MIB Tools from the Utilities options. 2. Click the Editor tab, if necessary, to display the Editor page of the SPECTRUM MIB Tools window. 3. Verify that TheWorld is the dataset selected at the bottom of the Target panel. 4. Click the button directly to the right of the Text File field at the bottom of the Source panel. 5. Highlight the path name for the powernet.mib file in the File Name field in the access window. For example, if PowerNet Manger was installed in its default directory, the path name for the powernet.mib file would be as follows: C:\WIN32APP\Spectrum\SG-Support\CsExtProcess\PowerNet\powernet.mib 6. Click Open to access the MIB Compiler window. 7. Click Start to compile the PowerNet MIB. While the MIB compiles, the following will occur: - The Object Count value will increase as the MIB compiler parses each new MIB object from the powernet.mib. - Each newly parsed MIB object is added to the Compiled MIB Objects list. - Any syntax errors discovered in the file are logged in the Compiler Warnings and Errors listing. - The Apply button becomes active when the compilation is completed. 8. Click Apply to reopen the SPECTRUM MIB Tools window with the newly compiled PowerNet MIB displayed in the window s Source panel. 9. Click the button located between the Target and Source panels to add the PowerNet MIB objects listed in the Source panel to the MIB tree listed in the Target panel.

29 29 Network Management Station (NMS) - Reference Guide 29 Other SPECTRUM MIB Tools Window Functions In addition to the Editor page used to compile the PowerNet MIB, the SPECTRUM MIB Tools window has four other pages: The Browser page allows you to GET and SET PowerNet MIB object values. The Devices page accumulates information about devices you monitor while using the SPECTRUM MIB Tools window, and allows you to save Name, IP Address, MAC address, Type, and Description information about those devices. The Details page allows you to view the details for any PowerNet MIB object exactly as those details are recorded in the powernet.mib file. The Preferences page allows you to customize the SPECTRUM MIB Tools window presentation. For information about how to use any of these SPECTRUM MIB Tools window pages, or for more information on how to use the Editor page, see the SPECTRUM MIB Tools User s Guide. Cabletron SPECTRUM for Solaris This section provides information on how to browse PowerNet MIB OIDs using a server which is running Solaris 2.x with Cabletron SPECTRUM 4.0, rev 3. Importing the PowerNet MIB Before Cabletron SPECTRUM can use the PowerNet MIB information, you must use the SPECTRUM MIB Editor to import the PowerNet MIB objects into the MIB database. The powernet.mib file is installed to the PowerNet Manger installation directory specified during the installation. To import this MIB, do the following: 1. Right-click an object. 2. Select the MIB Tools option from the Utilities menu. 3. Select Editor from the MIB Tools options to open the SPECTRUM MIB Editor window. 4. Click Import... to open the Choose a MIB to Import window. 5. Type *.mib into the Show files like: field. 6. Use the field directly above the Show files like: field to type in the directory path. For example, if PowerNet Manager was installed in the default directory location, the directory path is as follows: /usr/spectrum/sg-support/csextprocess/powernet/powernet.mib