Network Working Group J. Quittek
Internet-Draft R. Winter
Intended status: Standards Track T. Dietz
Expires: September 1, 2011 NEC Europe Ltd.
February 28, 2011
Definiton of Managed Objects for Battery Monitoring
draft-quittek-eman-battery-mib-00.txt
Abstract
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community.
In particular, it defines managed objects that provide information on
the status of batteries in managed devices.
Status of this Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on September 1, 2011.
Copyright Notice
Copyright (c) 2011 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 1]
Internet-Draft Power MIB Modules February 2011
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. The Internet-Standard Management Framework . . . . . . . . . . 4
3. Structure of the Battery MIB module . . . . . . . . . . . . . 4
4. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 5
5. Security Considerations . . . . . . . . . . . . . . . . . . . 17
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 18
7. Open Issues . . . . . . . . . . . . . . . . . . . . . . . . . 18
7.1. Battery temperature . . . . . . . . . . . . . . . . . . . 18
7.2. Scale of the charge percentage . . . . . . . . . . . . . . 18
7.3. Define Charging Cycle . . . . . . . . . . . . . . . . . . 18
7.4. Define Battery States 'full' and 'emplty' . . . . . . . . 18
7.5. batteryTable Indexing . . . . . . . . . . . . . . . . . . 18
8. References . . . . . . . . . . . . . . . . . . . . . . . . . . 18
8.1. Normative References . . . . . . . . . . . . . . . . . . . 18
8.2. Informative References . . . . . . . . . . . . . . . . . . 19
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 19
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 2]
Internet-Draft Power MIB Modules February 2011
1. Introduction
Today more and more managed devices contain batteries that supply
them with power when disconnected from electrical power distribution
grids. Common examples are nomadic and mobile devices, such as
notebook computers, netbooks, and smart phones. The status of
batteries in such a device, particularly the charging status is
typically controlled by automatic functions that act locally on the
device and manually by users of the device.
In addition to this, there is a need to monitor battery status of
these devices by network management systems. This document defines a
portion of the Management Information Base (MIB) that meets the
requirements for monitoring the status of batteries described in
[I-D.ietf-eman-requirements]. Managed objects defined in Section 4
serve for monitoring
o the current charge of a battery,
o the age of a battery (charging cycles),
o the state of a battery (e.g. being re-charged),
o last usage of a battery,
o maximum energy provided by a battery (remaining and total
capacity).
In addition, means are provided for battery-powered devices to send
notifications when the current battery charge has dropped below a
certain threshold in order to inform the management system of needed
replacement. The same applies to the age of a battery.
There is already instrumentation for monitoring battery status on
many battery-driven devices, because this is already needed for local
control of the battery by the device. This reduces the effort for
implementing the managed objects defined in this document. For many
devices only additional software will be needed an no additional
hardware instrumentation for battery monitoring.
A traditional type of managed device containing batteries is an
uninterruptible power supply (UPS) system; these supply other devices
with electrical energy when the main power supply fails. There is
already a MIB module for managing UPS systems defined in RFC 1628
[RFC1628]. This module includes managed objects for monitoring the
batteries contained in an UPS system. However, the information
provided by these objects is limited and tailored the particular
needs of UPS systems.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119].
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 3]
Internet-Draft Power MIB Modules February 2011
2. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410].
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the
Structure of Management Information (SMI). This memo specifies MIB
modules that is compliant to the SMIv2, which is described in STD 58,
RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58,RFC 2580
[RFC2580].
3. Structure of the Battery MIB module
The Battery MIB module defined in this document defines objects for
reporting information about batteries. All managed objects providing
information of the status of a battery are contained in a single
table called batteryTable. The batteryTable contains one conceptual
row per battery.
If there is an implementation of the Entity MIB module [RFC4133] that
identifies batteries by individual values for managed object
entPhysicalIndex, then it is RECOMMENDED that these values are used
as index values for the batteryTable.
The kind of entity in the entPhysicalTable of the Entity MIB module
is indicated by the value of enumeration object entPhysicalClass.
Since there is no value called 'battery' defined for this object, it
is RECOMMENDED that for batteries the value of this object is chosen
to be powerSupply(6).
The batteryTable contains three groups of objects. The first group
(OIDs ending with 2-6) provides information on static properties of
the battery. The second group of objects (OIDs ending with 7-14)
provides information on the current battery state, if it is charging
or discharging, how much it is charged, its remaining capacity, the
number of experienced charging cycles, etc.
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 4]
Internet-Draft Power MIB Modules February 2011
batteryTable(1)
+--batteryEntry(1) [batteryIndex]
+-- --- Unsigned32 batteryIndex(1)
+-- r-n Enumeration batteryType(2)
+-- r-n Enumeration batteryTechnology(3)
+-- r-n Unsigned32 batteryNominalVoltage(4)
+-- r-n Unsigned32 batteryNumberOfCells(5)
+-- r-n Unsigned32 batteryNominalCapacity(6)
+-- r-n Unsigned32 batteryRemainingCapacity(7)
+-- r-n Counter32 batteryChargingCycleCount(8)
+-- r-n DateAndTime batteryLastChargingCycleTime(9)
+-- r-n Enumeration batteryState(10)
+-- r-n Unsigned32 batteryCurrentCharge(11)
+-- r-n Unsigned32 batteryCurrentChargePercentage(12)
+-- r-n Unsigned32 batteryCurrentVoltage(13)
+-- r-n Integer32 batteryCurrentCurrent(14)
+-- r-n Unsigned32 batteryLowAlarmPercentage(15)
+-- r-n Unsigned32 batteryLowAlarmVoltage(16)
+-- r-n Unsigned32 batteryReplacementAlarmCapacity(17)
+-- r-n Unsigned32 batteryReplacementAlarmCycles(18)
The third group of objects in this table (OIDs ending with 15-18)
indicates thresholds which can be used to raise an alarm if a
property of the battery exceeds one of them. Raising an alarm may
include sending a notification.
The Battery MIB defines two notifications, one indicating a low
battery charging state and one indicating an aged battery that may
need to be replaced.
4. Definitions
BATTERY-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
mib-2, Integer32, Unsigned32, Counter32
FROM SNMPv2-SMI -- RFC2578
DateAndTime
FROM SNMPv2-TC -- RFC2579
MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
FROM SNMPv2-CONF; -- RFC2580
batteryMIB MODULE-IDENTITY
LAST-UPDATED "201102261200Z" -- 26 February 2010
ORGANIZATION "IETF OPSAWG Working Group"
CONTACT-INFO
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 5]
Internet-Draft Power MIB Modules February 2011
"General Discussion: opsawg@ietf.org
To Subscribe: https://www.ietf.org/mailman/listinfo/opsawg
Archive: http://www.ietf.org/mail-archive/web/opsawg
Editor:
Juergen Quittek
NEC Europe Ltd.
NEC Laboratories Europe
Kurfuersten-Anlage 36
69115 Heidelberg
Germany
Tel: +49 6221 4342-115
Email: quittek@neclab.eu"
DESCRIPTION
"This MIB module defines a set of objects for monitoring
batteries of networked devices and of their components.
Copyright (c) 2010 IETF Trust and the persons identified as
authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and subject
to the license terms contained in, the Simplified BSD License
set forth in Section 4.c of the IETF Trust's Legal Provisions
Relating to IETF Documents
(http://trustee.ietf.org/license-info).
This version of this MIB module is part of RFC yyyy; see
the RFC itself for full legal notices."
-- replace yyyy with actual RFC number & remove this notice
-- Revision history
REVISION "201102261200Z" -- 26 February 2010
DESCRIPTION
"Initial version, published as RFC yyyy."
-- replace yyyy with actual RFC number & remove this notice
::= { mib-2 zzz }
-- zzz to be assigned by IANA.
--******************************************************************
-- Top Level Structure of the MIB module
--******************************************************************
batteryNotifications OBJECT IDENTIFIER ::= { batteryMIB 0 }
batteryObjects OBJECT IDENTIFIER ::= { batteryMIB 1 }
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 6]
Internet-Draft Power MIB Modules February 2011
batteryConformance OBJECT IDENTIFIER ::= { batteryMIB 2 }
--==================================================================
-- 1. Object Definitions
--==================================================================
--------------------------------------------------------------------
-- 1.1. Battery Table
--------------------------------------------------------------------
batteryTable OBJECT-TYPE
SYNTAX SEQUENCE OF BatteryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table provides information on batteries.
It contains one conceptual row per battery."
::= { batteryObjects 1 }
batteryEntry OBJECT-TYPE
SYNTAX BatteryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry providing information on a battery."
INDEX { batteryIndex }
::= { batteryTable 1 }
BatteryEntry ::=
SEQUENCE {
batteryIndex Unsigned32,
batteryType INTEGER,
batteryTechnology INTEGER,
batteryNominalVoltage Unsigned32,
batteryNumberOfCells Unsigned32,
batteryNominalCapacity Unsigned32,
batteryRemainingCapacity Unsigned32,
batteryChargingCycleCount Counter32,
batteryLastChargingCycleTime DateAndTime,
batteryState INTEGER,
batteryCurrentCharge Unsigned32,
batteryCurrentChargePercentage Unsigned32,
batteryCurrentVoltage Unsigned32,
batteryCurrentCurrent Integer32,
batteryLowAlarmPercentage Unsigned32,
batteryLowAlarmVoltage Unsigned32,
batteryReplacementAlarmCapacity Unsigned32,
batteryReplacementAlarmCycles Unsigned32
}
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 7]
Internet-Draft Power MIB Modules February 2011
batteryIndex OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object identifies a battery for which status is
reported. Index values MUST be locally unique.
If there is an instance of the entPhysicalTable (defined in
the ENTITY-MIB module, see RFC 4133) with individual entries
for each battery, then it is RECOMMENDED that values of
batteryIndex match the corresponding values of
entPhysicalIndex for the batteries. Otherwise, index values
may be chosen arbitrarily."
::= { batteryEntry 1 }
batteryType OBJECT-TYPE
SYNTAX INTEGER {
primary(1),
rechargeable(2),
capacitor(3),
other(4),
unknown(5)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the type of battery. It distinguishes
between one-way primary batteries, rechargeable secondary
batteries and capacitors which are not really batteries but
often used in the same way as a battery.
The value other(4) can be used if the battery type is known
but none of the ones above. Value unknown(5) is to be used
if the type of battery cannot be determined."
::= { batteryEntry 2 }
batteryTechnology OBJECT-TYPE
SYNTAX INTEGER {
zincCarbon(1),
zincChloride(2),
oxyNickelHydroxide(3),
lithiumCopper(4),
lithiumIron(5),
lithiumManganese(6),
zincAir(7),
silverOxide(8),
alcaline(9),
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 8]
Internet-Draft Power MIB Modules February 2011
leadAcid(10),
nickelCadmium(12),
nickelMetalHybride(13),
nickelZinc(14),
lithiumIon(15),
lithiumPolymer(16),
doubleLayerCapacitor(17),
other(18),
unknown(19)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the technology used by the battery.
Values 1-8 are primary battery technologies, values 10-16
are rechargeable battery technologies and value alkaline(9)
is used for primary batteries as well as for rechargeable
batteries.
The value other(18) can be used if the battery type is known
but none of the ones above. Value unknown(19) is to be used
if the type of battery cannot be determined."
::= { batteryEntry 3 }
batteryNominalVoltage OBJECT-TYPE
SYNTAX Unsigned32
UNITS "millivolt"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object provides the nominal voltage of the battery
in units of millivolt (mV).
Note that the nominal voltage is a constant value and
typically different from the actual voltage of the battery.
A value of 0 indicates that the nominal voltage is unknown."
::= { batteryEntry 4 }
batteryNumberOfCells OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the number of cells contained in the
battery.
A value of 0 indicates that the number of cells is unknown."
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 9]
Internet-Draft Power MIB Modules February 2011
::= { batteryEntry 5 }
batteryNominalCapacity OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliampere hours"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object provides the nominal capacity of the battery
in units of milliampere hours (mAh).
Note that the nominal capacity is a constant value and
typically different from the actual capacity of the battery.
A value of 0 indicates that the nominal capacity is unknown."
::= { batteryEntry 6 }
batteryRemainingCapacity OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliampere hours"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object provides the ACTUAL REMAINING capacity of the
battery in units of milliampere hours (mAh).
Note that the actual capacity needs to be measured and is
typically an estimate based on observed discharging and
charging cycles of the battery.
A value of 'ffffffff'H indicates that the actual capacity
cannot be determined."
::= { batteryEntry 7 }
batteryChargingCycleCount OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the number of charging cycles that
that the battery underwent. Please note that the precise
definition of a recharge cycle varies for different kinds
of batteries and of devices containing batteries.
For batteries of type primary(1) the value of this object is
always 0.
A value of 'ffffffff'H indicates that the number of charging
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 10]
Internet-Draft Power MIB Modules February 2011
cycles cannot be determined."
::= { batteryEntry 8 }
batteryLastChargingCycleTime OBJECT-TYPE
SYNTAX DateAndTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The date and time of the last charging cycle. The value
'0000000000000000'H is returned if the battery has not been
charged yet or if the last charging time cannot be
determined.
For batteries of type primary(1) the value of this object is
always '0000000000000000'H."
::= { batteryEntry 9 }
batteryState OBJECT-TYPE
SYNTAX INTEGER {
full(1),
partiallyCharged(2),
empty(3),
charging(4),
discharging(5),
unknown(6)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object indicates the current state of the battery.
Value full(1) indicates a full battery with a capacity
given by onject batteryRemainingCapacity. Value empty(3)
indicates a battery that cannot be used for providing
electric power before charging it. Value partiallyCharged(2)
is provided if the battery is neither empty nor full and if
no charging or discharging is in progress. Charging or
discharging of hte battery is indicated by values charging(3)
or discharging(4), respectively.
Value unknown(6) is to be used if the state of the battery
cannot be determined."
::= { batteryEntry 10 }
batteryCurrentCharge OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliampere hours"
MAX-ACCESS read-only
STATUS current
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 11]
Internet-Draft Power MIB Modules February 2011
DESCRIPTION
"This object provides the current charge of the battery
in units of milliampere hours (mAh).
Note that the current charge needs to be measured and is
typically an estimate based on observed discharging and
charging cycles of the battery.
A value of 'ffffffff'H indicates that the current charge
cannot be determined."
::= { batteryEntry 11 }
batteryCurrentChargePercentage OBJECT-TYPE
SYNTAX Unsigned32 (0..10000)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object provides the current charge of the battery
relative to the nominal capacity in units of a hundreds
of a percent.
--------------------------
-- Open issue:
-- Should it be the percentage of the nominal capacity
-- or of the current capacity?
--------------------------
Note that this value needs to be measured and is
typically an estimate based on observed discharging and
charging cycles of the battery.
A value of 'ffffffff'H indicates that the relative current
charge cannot be determined."
::= { batteryEntry 12 }
batteryCurrentVoltage OBJECT-TYPE
SYNTAX Unsigned32
UNITS "millivolt"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object provides the current voltage of the battery
in units of millivolt (mV).
A value of 'ffffffff'H indicates that the current voltage
cannot be determined."
::= { batteryEntry 13 }
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 12]
Internet-Draft Power MIB Modules February 2011
batteryCurrentCurrent OBJECT-TYPE
SYNTAX Integer32
UNITS "milliampere"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object provides the current charging or discharging
current of the batteryin units of milliampere (mA). Charging
current is indicated by positive values, discharging current
is indicated by negative values.
A value of '7fffffff'H indicates that the current current
cannot be determined."
::= { batteryEntry 14 }
batteryLowAlarmPercentage OBJECT-TYPE
SYNTAX Unsigned32 (0..10000)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object provides the lower threshold value for object
batteryCurrentChargePercentage. If the value of object
batteryCurrentChargePercentage falls below this threshold,
a low battery alarm will be raised. The alarm procedure may
include generating a batteryLowNotification.
A value of 0 indicates that the no alarm will be raised for
any value of object batteryCurrentChargePercentage."
::= { batteryEntry 15 }
batteryLowAlarmVoltage OBJECT-TYPE
SYNTAX Unsigned32
UNITS "millivolt"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object provides the lower threshold value for object
batteryCurrentVoltage. If the value of object
batteryCurrentVoltage falls below this threshold,
a low battery alarm will be raised. The alarm procedure may
include generating a batteryLowNotification.
A value of 0 indicates that the no alarm will be raised for
any value of object batteryCurrentVoltage."
::= { batteryEntry 16 }
batteryReplacementAlarmCapacity OBJECT-TYPE
SYNTAX Unsigned32
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 13]
Internet-Draft Power MIB Modules February 2011
UNITS "milliampere hours"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object provides the lower threshold value for object
batteryRemainingCapacity. If the value of object
batteryRemainingCapacity falls below this threshold,
a battery aging alarm will be raised. The alarm procedure
may include generating a batteryAgingNotification.
A value of 0 indicates that the no alarm will be raised for
any value of object batteryRemainingCapacity."
::= { batteryEntry 17 }
batteryReplacementAlarmCycles OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliampere hours"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object provides the upper threshold value for object
batteryChargingCycleCount. If the value of object
batteryChargingCycleCount rises above this threshold,
a battery aging alarm will be raised. The alarm procedure
may include generating a batteryAgingtNotification.
A value of 0 indicates that the no alarm will be raised for
any value of object batteryChargingCycleCount."
::= { batteryEntry 18 }
--==================================================================
-- 2. Notifications
--==================================================================
batteryLowNotification NOTIFICATION-TYPE
OBJECTS {
batteryCurrentChargePercentage,
batteryCurrentVoltage
}
STATUS current
DESCRIPTION
"This notification can be generated when the current charge
(batteryCurrentChargePercentage) or the current voltage
(batteryCurrentVoltage) of the battery falls below a
threshold defined by object batteryLowAlarmPercentage or
object batteryLowAlarmVoltage, respectively."
::= { batteryNotifications 1 }
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 14]
Internet-Draft Power MIB Modules February 2011
batteryAgingNotification NOTIFICATION-TYPE
OBJECTS {
batteryRemainingCapacity,
batteryChargingCycleCount
}
STATUS current
DESCRIPTION
"This notification can be generated when the remaining
capacity (batteryRemainingCapacity) falls below a threshold
defined by object batteryReplacementAlarmCapacity
or when the charging cycle count of the battery
(batteryChargingCycleCount) exceeds the threshold defined
by object batteryLowAlarmPercentage."
::= { batteryNotifications 2 }
--==================================================================
-- 3. Conformance Information
--==================================================================
batteryCompliances OBJECT IDENTIFIER ::= { batteryConformance 1 }
batteryGroups OBJECT IDENTIFIER ::= { batteryConformance 2 }
--------------------------------------------------------------------
-- 3.1. Compliance Statements
--------------------------------------------------------------------
batteryCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for implementations of the
POWER-STATE-MIB module.
A compliant implementation MUST implement the objects
defined in the mandatory group psmRequiredGroup."
MODULE -- this module
MANDATORY-GROUPS {
batteryDescriptionGroup,
batteryStatusGroup,
batteryAlarmThresholdsGroup
}
GROUP batteryNotificationsGroup
DESCRIPTION
"A compliant implementation does not have to implement
the psmNotificationsGroup."
::= { batteryCompliances 1 }
--------------------------------------------------------------------
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 15]
Internet-Draft Power MIB Modules February 2011
-- 3.2. MIB Grouping
--------------------------------------------------------------------
batteryDescriptionGroup OBJECT-GROUP
OBJECTS {
batteryType,
batteryTechnology,
batteryNominalVoltage,
batteryNumberOfCells,
batteryNominalCapacity
}
STATUS current
DESCRIPTION
"A compliant implementation MUST implement the objects
contained in this group."
::= { batteryGroups 1 }
batteryStatusGroup OBJECT-GROUP
OBJECTS {
batteryRemainingCapacity,
batteryChargingCycleCount,
batteryLastChargingCycleTime,
batteryState,
batteryCurrentCharge,
batteryCurrentChargePercentage,
batteryCurrentVoltage,
batteryCurrentCurrent
}
STATUS current
DESCRIPTION
"A compliant implementation MUST implement the objects
contained in this group."
::= { batteryGroups 2 }
batteryAlarmThresholdsGroup OBJECT-GROUP
OBJECTS {
batteryLowAlarmPercentage,
batteryLowAlarmVoltage,
batteryReplacementAlarmCapacity,
batteryReplacementAlarmCycles
}
STATUS current
DESCRIPTION
"A compliant implementation MUST implement the objects
contained in this group."
::= { batteryGroups 3 }
batteryNotificationsGroup NOTIFICATION-GROUP
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 16]
Internet-Draft Power MIB Modules February 2011
NOTIFICATIONS {
batteryLowNotification,
batteryAgingNotification
}
STATUS current
DESCRIPTION
"A compliant implementation does not have to implement the
notification contained in this group."
::= { batteryGroups 4 }
END
5. Security Considerations
There are no management objects defined in this MIB module that have
a MAX-ACCESS clause of read-write and/or read-create. So, if this
MIB module is implemented correctly, then there is no risk that an
intruder can alter or create any management objects of this MIB
module via direct SNMP SET operations.
Some of the readable objects in this MIB module (i.e., objects with a
MAX-ACCESS other than not-accessible) may be considered sensitive or
vulnerable in some network environments. It is thus important to
control even GET and/or NOTIFY access to these objects and possibly
to even encrypt the values of these objects when sending them over
the network via SNMP. These are the tables and objects and their
sensitivity/vulnerability:
o This list is still to be done.
SNMP versions prior to SNMPv3 did not include adequate security.
Even if the network itself is secure (for example by using IPsec),
even then, there is no control as to who on the secure network is
allowed to access and GET/SET (read/change/create/delete) the objects
in this MIB module.
It is RECOMMENDED that implementers consider the security features as
provided by the SNMPv3 framework (see [RFC3410], section 8),
including full support for the SNMPv3 cryptographic mechanisms (for
authentication and privacy).
Further, deployment of SNMP versions prior to SNMPv3 is NOT
RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to
enable cryptographic security. It is then a customer/operator
responsibility to ensure that the SNMP entity giving access to an
instance of this MIB module is properly configured to give access to
the objects only to those principals (users) that have legitimate
rights to indeed GET or SET (change/create/delete) them.
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 17]
Internet-Draft Power MIB Modules February 2011
6. IANA Considerations
The MIB modules in this document uses the following IANA-assigned
OBJECT IDENTIFIER values recorded in the SMI Numbers registry:
Descriptor OBJECT IDENTIFIER value
---------- -----------------------
batteryMIB { mib-2 xxx }
Other than that this document does not impose any IANA
considerations.
7. Open Issues
7.1. Battery temperature
Is there a need to report the temperature of the battery? The UPS
MIB does so with object upsBatteryTemperature.
7.2. Scale of the charge percentage
Should object batteryCurrentChargePercentage report the percentage of
the current charge with respect to the nominal battery capacity or
with respect to the remaining capacity?
7.3. Define Charging Cycle
The draft is not clear about what a charging cycle is. Is there any
commonly accpted definition of it?
7.4. Define Battery States 'full' and 'emplty'
Is a battery 'full' if it is charged 99%? When is it empty? Is it
full if it has reached remaining capacity or only if it has achieved
nominal capacity?
7.5. batteryTable Indexing
Shall we link the index to the pmIndex in the POWER-AWARE-MIB?
8. References
8.1. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 18]
Internet-Draft Power MIB Modules February 2011
[RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Structure of Management Information
Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.
[RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Textual Conventions for SMIv2",
STD 58, RFC 2579, April 1999.
[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
"Conformance Statements for SMIv2", STD 58, RFC 2580,
April 1999.
[RFC4133] Bierman, A. and K. McCloghrie, "Entity MIB (Version 3)",
RFC 4133, August 2005.
8.2. Informative References
[I-D.ietf-eman-requirements]
Quittek, J., Winter, R., Dietz, T., Claise, B., and M.
Chandramouli, "Requirements for Power Monitoring",
draft-ietf-eman-requirements-00 (work in progress),
December 2010.
[RFC1628] Case, J., "UPS Management Information Base", RFC 1628,
May 1994.
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002.
Authors' Addresses
Juergen Quittek
NEC Europe Ltd.
NEC Laboratories Europe
Network Research Division
Kurfuersten-Anlage 36
Heidelberg 69115
DE
Phone: +49 6221 4342-115
Email: quittek@neclab.eu
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 19]
Internet-Draft Power MIB Modules February 2011
Rolf Winter
NEC Europe Ltd.
NEC Laboratories Europe
Network Research Division
Kurfuersten-Anlage 36
Heidelberg 69115
DE
Phone: +49 6221 4342-121
Email: Rolf.Winter@neclab.eu
Thomas Dietz
NEC Europe Ltd.
NEC Laboratories Europe
Network Research Division
Kurfuersten-Anlage 36
Heidelberg 69115
DE
Phone: +49 6221 4342-128
Email: Thomas.Dietz@neclab.eu
Quittek, et al. draft-quittek-eman-battery-mib-00.txt [Page 20]