SNMP adapter programming for the APC UPS

        and HP Openview for WIN95/NT Setup

3/29/98                                                                                                                          AES

Why am I writing this? Simple: APC's documentation is missing, lacking, hard to follow, or just old.

The first thing that must be done is to get your laptop over to the UPS with the SNMP adapter. Any PC with a known, working serial port is fine. The SNMP adapter comes with a black, DB9 M/F cable for serial programming. Do not use any other cable. It is not a standard serial pass through cable. Standard serial cables may damage you expensive laptop or the SNMP adapter.   The APC part number for this cable is 940-0024C, and it is clearly marked on the hood of the DB9 connector's male side. Please be sure to install the SNMP adapter into the UPS' Smart Slot  with only this 940-0024C cable connected to the UPS. Do not try the initial setup with the cable connected to an expansion chassis or a serial port expander.

All of the following screens are for hardware version 3.x of the SNMP adapter. Older versions do not support the Symmetra UPS line, so please be careful.

Bring up a terminal program such as WIN95's HyperTerm. Using the program's setup menu, configure the following selections:

Data Bits 8

Stop Bits 1

Parity None

Handshaking None

Terminal Type ANSI (VT100)

Local echo OFF

Baud Rate 19200 (2400 used in examples )

Baud rate can really be anything now. The adapters go into Auto-Baud rate mode by default.

The default user name and passwords are APC. Then the main program screen comes up.

.

The adapter comes with BOOTP turned ON and no IP addresses. These have to be changed immediately for normal operation. SNMP will not even work without an IP address, and BOOTP will disable remote programming. So, enter option 2, and start to reprogram the adapter.

Option 1 on this menu is the TCP/IP setup.

.

snmp3.gif (30290 bytes)

This data may seem odd for some; it is typical of hardware that comes up on a network with a DHCP server. Even though the IP is off because BOOTP is enabled, the adapter programmed itself to what it could get from the DHCP host. These numbers came from the RoadRunner cable modem system here in San Diego. Most of the time, the IP, Subnet, and Gateway are all blank.

Enter option 1 to change the BOOTP status control..

Enter 1 to disable BOOTP and then 2 to update the software. The IP stack is now programmable.

Next pick a free IP address in your network and an associated subnet mask. The IP must be unique. It can't be shared with any device visible to your network. Make sure the address isn't used for network broadcasting either.

The mask should only be as wide as necessary. Making it too wide will only slow your network down with unnecessary traffic. In this example, 129.46.91.213 will be the IP. The mask will be limited to that address range, 255.255.255.0. 255.255.255.248 would work if the goal is limit access to that block of eight addresses.

The MAC address wasn't invented by McDonalds. It is a unique address for any device on a network. It is another method used to communicate with and uniquely identify a network card without using TCP/IP. This address usually can't be changed in any system.

Be sure to use option 5 after each entry to save your data. You will see SUCCESS on the menu after each data update. Illegal values, such as an improper mask, will not work.

Notice that you get a warning stating "You must Logout for your new setting to take effect." If you ESC up a few levels, and can hit option 4 and logout. At this point, the SNMP card will be accessible from a Telenet session. Again, just login with the user name and password of apc.

.

Hit option 5 again to make the final changes. The Default Gateway is left blank in this example.

Programming for SNMP Access

Now that the card will at least talk to the network, the SNMP setting need to be set. These menus are also under the Network menu.

.

Option 5 is the SNMP menu screen.

SNMP has a lot of power. The user can choose which signals from the adapter get routed to certain machines, which set off alarms, which are ignored or routed with trap menus, etc. For now, the goal is to get bidirectional control of the UPS. Further refinements can be worried about later.

All four Access Control menus need to be reprogrammed. Even though all are visible at the same time, they must be done one at a time. The procedure is to change Control 1, change each sub item, update, and then repeat. Don't worry. It goes quickly.

.

Access type is either Read or Write. Write allows control up the UPS functions such as calibration, testing, and simulation of power failures. With Read only access, only data monitoring occurs. Older adapters came in Read only from the factory. The newer units are Write by default. Be sure to check this setting.

The most important thing is to program in a community name for each of the four menus. This is vital. It acts as a filter for SNMP control. With the wrong Community name, the adapter will not be accessible from HP Openview.

The name public is a good one to start with. Everyone uses it, and it can be changed later if necessary. Enter option 1 to change the name and then option 4 to save it. After all four Access Control menus have been updated, the SNMP menu will look like:

.

Now reprogram the NMS IP settings. NMS is the Network Management Server, the machine that controls the SNMP card. Older UPS SNMP cards did not require these fields to be updated. The newer units do.

If you can Telenet into the adapter, but it isn't visible to Openview, check these values along with the Community name.

These fields are usually the same value. In this case the new value is 129.46.91.211. Make sure that it is in the same subnet mask range as the main IP. For example, if the adapter IP was 129.46.91.211 and the mask was 255.255.255.248, don't use a NMS of 129.46.91.100. The mask will screen it out.

.

In this case a Telenet session changed the NMS IP values.            

back to Technote page       return to home page

HP Openview Setup Menus

Now that the SNMP adapter is on line, HP Openview needs a few drivers and menus setup to see the SNMP card of the UPS as something other than a generic IP device. (This procedure assumes that APC's POWERNET is either part of your Openview package or installed before this point to enable the GUI interface of Openview.) First add the SNMP control drivers, the MIB files.

.

The MIBS that need to be added are in the right column. Only RFC1213.MIB and RFC1232.MIB are part of the software package. The other three will need to be brought over from the Import button. They are on floppies in the SNMP adapter and POWERNET APC packages.

Next the Openview database needs to have the SNMP Device Query setup for the UPS. The main menu is

SNMP Manager-Define Query. The sub menu is under private-enterprises-apc-hardware.

.

Use the Up/Down menu buttons to get to this menu. Be sure to add [measureUps], etc. if you plan to hang other accessories on the UPS. For most cases, just highlight [ups] and then Add. Click the Perform button to check for UPS communication.

.

If the Openview software is not on the same subnet as the SNMP adapter, you may have to tell it which network has the SNMP controller. This is in the Configure Discovery Networks menu On this network the settings are correct by default. Otherwise add the Net Address and Subnet Mask in the space provided. IP Maximum hops may need to be increased if your adapter lives on the other side of server or router. Be sure the Community matches the SNMP adapter on your UPS!

 

Once the UPS database has been updated, the Discovery Manager will be able to correctly identify the UPS. In this case it is a Smart-UPS 700 at address 129.46.91.213.

.

Go to the layout screens and look for the new UPS entry.

.

Life is good at this point. Right click on the UPS ICON at 129.46.91.213, and the POWERNET software will start.

.

The voltage screen is hidden behind the battery screen.

This screen shows the UPS input and output voltages over time. In this case a small voltage spike caused the UPS to kick off a bit before 7pm.

If the temperature probe is part of the measuring package, you can click on the Thermometer/Moisture ICON to bring up that data.

That's it!  back to Technote page       return to home page