ADDING 3rd PARTY UPS in OpManager

ADDING 3rd PARTY UPS in OpManager

Any type of UPS can be monitored by making some configuration changes, provided the corresponding mib supports all the monitored parameters.

Here are the details of the configuration changes.
(Example: Powerware UPS - Powerware mib supports most of the parameters we monitor for APC)

1. Add a new device type (say, Powerware UPS) using the Admin -> Device Templates.

2. To customize the UPS Snapshot Page to view Battery Status, Voltage etc., edit the <OpManager-Home>/conf/ups_monitors.xml file.

The various UPS parameters defined in this file are:

a) Link State (linkState)
b) Battery Status (batteryStatus)
c) Battery Run Time (batteryRunTime)
d) Battery Health (batteryHealth)
e) Last Test Result (lastTestResult)
f) Output Voltage (outputVolts)
g) Ouput Current (outputCurrent)
h) Last Self Test Date (lastSelfTestDate)

UPS specific MIBs may not have the same name for those mentioned above.

3. Find below the procedure to add an entry to this file.

Every parameter to be monitored is specified under the <MONITOR name="monitor-name"> </MONITOR> Tag and the value for these parameters is defined using the <PARAM> Tag within the MONITOR Tag.

a) You need to add the UPS Model which you wish to monitor and its sysOID to this file
Code:

<MONITOR name="upsModel">
<PARAM type="APC UPS" oid=".1.3.6.1.4.1.318.1.1.1.1.1.1.0"/>
<PARAM type="Powerware UPS" oid=".1.3.6.1.4.1.534.1.1.2.0"/>
<DEFAULT oid=".1.3.6.1.2.1.33.1.1.2.0"/>
</MONITOR>


b) To add linkState to Powerware UPS, the entry will look like:

Code:
<PARAM type="Powerware UPS" oid=".1.3.6.1.4.1.534.1.4.5.0">
<DISPLAY key="1" value="Other" severity="5"/>
<DISPLAY key="other(1)" value="Other" severity="5"/>
<DISPLAY key="2" value="None" severity="1"/>
<DISPLAY key="none(2)" value="None" severity="1"/>
<DISPLAY key="3" value="Normal" severity="5"/>
<DISPLAY key="normal(3)" value="Normal" severity="5"/>
<DISPLAY key="4" value="Bypass" severity="5"/>
<DISPLAY key="bypass(4)" value="Bypass" severity="5"/>
<DISPLAY key="5" value="Battery" severity="1"/>
<DISPLAY key="battery(5)" value="Battery" severity="1"/>
<DISPLAY key="6" value="Booster" severity="5"/>
<DISPLAY key="booster(6)" value="Booster" severity="5"/>
<DISPLAY key="7" value="Reducer" severity="5"/>
<DISPLAY key="reducer(7)" value="Reducer" severity="5"/>
<DISPLAY key="8" value="Parallel Capacity" severity="5"/>
<DISPLAY key="parallelCapacity(8)" value="Parallel Capacity" severity="5"/>
<DISPLAY key="9" value="Parallel Redundant" severity="5"/>
<DISPLAY key="parallelRedundant(9)" value="Parallel Redundant" severity="5"/>
<DISPLAY key="10" value="High Efficiency Mode" severity="5"/>
<DISPLAY key="highEfficiencyMode(10)" value="High Efficiency Mode" severity="5"/>
<DISPLAY key="11" value="Maintenance Bypass" severity="5"/>
<DISPLAY key="maintenanceBypass(11)" value="Maintenance Bypass" severity="5"/>
</PARAM>


The values for linkState OID depend on the UPS Model you use. Every value has to be specified twice as shown above.

In Powerware UPS, the value for linkState OID can vary from 1 to 11. Every numeric value corresponds to a string value ( like other, none, normal, parallelredundant, highEfficiencymode, maintenanceBypass etc...). You can define your own Severity level from 1 to 5 ( Critical to Clear ). You should create two display entries - one with the numeric value and the other with the string value.

