1 SNMP Release Notes
1.1 SNMP Development Toolkit 4.13.1
Version 4.13.1 supports code replacement in runtime from/to
version 4.13.
1.1.1 Improvements and new features
-
1.1.2 Reported Fixed Bugs and Malfunctions
-
[manager] Registration of users had some issues.
Not all of the registration functions where actually exported
(register_user/4
and
register_user_monitor/4).
This has now been fixed.
Also, the registration did not succeed unless
user implemented the *new* behaviour. This has now
also been fixed (registration succeeds if the user
implements either the new (i.e. updated
snmpm_user)
or the old user behaviour (snmpm_user_old)).
Own Id: OTP-7902
Aux Id: Seq 11240
1.1.3 Incompatibilities
-
1.2 SNMP Development Toolkit 4.13
1.2.1 Improvements and new features
-
[agent] Support for the discovery process.
The agent can both initiate discovery itself (see the
discovery chapter
for more info) and respond to discovery initiated by a manager.
Own Id: OTP-7571
Aux Id: Seq 11053
1.2.2 Reported Fixed Bugs and Malfunctions
-
[agent] Unnecessary use of math:pow/2 could cause problems
on systems without floating point support.
Per Hedeland
Own Id: OTP-7735
-
[manager] A major flaw was discovered with the agent handling.
First, TargetName was never used as intended, as a unique
identifier for the target (agent in this case).
Second, TargetName had a default value, which meant
that several agents could have the same TargetName, causing
unpredictable behaviour in the manager.
Third, EngineID was not a mandatory config option and had
furthermore also a default value.
These problems has been solved in the following way:
First, a new set of api functions has been introduced (and documented):
register_user/4,
register_user_monitor/4,
register_agent/3,
unregister_agent/2,
agent_info/2,
update_agent_info/4,
sync_get/3,4,5,6,
async_get/3,4,5,6,
sync_get_next/3,4,5,6,
async_get_next/3,4,5,6,
sync_set/3,4,5,6,
async_set/3,4,5,6,
sync_get_bulk/5,6,7,8 and
async_get_bulk/5,6,7,8
that all use TargetName (and not, as previously, Addr
and Port) to identify the agent (also the return value of
which_agents has
been changed).
Second, for backward compatibillity, the old functions still
exist, but are no longer documented and are now wrappers for the
new functions, including erroneous default value for EngineID and
all. The TargetName is however generated from the provided
Addr, Port and Version config options.
Third, the behaviour of the
SNMP manager user has
been changed to reflect this, i.e.
handle_pdu/4,
handle_trap/3,
handle_inform/3,
handle_report/3
and the return-value of
handle_agent/4.
The old (non-documented) callback-functions (using Addr and Port)
will still be called if the agent was registered using the old
registration functions.
Own Id: OTP-7836
1.2.3 Incompatibilities
-
1.3 SNMP Development Toolkit 4.12.2
Version 4.12.2 supports code replacement in runtime from/to
version 4.12.1, 4.12, 4.11.2, 4.11.1 and 4.11.
1.3.1 Improvements and new features
-
1.3.2 Reported Fixed Bugs and Malfunctions
-
[agent] Bad session cache (usm+camv-info) invalidation
could cause user crash, through call(s) to (a number of)
MIB API function(s) (undefined function).
Own Id: OTP-7868
1.3.3 Incompatibilities
-
1.4 SNMP Development Toolkit 4.12.1
Version 4.12.1 supports code replacement in runtime from/to
version 4.12, 4.11.2, 4.11.1 and 4.11.
1.4.1 Improvements and new features
-
1.4.2 Reported Fixed Bugs and Malfunctions
-
Logging of messages with the GetBulk-request PDU
incorrectly produced an erroneous entry in the
log: "An error occured".
The reason for this was that the PDU-fields
error_status and error_index is re-used for
Non-repeaters and Max-repetitions for
GetBulk-request PDUs, but this was not handled
by the logging code.
Own Id: OTP-7695
Aux Id: Seq 11124
-
[agent] An attempt to set the row status to active for an
notReady table row, could result in an "inconsistentValue"
error.
The same problem existed when attempting to set row status
to notInService for a row in notReady.
Serge Aleynikov
Own Id: OTP-7698
1.4.3 Incompatibilities
-
1.5 SNMP Development Toolkit 4.12
Version 4.12 supports code replacement in runtime from/to
version 4.11.2, 4.11.1 and 4.11.
1.5.1 Improvements and new features
-
[agent] A simple lookup cache has been added to improve
the mib server lookup performance.
This can be disabled with the mib_server
cache option.
Own Id: OTP-7346
-
[agent] Improvement of the inform reporting.
It was previously not certain how many acks an
application received, 0, 1 or 2. This has now been
fixed, so that only 1 (one) ack is issued.
Per Hedeland
Own Id: OTP-7525
1.5.2 Reported Fixed Bugs and Malfunctions
-
1.5.3 Incompatibilities
-
1.6 SNMP Development Toolkit 4.11.2
Version 4.11.2 supports code replacement in runtime from/to
version 4.11.1 and 4.11.
1.6.1 Improvements and new features
-
1.6.2 Reported Fixed Bugs and Malfunctions
-
[manager] Erroneous engine-id check when receiving version 3
informs.
Own Id: OTP-7570
Aux Id: Seq 11060
-
Receiving an snmp message with a very large version
number could cause the erlang node to run out of
memory and consequently crash.
The standard specifies the snmp version as an
(unlimited) INTEGER, but today only
0 (version 1), 1 (version 2) and 3 (version 3) is
actually used. So, when decoding a message, a limit
has been put on the snmp version integer in order
to not allow this kind of a problem.
Own Id: OTP-7575
Aux Id: Seq 11064
1.6.3 Incompatibilities
-
1.7 SNMP Development Toolkit 4.11.1
Version 4.11.1 supports code replacement in runtime from/to
version 4.11.
1.7.1 Improvements and new features
-
[compiler] The MIB compiler did not retreive the REFERENCE part
of a SNMP MIB definition.
This problem has been partly solved. For SNMP tables,
the assocList field of the tables mib-entry record now contains
this info (as {reference, string()}), if the
MIB was compiled with the compiler option +reference.
This solution is temporary, until such time as a permanent
solution (and probably not backward compatible) is devised, which
retreives and stores all REFERENCE part(s) of a MIB.
See the
compiler options
for more info.
Serge Aleynikov
Own Id: OTP-7426
-
Added utility functions for transforming DateAndTime
as [int()] to strings;
date_and_time_to_string/2
and
date_and_time_to_string2/1.
Also added new validation function
validate_date_and_time/2.
Own Id: OTP-7412
Aux Id: Seq 10987
1.7.2 Reported Fixed Bugs and Malfunctions
-
[manager] Encryption error when attempting to send
version 3 inform-requests.
Own Id: OTP-7432
Aux Id: Seq 10966
1.7.3 Incompatibilities
-
1.8 SNMP Development Toolkit 4.11
Version 4.11 supports code replacement in runtime from/to
version 4.10.3, 4.10.2, 4.10.1 and 4.10.
1.8.1 Improvements and new features
-
[agent] Performance improvements in the case when an SNMP
manager performs an snmpwalk.
Martin Björklund
Own Id: OTP-7201
-
The API for sending inform(s) has been improved. Also
the documentation has been corrected and updated. See
snmpa:send_notification and
snmpa_notification_delivery_info_receiver
for more info.
Own Id: OTP-7287
Aux Id: Seq 10926
-
[agent] Performance of the internal database (local-db)
has been improved.
Own Id: OTP-7319
Aux Id: Seq 10942
-
[agent] Added utility functions,
snmpa:restart_worker/0,1 and
snmpa:restart_set_worker/0,1,
for restarting the agent worker processes (in case the agent is
multi-threaded).
Own Id: OTP-7369
-
Add utility function to
read
a compiled mib.
Own Id: OTP-7371
1.8.2 Reported Fixed Bugs and Malfunctions
-
[manager] Encryption error when attempting to send
version 3 inform-requests.
Own Id: OTP-7377
Aux Id: Seq 10966
1.8.3 Incompatibilities
-
1.9 Release notes history
For information about older versions see
release notes history.
snmp 4.13.1
Copyright © 1991-2009
Ericsson AB