`
`Title PagePowerNet SNMP
`Management
`Information
`Base (MIB) v3.1.0
`
`Reference
`Guide
`
`IPR Page 1
`
`Raritan v. Server Technology
`
`RARITAN EXHIBIT 1015
`
`
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`2
`POWERNET MIB V3.1.0
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`2
`
`The PowerNet MIB software is protected by both United States copyright law and international treaty provisions. Therefore, you must treat this
`software just like a book, with the following exception: American Power Conversion Corporation (APC) authorizes you to make archival copies
`of the software for the sole purpose of backing up our software and protecting your investment from loss.
`
`By saying “just like a book”, APC means, for example, that the PowerNet SNMP Agent may be used by any number of people and may be freely
`moved from one computer/Uninterruptible Power Source (UPS) location to another, so long as there is no possibility of it being used in one
`location while it is also being used in another. Just as a book cannot be read by two different people in two different places at the same time,
`neither can the PowerNet SNMP Agent be used by two different people in two different places at the same time (unless, of course, APC’s
`copyright has been violated).
`
`Unlimited copies of the PowerNet MIB may be used in conjunction with any properly licensed copy of the PowerNet SNMP Agent.
`
`In addition, by using this package, you agree not to reverse engineer, reverse assemble, or reverse compile the software.
`
`With respect to the physical diskette and physical material enclosed herein, APC warrants the same to be free of defects in materials and
`workmanship for a period of 60 days from the date of purchase. In the event of notification within the warranty period of defects in material or
`workmanship, APC will replace the defective diskette or material. If you need to return a product call the APC customer service department to
`obtain a Return Material Authorization (RMA) number. The remedy for breach of this warranty shall be limited to replacement and shall not
`encompass any other damages, including but not limited to loss of profit, and special, incidental, consequential or other similar claims.
`
`In no event shall APC be liable
`APCSPECIFICALLYDISCLAIMSALLOTHERWARRANTIES,EXPRESSEDORIMPLIED,INCLUDINGBUTNOTLIMITEDTOIMPLIEDWARRANTIESOFMERCHANTABILITYANDFITNESSFORAPARTICULARPURPOSEWITHRESPECTTOTHESOFTWARE,INCLUDINGTHEDISKETTES,DOCUMENTATION,ANDCABLES.
`for any loss of profit or other commercial damage, including but not limited to special, incidental, consequential or other damages.
`
`This statement shall be construed, interpreted and governed by the laws of the State of Rhode Island.
`
`LICENSES & TRADEMARKS
`
`The following are product and corporate names used in this guide that are trademarks or registered trademarks of American Power Conversion
`Corporation: APC, Back-UPS, MasterSwitch, MasterSwitch VM, Matrix-UPS, Measure-UPS, PowerChute, PowerNet, SNMP Adapter , Smart-
`UPS, Symmetra, Power Array, and v/s.
`
`NetWare is a registered trademark of Novell, Inc.
`Windows NT is a trademark of Microsoft 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, 1999. All Rights Reserved. Reproduction in whole or in part without permission is
`prohibited.
`
`AMERICAN POWER CONVERSION CORPORATIONAPC Corporate
`
`132 Fairgrounds Road
`P.O. Box 278
`West Kingston, RI 02892
`United States of America
`Tel: 800 800 4APC
`
`PowerNet SNMP MIB v3.1.0
`November, 1999
`
`IPR Page 2
`
`POWERNET SNMP AGENT LICENSE STATEMENT
`Limited Warranty
`Governing Law
`
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`3
`
`3 C
`
`ontents
`
`Title Page
`About This Guide
`
`1
`5
`
`Guide Purpose......................................................................................................................................5Guide Structure.....................................................................................................................................5Associated Documents........................................................................................................................6This Guide(cid:146)s Conventions.....................................................................................................................6How to Contact APC.............................................................................................................................6
`
`Chapter 1
`PowerNet SNMP MIB Structure
`
`7
`
`Chapter 2:
`How to Manage PowerNet Adapters and Agents
`
`Chapter 3:
`How to Manage a UPS
`
`PowerNet MIB Traps.............................................................................................................................7PowerNet MIB OIDs..............................................................................................................................7SNMP Access Controls.....................................................................................................................7SNMP Browser Structure..................................................................................................................8PowerNet SNMP MIB OIDs Structure...............................................................................................8Tabled OIDs.......................................................................................................................................9
`Overview.............................................................................................................................................10How to Monitor a PowerNet Agent......................................................................................................10The [powerNetSoftwareSystem] OIDs............................................................................................11The [powerNetSoftwareConfig] OIDs..............................................................................................11How to Manage A PowerNet Adapter (or MasterSwitch) SNMP Agent..............................................11The [mcontrol] OID..........................................................................................................................11The [mconfig] OIDs.........................................................................................................................12The [mtrapargs] OIDs......................................................................................................................12The [mfiletransfer] OIDs..................................................................................................................13
`Overview.............................................................................................................................................15How to Monitor a UPS.........................................................................................................................16UPS Identification ([upsIdent]) OIDs................................................................................................16UPS Battery ([upsBattery]) OIDs.....................................................................................................17UPS Communication ([upsComm]) OID.........................................................................................17UPS Input ([upsInput]) OIDs............................................................................................................18UPS Output ([upsOutput]) OIDs......................................................................................................19UPS Output ([upsOutput]) OIDs......................................................................................................20How to Control a UPS.........................................................................................................................21How to Configure a UPS.....................................................................................................................23How to Test a UPS..............................................................................................................................25
`
`10
`
`15
`
`IPR Page 3
`
`
`
`4
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`4
`
`Chapter 4:
`How to Manage a Measure-UPS
`Overview.............................................................................................................................................26How to Monitor Environment ([mUpsEnviron]) OIDs..........................................................................26How to Use Contact ([mUpsContact]) OIDs......................................................................................27
`Chapter 5:
`How to Manage a MasterSwitch
`
`26
`
`28
`
`Overview.............................................................................................................................................28How to Use the Identification ([sPDUIdent]) OIDs..............................................................................29How to Use the Master Control ([sPDUMasterControl]) OIDs...........................................................29How to Use the Master Configuration ([sPDUMasterConfig]) OIDs...................................................30How to Use the Outlet Control ([sPDUOutletControl]) OIDs..............................................................31How to Use the Outlet Configuration ([sPDUOutletConfig]) OIDs.....................................................32
`
`Chapter 6:
`How to Manage a MasterSwitch VM
`
`33
`
`Overview.............................................................................................................................................33How to Use the Identification VM ([sPDUIdentVM]) OIDs...................................................................34How to Use the Master Control VM ([sPDUMasterControlVM]) OIDs................................................35How to Use the Master Configuration VM ([sPDUMasterConfigVM]) OIDs........................................36How to Use the Master Status VM ([sPDUOutletControlVM]) OIDs...................................................37How to Use the Outlet Control VM ([sPDUOutletConfigVM]) OIDs....................................................38How to Use the Outlet Configuration VM ([sPDUOutletControlVM]) OIDs.........................................39How to Use the Outlet Status VM ([sPDUOutletConfigVM]) OIDs.....................................................40
`
`Chapter 7:
`How to Download New Code to A PowerNet SNMP Adapter
`41
`Overview.............................................................................................................................................41The [mcontrol] OID.............................................................................................................................41The [mconfig] OIDs............................................................................................................................41
`Chapter 8:
`PowerNet MIB Traps
`42
`Overview.............................................................................................................................................42How to Define Trap Receivers............................................................................................................43PowerNet MIB Trap Definitions...........................................................................................................43
`
`IPR Page 4
`
`
`
`5
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`5
`
`About This Guide
`
`This introduction provides information which can help you use this user’s guide.
`
`GUIDE PURPOSE
`GUIDE STRUCTURE
`ASSOCIATED DOCUMENTS
`GUIDE CONVENTIONS
`HOW TO CONTACT APC
`
`Guide Purpose
`
`This guide describes how to use the PowerNet Simple Network Management Protocol (SNMP) management
`information base (MIB) v3.1.0 to manage APC products which allow (or enable) using SNMP-based management:
`
`MIB v3.1.0 management of a SNMP Adapter, its UPS, and a Measure-UPS
`MIB v2.2-compatible management of a v2.2 Adapter or Agent, its UPS, and a Measure-UPS
`MIB v3.1.0 management of a MasterSwitch
`Guide Structure
`
`In addition to this introduction, this guide uses eight chapters to describe how to use the PowerNet MIB:
`
`Provides an overview of the PowerNet MIB, its Object Identifications (OIDs) and traps (messages which alert
`a network management station [NMS] of specific conditions).
`
`Describe how to use PowerNet MIB OIDs to manage specific products:
`
`CHAPTER 2: HOWTO MANAGE POWERNET SNMP ADAPTERSAND AGENTSCHAPTER 3: HOWTO MANAGEA UPSCHAPTER 4: HOWTO MANAGEA MEASURE-UPSCHAPTER 5: HOWTO MANAGEA MASTERSWITCHCHAPTER 6: HOWTO MANAGEA MASTERSWITCHVMCHAPTER 7: HOWTO DOWNLOAD NEWADAPTER CODE
`
`Describes how to restart a hardware-based (PowerNet Adapter) SNMP agent, continue with the current
`agent, or load new code.
`
`Describes the PowerNet MIB traps and how to define which NMSs can receive those traps.
`
`IPR Page 5
`
`CHAPTER 1: POWERNET SNMP MIB STRUCTURE
`CHAPTER 2 through CHAPTER 6
`CHAPTER 8: POWERNET SNMP MIB TRAPS
`
`
`6
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`6
`
`Associated Documents
`
`This guide describes how to use the PowerNet MIB, only. For information about the APC product you want to manage
`using the PowerNet MIB, refer to the appropriate APC user’s guide or owner’s manual, for that product; refer to your
`network management system (NMS) documentation for information about your NMS, and to APC’s NetworkManagement Station (NMS) Reference Guide
` (nms.pdf), for general descriptions of how to use the PowerNet MIB
`with different types of NMSs.
`
`This Guide’s Conventions
`
`This guide uses informal references to the following components:
`
`This Guide Uses
`PowerNet SNMP Adapter
`
`PowerNet Network Adapter
`PowerNet Adapter or Adapter
`PowerNet Agent or Agent
`Measure-UPS (Environmental Montioring Card)
`MasterSwitch
`
`Network management station (NMS) or just NMS
`
`To Refer to
`Any PowerNet SNMP Adapter with model numbers AP9205,
`AP9605 or AP9603
`Any PowerNet Network Adapter with model number AP9606
`Any PowerNet SNMP or Network Adapter
`Any PowerNet SNMP Agent
`The standalone Measure-UPS or the SmartSlot Measure-UPS II
`Any MasterSwitch with model numbers AP9210(i), AP9211, or
`9212.
`Any MasterSwitch VM with model numbers AP9221X166 or
`AP9211EXP166
`Any network component capable of using the PowerNet SNMP
`MIB
`
`Also, this guide uses the following conventions when referring to specific items within the text:
`
`When the Following Appear in Text
`A document name (PowerNet SNMP Agent - MIBReference Guide
`)
`- File names (powernet.mib)
`- MIB OIDs or traps (upsAdvControl)
`References to other sections of this guide
`
`How to Contact APC
`
`This Guide Uses
`
`Boldface Arial font, in normal text, or normal Arial font,
`in boldface text
`Small capitalization of non-uppercase letters
`
`For more information on this or any other APC product, visit APC’s Web site at http://www.apc.com/. APC
`continuously updates the information you can get through its Web site, including its product documentation.
`You can also use a telephone to contact Customer or Technical Support, if you have any questions concerning this or
`other APC products: See the TECHNICAL SUPPORT section in your PowerNet Adapter - User(cid:146)s Guide
`. APC does not
`charge a fee for customer or technical support.
`
`IPR Page 6
`
`Italics
`
`
`7
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`7
`
`Chapter 1
`PowerNet SNMP MIB Structure
`
`This chapter breaks the PowerNet SNMP MIB down into its major OID and trap components.
`
`PowerNet MIB Traps
`
`An Adapter, Agent or MasterSwitch can send traps to an NMS when specific events occur. The NMS does not need to
`use the PowerNet SNMP MIB to get the trap, but it does need the MIB to interpret the trap’s meaning. Also, which
`NMSs can actually receive traps depends on the trap receiver definitions a particular Adapter, Agent or MasterSwitch
`uses.
`
`For more information on traps, see CHAPTER 7.
`
`PowerNet MIB OIDs
`
`The PowerNet MIB OIDs allow an NMS to use its SNMP browser to manage:
`
`An Adapter, its UPS and Measure-UPS
`An Agent, its UPS and Measure-UPS
`A MasterSwitch
`
`However, in the case of an Adapter or MasterSwitch, the NMS can only manage a product if the product’s SNMP
`access controls allow that NMS to have SNMP access. (An Agent, which has limited control over a UPS, does not use
`SNMP access controls.)
`
`SNMP Access Controls
`
`A PowerNet Adapter and MasterSwitch use console programs which you can use to define specific SNMP access
`values for up to four SNMP channels.
`
`You Can
`Disable SNMP access altogether
`Use an NMS IP Address as a SNMP channel value
`Define a non-default password for an SNMP channel
`
`Select the type of access used by an SNMP channel
`
`To Do this
`Prevent SNMP access by any NMS.
`Limit channel access to only the defined NMS.
`Limit channel access to an NMS which knows the
`password.
`Allow an NMS to have write access, or just read access.
`
`IPR Page 7
`
`
`
`8
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`8
`
`SNMP Browser Structure
`
`The PowerNet MIB fits into a top-down structure within the SNMP browser’s categories. For example, when using an
`HP OpenView for Windows SNMP browser, the PowerNet MIB OIDs fit into the browser’s structure, as follows:
`
`[iso] (for International Standards Organization) at the top
`[org] (for organization) under [iso]
`[dod] (for Department of Defense) under [org]
`[internet] under [dod]
`[private] under [internet]
`[enterprises] under [private]
`[apc] (for American Power Conversion) under [enterprises]
`
`PowerNet SNMP MIB OIDs Structure
`
`The PowerNet MIB OIDs also break down into a top-down structure, from [apc] at the top, down to individual OIDs at
`the bottom of specific OID categories, or within a specific OID table (see the separate section on TABLED OIDS).
`
`The OID categories provide for grouping specific functions together. For example, under [apc], two categories appear:
`[products], which provides the OIDs you can use to manage specific products, and [apcmgmt], which provides OIDs
`you can use to affect the operation of hardware-based (PowerNet Adapter and MasterSwitch) SNMP agents (for
`more information on how to use the [apcmgmt] OIDs, see CHAPTER 2: HOW TO MANAGE POWERNET ADAPTERS AND
`AGENTS).
`
`Under [products], three categories appear, two of which provide OIDs you can use to manage specific products.
`
`[hardware]
`
`[software]
`
`This category breaks down into categories for each type
`of hardware product you can manage using PowerNet
`MIB OIDs. Separate chapters in this guide describe how
`to use the OIDs which fall under[hardware]:
`
`This category includes read-only OIDs you can use to
`monitor a software PowerNet SNMP Agent, only (as
`described in CHAPTER 2). A single category appears under
`[software]:
`
`[ups] (CHAPTER 3)
`[measureUps] (CHAPTER 4)
`[miniSNMPadapter] (CHAPTER 2)
`[masterswitch] (CHAPTER 5)
`[masterswitchVM] (CHAPTER 6)
`
`[powerNetSubAgent]
`
`The third listing [system] does not provide OIDs you can use for SNMP management. This category contains read-only
`OIDs which identify UPS, Measure-UPS and MasterSwitch models by unique numbers, numbers other OIDs can
`reference. For example, the MIB-II system
`OIDs (listed under [internet], [mgmt], [mib-2] and [system]) use a
`PowerNet MIB [system] OID number for the MIB-II’s [sysObjectID] value.
`
`IPR Page 8
`
`
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`9
`
`9
`
`Tabled OIDs
`
`For any PowerNet MIB OID category listed in the SNMP browser, you can access a list of the current values for all
`OIDs from that category down. For example, you can select [apc], to list the current values for all PowerNet MIB
`OIDs, or [ups], to list the current values for all PowerNet MIB UPS OIDs.
`
`With an exception: OIDs grouped together in a table will not appear in such a list. You can only access an OID table’s
`values by selecting that table OID in the SNMP browser (an OID table appears enclosed in curly {} brackets). For
`example, to access the OIDs which define all four trap receivers for an Adapter (or MasterSwitch), you select
`{mconfigTrapReceiverTable} in the SNMP browser.
`
`For more information on how to define trap receivers, see CHAPTER 2.
`
`IPR Page 9
`
`
`
`10
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`10
`
`Chapter 2:
`How to Manage PowerNet Adapters and Agents
`
`This chapter describes how to use PowerNet MIB OIDs to manage a PowerNet Adapter, or view software data for a
`PowerNet SNMP Agent.
`
`Overview
`
`A PowerNet Adapter directly connects a UPS and a Measure-UPS to the network; a PowerNet Agent indirectly
`connects a UPS and a Measure-UPS by communicating with a PowerChute plus application, which, in turn,
`communicates with the UPS and Measure-UPS. In both cases, the network connection allows an NMS to use an
`SNMP browser and PowerNet MIB OIDs to manage the UPS and Measure-UPS.
`
`In addition to using SNMP to manage a device connected to the network by an Adapter or Agent, the NMS can also
`use PowerNet MIB OIDs to manage the PowerNet Adapter, or monitor software values for the PowerNet Agent.
`
`To Do this
`Use
`[powerNetSubAgent] read-only OIDs View information about a PowerNet SNMP Agent (see HOW TO MONITOR
`A POWERNET AGENT).
`Manage a PowerNet Adapter 's internal SNMP agent (see HOW TO
`MANAGE A POWERNET ADAPTER'S SNMP AGENT).
`
`[apcmgmt] OIDs
`
`[serialPort2] OIDs
`
`Define a PowerNet 2.2 Adapter's serial port operation (see HOW TO
`CONTROL A POWERNET 2.2 ADAPTER'S SERIAL PORT).
`
`Note: You can also use these OIDs to manage a MasterSwitch SNMPagent.
`
`How to Monitor a PowerNet Agent
`
`You can use [powerNetSubAgent] read-only OIDs to view information about a PowerNet Agent:
`
`1) Select [product] under [apc].
`2) Then select [software].
`3) Then select [powerNetSubAgent].
`
`The SNMP browser lists two OID categories: [powerNetSoftwareSystem] and [powerNetSoftwareConfig].
`
`IPR Page 10
`
`
`
`11
`
`The[powerNetSoftwareSystem]
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`11
`
`OIDs
`
`Use
`powerNetSoftwareSystemDescription
`
`powerNetSoftwareOid
`
`powerNetSoftwareSystemUpTime
`
`To See
`Information about an Agent, including its version number.
`What technology the Agent uses to implement the PowerNet MIB.
`How long the Agent has been continuously running on the network.
`
`The[powerNetSoftwareConfig]
`
`OIDs
`
`Use
`powerNetSoftwareTableSize
`
`{powerNetSoftwareTable}
` moduleNumber
` moduleName
` moduleVersion
` moduleDate
`
`To See
`How many distinct modules an Agent has.
`A tabled set of OIDs which define each module by the modules:
`- Table row number
`- Name
`- Version number
`- Installation date
`
`How to Manage A PowerNet Adapter (or MasterSwitch) SNMP Agent
`
`When you select [apcmgmt] under [apc], the SNMP browser lists four OID categories: [mcontrol], [mconfig],
`[mtrapargs] and [mfiletransfer]. With the exception of the OIDs involved with downloading new agent code, you can
`use these OIDs to manage either an Adapter or a MasterSwitch. You can use two [mconfig] OIDs for configuration of
`downloading new agent code to an SNMP Adapter. See Chapter 6 for more information.
`
`The[mcontrol]
`
`OID
`
`Use
`mcontrolRestartAgent
`
`To SET this Value
`- restartCurrentAgent (1) (reboots the Adapter's SNMP agent)
`- continueCurrentAgent (2) (continues the Agent without rebooting)
`-l oadandExecuteNewAgent (3) (starts to download new code)
`- restartWithoutAgent (4) (will restart the system without starting the Agent.
` The subsequent time the system restarts, the Agent will also automatically
` restart.)
`
`Note: Only an SNMPAdapter can use theloadandExecuteNewAgent(3) value to start a download of new agent code.
`
`You also use two [mconfig]
`more information.
`
` OIDs to download new agent code to an SNMP Adapter using TFTP. See Chapter 6 for
`
`IPR Page 11
`
`
`
`12
`
`The[mconfig]
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`12
`
`OIDs
`
` Use
`mconfigBOOTPEnabled
`
`mconfigNumTrapReceivers
`
`{mconfigTrapReceiverTable}
`
`mconfigTFTPServerIP
`
`To Do This
`Identify the current BOOTP setting. A GET to this OID returns:
`- yes (for BOOTP enabled)
`- no (for BOOTP disabled)
`Identify how many NMSs can receive traps from the Adapter (or
`MasterSwitch). A GET to this OID returns a value from 0 to 4.
`Use the tabled OIDs to define up to four NMSs as trap receivers.
`Define a TFTP server, by its IP address, when you want to use TFTP to
`download new code.
`
`newCodeAuthentViaTFTP
`
`View the results of the last TFTP download of new code.
`
`mconfigClock
`
`Note: Only SNMP Adapters support this OID.
`
`Configure the date and time on the Adapter
`- mconfigClockDate (in the mm/dd/yyyy format)
`- mconfigClockTime (in the hh:mm:ss am/pm format)
`
`See CHAPTER 6 to find out how to use TFTP to download new agent to an Adapter; see CHAPTER 7 to find out how to
`define trap receivers for an Adapter or a MasterSwitch.
`
`The[mtrapargs]
`
`OIDs
`
` Use
`mtrapsapargsInteger
`
`mtrapsapargsIpAddress
`
`mtrapsapargsString
`
`mtrapsapargsGuage
`
`mtrapsapargsTimeTicks
`
`To Allow APC Traps to Use this
`An integer argument that may not be defined as part of the APC MIB.
`An IP address argument that may not be defined as part of the APC MIB.
`An octet string argument that may not be defined as part of the APC MIB.
`A Guage argument that may not be defined as part of the APC MIB.
`A TimeTicks argument that may not be defined as part of the APC MIB.
`
`IPR Page 12
`
`Note: Only SNMP Adapters support this OID.
`
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`13
`
`13
`
`The[mfiletransfer] OIDs
`
`This branch of the PowerNet MIB is currently onl;y supported by PowerNet Network Adapters. These OIDs allow
`transfers of any type of file which is recognizable by the Network Adapters. Please see the User’s Guide of the
`PowerNet Network Adapters for more detailed information.
`
`The[mfiletransferStatus]
`
` OID
`
` Use
`mfiletransferConfigLastFileTransferResult
`
`To Report This
` The result of the last attempted file transfer.
`Possible results:
`lastFileTransferResultSuccessful
`lastFileTransferResultNotAvailable
`lastFileTransferResultFailureUnknown
`lastFileTransferResultFailureServerInaccessible
`lastFileTransferResultFailureServerAccessDenied
`lastFileTransferResultFailureFileNotFound
`lastFileTransferResultFailureFileTypeUnknown
`lastFileTransferResultFailureFileCorrupted
`
`The[mfiletransferConfig] OID
`
` Use
`mfiletransferConfigSettings
`
`mfiletransferConfigTFTP
`
`mfiletransferConfigFTP
`
`To Report This
`mfiletransferConfigSettingsFileName
` (The name and path of the file to be transferred)
`mfiletransferConfigTFTPServerAddress
` (The IP Address of the remote TFTP Server )
`mfiletransferConfigFTPServerAddress
`(The IP Address of the remote FTP Server )
`mfiletransferConfigFTPUser
`(The FTP Server User Name)
`mfiletransferConfigFTPPassword
` (The FTP ServerPassword)
`
`IPR Page 13
`
`-
`-
`-
`-
`-
`-
`-
`-
`
`
`14
`
`The[mfiletransferControl]
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`14
`
` OID
`
` Use
`mfiletransferControlInitiateFileTransfer
`
`To Choose to
`doNotInitiateFileTransfer (Do Nothing)
`initiateFileTransferDownloadViaTFTP (Download file From TFTP Server)
`initiateFileTransferDownloadViaFTP (Download file from FTP Server)
`
`IPR Page 14
`
`
`
`15
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`15
`
`Chapter 3:
`How to Manage a UPS
`
`This chapter describes how to use PowerNet MIB OIDs to manage (monitor, configure, control and test) a UPS
`through its PowerNet Adapter or PowerNet Agent.
`
`Overview
`
`The PowerNet MIB OIDs you can use to manage a UPS fall into eight categories under the heading of [ups]:
`
`1) Select [product] under [apc].
`2) Then select [hardware].
`3) Then select [ups] to list the eight OID categories.
`
`OIDs in These Categories
`[upsIdent]
`[upsBattery]
`[upsInput]
`[upsOutput]
`[upsComm]
`[upsConfig]
`
`[upsControl]
`
`[upsTest]
`
`Allow You to Do this
`View information about the UPS and its OVERALL operation (see HOW TO
`MONITOR A UPS).
`
`Modify parameters which affect the overall operation of the UPS (see HOW
`TO CONFIGURE A UPS).
`Directly affect the current operation of the UPS (see HOW TO CONTROL A
`UPS).
`Verify that the UPS can operate correctly during a power failure (see HOW
`TO TEST A UPS).
`
`How many of the OIDs in these eight [ups] OID categories you can actually use to manage a UPS depends on
`how that UPS connects to the network. Also, within these categories two types of OIDs can exist: Simple-
`signalling ([upsBasic]) OIDs and smart-signalling ([upsAdv]) OIDs. For a PowerNet Agent, the type of
`signalling used for the connection between the Agent and the UPS does affect what OIDs you can use.
`
`PowerNet Adapter
`You can use all OIDs listed under
`the PowerNet MIB's [ups]
`category.
`
`PowerNet Adapter v2.2
`You can use all [ups] OIDs
`supported by v2.2 of the
`PowerNet MIB.
`
`PowerNet Agent
`You cannot use:
`- [ups] OIDs not originally
` supported for use by PowerNet
`Agents in PowerNet MIB v2.2.
`- [upsAdv]-type OIDs, if the
` Agent-to-UPS communication
` uses simple-signalling.
`
`IPR Page 15
`
`
`
`16
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`16
`
`How to Monitor a UPS
`
`You use GETs (SNMP read commands) to PowerNet MIB OIDs to monitor (view information about) the UPS.
`However, not every PowerNet MIB OID will respond to a GET with useful information. For example, if you use a GET
`with any [upsControl] OID, the returned value simply tells you that the related control action was not taken by the
`UPS: A GET to [upsAdvControlFlashAndBeep] receives a noFlashAndBeep response; A GET to
`[upsAdvControlRebootUps] receives a noRebootUps response.
`
`However, most PowerNet MIB categories have OIDs which you can use to view information about the UPS operation.
`With few exceptions, these OIDs respond to GETs, but not to SETs: You can view (GET) information about UPS
`operation, but you cannot affect (SET) that operation.
`
`OIDs in These Categories
`[upsIdent]
`[upsBattery]
`[upsInput]
`[upsOutput]
`
`[upsComm]
`
`Allow You to View Information about
`The UPS identification parameters (see UPS IDENTIFICATION ([upsIdent]) OIDS).
`The UPS battery status (see UPS BATTERY ([upsBattery]) OIDS).
`The voltage coming to the UPS (see UPS INPUT ([upsInput]) OIDS).
`The voltage output by the UPS (see UPS OUTPUT ([upsOutput]) OIDS).
`The UPS-to-SNMP agent communication link (see UPS COMMUNICATION
`([upsComm]) OID).
`
`UPS Identification ([upsIdent]) OIDs
`
`The [upsIdent] category has five OIDs which identify UPS identification parameter values: Four read-only OIDs which
`report factory-preset values, and one OID which reports the name used for the UPS, a name you can define using a
`SET.
`
`You can access all five OIDs through any PowerNet Adapter or PowerNet Agent which connects to the UPS through
`a smart-signalling cable. For a PowerNet Agent which connects to the UPS through a simple-signalling cable, you can
`only use the two [upsBasicIdent] OIDs.
`
`This OID
`upsBasicIdent
`
`upsBasicIdentName
`
`upsAdvIdentFirmwareRevision
`
`upsAdvIdentDateOfManufacture
`
`upsAdvIdentSerialNumber
`
`Reports
`
`The UPS model name
`The name used for the UPS (an 8-character value you can change using a
`SET)
`The UPS firmware version
`The date the UPS completed the manufacturing process
`The UPS serial number
`
`IPR Page 16
`
`
`
`17
`
`PowerNet® SNMP Management Information Base (MIB) v3.1.0: Reference Guide
`
`17
`
`UPS Battery ([upsBattery]
`
`) OIDs
`
`The [upsBattery] category has nine OIDs which provide UPS battery status information: Eight read-only OIDs, and
`one OID which reports when the battery was last replaced, a value you can define using a SET.
`
`You can access all nine OIDs through any PowerNet Adapter, or through a PowerNet Agent which connects to the
`UPS through a smart-signalling cable. For a PowerNet Agent which connects to the UPS through a simple-signalling
`cable, you can only use the three [upsBasicBattery] OIDs.
`
`This OID
`upsBasicBatteryStatus
`
`Reports
`
`The current UPS battery status:
`- unknown (Adapter or Agent cannot report the status)
`- batteryNormal (within normal operating parameters)
`- batteryLow (lacks enough power to support the UPS load equipment)
`When the battery was last replaced, a value you can change using a SET.
`How much time has passed since the UPS switched to battery power.
`What percentage of full battery capacity the battery currently has.
`The internal temperature of the UPS, in Celsius.
`How much longer the UPS can use battery power for its output voltage.
`Whether or not a UPS battery needs a replacement:
`- noBatteryNeedsReplacing
`- batteryNeedsReplacing
`How many external battery packs a Matrix-UPS or Smart-UPS XL has.
`upsAdvBatteryNumOfBadBatt