c) For batteryStatus, the value will look like:
Code:

<PARAM type="Powerware UPS" oid=".1.3.6.1.4.1.534.1.2.5.0">
<DISPLAY key="1" value="Battery Charging" severity="1"/>
<DISPLAY key="batteryCharging(1)" value="Battery Charging" severity="1"/>
<DISPLAY key="2" value="Battery Discharging" severity="1"/>
<DISPLAY key="batteryDischarging(2)" value="Battery Discharging" severity="1"/>
<DISPLAY key="3" value="Battery Floating" severity="1"/>
<DISPLAY key="batteryFloating(3)" value="Battery Floating" severity="1"/>
<DISPLAY key="4" value="Battery Resting" severity="5"/>
<DISPLAY key="batteryResting(4)" value="Battery Resting" severity="5"/>
<DISPLAY key="5" value="Unknown" severity="5"/>
<DISPLAY key="unknown(5)" value="Unknown" severity="5"/>
</PARAM>


The values batteryStatus OID depend on the UPS Model you use. Every value has to be specified twice as shown above.

In Powerware UPS, the value for batteryStatus OID can vary from 1 to 5. Every numeric value corresponds to a string value ( like batteryCharging, batteryDischarging, batteryFloating etc...). You can define your own Severity level from 1 to 5 ( Critical to Clear ). You should create two display entries - one with the numeric value and the other with the string value.

d) Battery Run Time value is specified like

Code:
<MONITOR name="batteryRuntime">
<PARAM type="APC UPS" oid=".1.3.6.1.4.1.318.1.1.1.2.2.3.0"/>
<PARAM type="Powerware UPS" oid=".1.3.6.1.4.1.534.1.2.1.0"/>
</MONITOR>


e) Battery Health OID is not specified in the Powerware UPS MIB.

f) lastTestResult entry will look like
Code:

<PARAM type="Powerware UPS" oid=".1.3.6.1.4.1.534.1.8.4.0">
<DISPLAY key="1" value="Unknown" severity="5"/>
<DISPLAY key="unknown(1)" value="Unknown" severity="5"/>
<DISPLAY key="2" value="Passed" severity="5"/>
<DISPLAY key="passed(2)" value="Passed" severity="5"/>
<DISPLAY key="3" value="Failed" severity="1"/>
<DISPLAY key="failed(3)" value="Failed" severity="1"/>
<DISPLAY key="4" value="Test in Progress" severity="5"/>
<DISPLAY key="inProgress(4)" value="Test in Progress" severity="5"/>
<DISPLAY key="5" value="Not Supported" severity="5"/>
<DISPLAY key="notSupported(5)" value="Not Supported" severity="5"/>
<DISPLAY key="6" value="Inhibited" severity="5"/>
<DISPLAY key="inhibited(6)" value="Inhibited" severity="5"/>
<DISPLAY key="7" value="Scheduled" severity="5"/>
<DISPLAY key="scheduled(7)" value="Scheduled" severity="5"/>
</PARAM>


The values lastTestResult OID depend on the UPS Model you use. Every value has to be specified twice as shown above.

In Powerware UPS, the value for lastTestResult OID can vary from 1 to 7. Every numeric value corresponds to a string value ( like other, passed, failed, inProgress, scheduled etc...). You can define your own Severity level from 1 to 5 ( Critical to Clear ). You should create two display entries - one with the numeric value and the other with the string value.

g) Output Voltage entry looks like:

Code:
<PARAM type="Powerware UPS" oid=".1.3.6.1.4.1.534.1.4.4.1.2.0"/>


h) Output Current entry looks like:

Code:
<PARAM type="Powerware UPS" oid=".1.3.6.1.4.1.534.1.4.4.1.3.0"/>


i) lastSelfTestDate OID is not available in the Powerware MIB.

Save the changes done.

4. Stop and Start OpManager Service.