1 SNMP Release Notes
1.1 SNMP Development Toolkit v3.1.2
Version 3.1.2 supports code replacement in runtime from versions 3.1.1 and 3.0.6.
1.1.1 Improvements and new features
- The fact that the MIBs SNMPv2-SMI, RFC-1215, RFC-1212, SNMPv2-TC, SNMPv2-CONF and RFC1155-SMI are compiler built-ins, has been added to the compiler documentation.
Own Id: OTP-3316
Aux Id:
- The agent option
authentication_service
has been reintroduced. This option is part of an SNMP internal API.
Own Id: OTP-3324
Aux Id:
- It has been clarified in the documentation, that the value of
snmpEngineID
should not be just a simple string, but has to follow the conventions specified in RFC 2271/2571.
Own Id: OTP-3350
Aux Id:
1.1.2 Reported Fixed Bugs and Malfunctions
- If two Erlang nodes are started on the same host, and each node starts an SNMP agent, and if both agents use the same UDP port, the agent that starts last, will completely control the port. The reason for this is that the UDP port is opened with a reuse directive.
A new optionno_reuse_address
, which, if set, causes the reuse directive not to be set.
Own Id: OTP-3317
Aux Id: seq4008
- Debug printouts from
snmp_net_if
appeared even when the debug flag was not set. This has been corrected.
Own Id: OTP-3345
Aux Id: seq4091
1.2 SNMP Development Toolkit v3.1.1
1.2.1 Improvements and new features
- The audit trail log has been improved. Now each log item also contains a time stamp. Also the text format of a log (produced by a call to
snmp:log_to_txt
) has been changed to be more "line oriented".
The functionsnmp:log_to_txt/4
has been added.
Own Id: OTP-3261
Aux Id: seq3884, OTP-3253
- Each item in an audit trail text log file (produced by
snmp:log_to_txt
) now has a trailing TAB character, and any TAB character in the body of a text item is replaced by ESC TAB.
Own Id: OTP-3282
Aux Id: seq3969
- The function
snmp:log_to_txt/5
has been added, so that not only the log name but also the log file name can be specified when converting an audit trail log to text format.
Own Id: OTP-3298
Aux Id:
- A new optional environment variable
bind_to_ip_addess
has been added, controlling if the agent should bind to the specific IP address or not.
Own Id: OTP-3293
Aux Id:
1.2.2 Reported Fixed Bugs and Malfunctions
- Conversion of a log to text format could crash SNMP if the log was already open.
Own Id: OTP-3261
Aux Id: seq3884
- The BER encoding of integers did not follow the ASN.1 BER encoding rules.
Own Id: OTP-3274
Aux Id: seq3960
- SNMP did not start if the audit disk_log file was corrupt.
Own Id: OTP-3290
Aux Id:
- SNMP was not backward compatible with instrumentation functions that returned
{noValue, unSpecified}
(the SNMP agent crashed). This has been changed by silently transforming such a return value to{noValue, noSuchInstance}
.
Own Id: OTP-3303
Aux Id: seq3975
- The header file
snmp_vacm.hrl
was missing in the SNMPsrc
directory.
Own Id: OTP-3327
Aux Id:
1.2.3 Incompatibilities with v3.1
- Applications that parses the audit trail log text files have to be rewritten.
1.3 SNMP Development Toolkit v3.1
1.3.1 Improvement and new features
- Adaption to new format of exit codes.
1.4 SNMP Development Toolkit v3.0.3
1.4.1 Improvements and new features
- A new function
snmp:date_and_time_to_string/1
has been added. It converts a DateAndTime octet string to a string, according to the DISPLAY-HINT in RFC1903.
- A new function
snmp_target_mib:set_target_engine_id/2
has been added. It
1.4.2 Reported Fixed Bugs and Malfunctions
- get-next on vacmAccessTable finds all columns.
Own Id: OTP-3187
Aux Id: seq3647
- The functions in the module
snmp
for manipulating DateAndTime objects didn't handle the year component correctly. Specifically, the two octets representing the year should be coded in hex.
NOTE: see "Incompatibles" below.
Own Id: OTP-3189
Aux Id: seq3655
- It is now possible to create new rows in
snmpTargetAddrTable
inSNMP-TARGET-MIB
. The engine id associated with the target is initialized to "" by default. This can be changed by using the new functionsnmp_target_mib:set_target_engine_id/2
.
1.4.3 Incompatibilities with v3.0.*
- Applications that uses the DateAndTime manipulating functions might need to be rewritten to handle the correct coding of the year component. For example, a function that prints a DateAndTime value needs to be changed. The new function
snmp:date_and_time_to_string/1
can be used.
1.5 SNMP Development Toolkit v3.0.2
1.5.1 Reported Fixed Bugs and Malfunctions
- The agent now starts correctly when a Audit Trail Log is used.
Own Id: OTP-3137
Aux Id: seq3594
1.6 SNMP Development Toolkit v3.0.1
1.6.1 Improvements and new features
- A new function
snmp:change_log_size/1
has been added to dynamically change the size of the Audit Trail Log.
Own Id: OTP-2989
Aux Id: seq1499
1.6.2 Reported Fixed Bugs and Malfunctions
- The function
snmp:get/2
didn't preserve the order of its input variable list. The order of the elements in the returned list was not the same as in the input list.
Own Id: OTP-3134
Aux Id: seq1727
- The record
message
insnmp_types.hrl
has been changed to reflect the new SNMPv3 message format. Specifically, thecommunity
field has changed name tovsn_hdr
. If the message version is v1 or v2c, it is still just the community string, but if the version is v3, it is av3_hdr
record. This change only affects applications that encodes / decodes SNMP messages using the modulesnmp_pdus
. If an application wants to use this new record (i.e. it needs to use SNMPv3), it must define the constantSNMP_USE_V3
before the header file is included. This ensures that old applications that uses the old definition ofmessage
and don't use v3 don't have to be modified.
1.7 SNMP Development Toolkit v3.0
1.7.1 Improvements and new features
- The agent is multi-lingual, and understands SNMPv1, SNMPv2c, and SNMPv3. Full SNMPv3 support is given, including encryption and authentication, but the optional proxy and notification filtering features are not implemented.
- A new function
snmp:send_notification/6
is added, which can be used to specify from which context a notification is sent.
- All relevant standard MIBs are included in the
mibs/
directory in the distribution, for reference purposes.
- The agent uses the application
crypto
for authentication and encryption. If these functions are to be used, thecrypto
application must be started before thesnmp
application.
- The manager supports SNMPv3. A few new options has been added to the start function
snmp_mgr:start/1
.
1.7.2 Reported Fixed Bugs and Malfunctions
- The Mib Compiler now handles forward references in OBJECT IDENTIFIERs.
Own Id: OTP-2942
Aux Id: seq1415
- GET-NEXT on an empty table implemented with
snmp_generic
returns correctly.
Own Id: OTP-2979
Aux Id: seq1496
- The functions
snmp:log_to_text/2,3
can be used when the log is opened and in use by the agent.
Own Id: OTP-2994
Aux Id: seq1508
1.7.3 Incompatibilities with v2.2.x
- The OTP-SNMPEA-MIB is not used anymore. The functionality is provided by standard MIBs. This means that managers that are using this MIB should use the standard MIBs instead. Applications that include the header file
OTP-SNMPEA-MIB.hrl
need to be changed.
- The handling of data in the configuration files vs. data in the actual tables is reworked and made consistent. This means that data changed by a manager survives a reboot, if the manager so wishes (by using the StorageType columns in the tables). There is a new configuration parameter,
force_config_load
which can be set totrue
to get the old behaviour, i.e. that the configuration files are always read at startup.
- The configuration files
address.conf
,view.conf
andtrap_dest.conf
are not used anymore. The formats ofagent.conf
andcommunity.conf
have changed.context.conf
,usm.conf
andvacm.conf
are new files. If the agent is started with the old files, it will convert them to the new files. Note however, that all information is not available in the old files. Thus, it is recommended to check the configuration files manually, or re-generate them usingsnmp:config/0
.
- The module
snmp_mpc
has changed name tosnmp_mpd
, and it is now documented. It should be called only from anet if
process.
1.8 SNMP Development Toolkit v2.2.3
1.8.1 Reported Fixed Bugs and Malfunctions
- When issuing a GET-NEXT request which contains more than one column from a table, and the table is empty, an erroneus GET-RESPONSE was sent to the manager. The agent failed to locate the next object for all columns.
Own Id: OTP-2979
1.9 SNMP Development Toolkit v2.2.2
1.9.1 Reported Fixed Bugs and Malfunctions
- The function
snmp:validate_date_and_time/1
now works for all valid times.
Own Id: OTP-2776
Aux Id: seq1238
- The MIB compiler now handles DEFVALs specified as bit strings (e.g.
'10010'b
.
Own Id: OTP-2826
Aux Id: seq1285
- The MIB compiler now handles DEFVALs for
Opaque
objects. Such a DEFVAL must be in string format, e.g.'c0fa'H
,
Own Id: OTP-2827
Aux Id: seq1285
- The MIB compiler now handles DEFVALs with no bits set for
BITS
objetcs.
Own Id: OTP-2827
Aux Id: seq1285
- The MIB compiler gives better error messages when erroneous DEFVALs are detected.
Own Id: OTP-2827
Aux Id: seq1285
- The MIB compiler gives better error messages when erroneous table definitions are detected.
Own Id: OTP-2832
1.10 SNMP Development Toolkit v2.2.1
1.10.1 Reported Fixed Bugs and Malfunctions
- The example mib EX1-MIB in the user's guide compiles.
Own Id: OTP-2576
Aux Id: seq933
- The supervisor of the mibs has a correct shutdown time (infinity instead of 2 secs).
Own Id: OTP-2606
Aux Id: seq947
- The automatic conversion of trap_dest.conf to the new notify.conf, target_addres.conf, and target_params.conf now gives an error message if the conversion fails.
Own Id: OTP-2647
- The UDP port used by the agent is now opened with the flag
reuseaddr
set to true.
Own Id: OTP-2655
authenticationFailure
are now sent correctly.
Own Id: OTP-2690
- A
get
operation that refers to anot-accessible
object now returns the correct error code.
Own Id: OTP-2691
- The counter
snmpInTotalsetVars
is now updated properly.
Own Id: OTP-2694
1.11 SNMP Development Toolkit v2.2
1.11.1 Improvements and new features
- The agent and
snmp_mgr
support Inform-Requests when sending SNMPv2 notifications, as defined in rfc2273. This means that it is now possible to send a notification and have the agent wait for an acknowledgement from the manager. See the User's guide, "Notification Sending" for a description of the mechanism.
- The agent uses the SNMP-NOTIFICATION-MIB and SNMP-TARGET-MIB from rfc2273 to select notification destinations, instead of the
intTrapDestTable
from OTP-SNMPEA-MIB.
- There are a few new functions in the module
snmp
for trap/notification sending.
- Two new modules are added;
snmp_notification_mib
andsnmp_target_mib
. These modules contain functions for initialising the agent data from configuration files.
- There is a new function
reconfigure/1
insnmp_standard_mib
, which reconfigures the persistent objects from the configuration files.
- The following mibs are added to the distribution for completeness:
- SNMPv2-TM
- SNMPv2-SMI
- SNMPv2-CONF
- SNMP-FRAMEWORK-MIB
- RFC1155-SMI
- RFC-1212
- RFC-1215
1.11.2 Reported Fixed Bugs and Malfunctions
- The
snmp_mgr
no longer crashes if an unknown trap is received.
Own Id: OTP-2137, OTP-2464
- The supervisor of the mibs has a correct shutdown time (infinity instead of 2 secs).
Own Id: OTP-2310
Aux Id: seq767, HA79462
- The Mib Compiler now handles the construct MODULE OtherModule in the MODULE-COMPLIANCE macro.
Own Id: OTP-2465
- The Mib Compiler now handles the construct INTEGER (0..1 | 3..4).
Own Id: OTP-2466
- The Mib Compiler now handles IMPLIED OIDs
Own Id: OTP-2467
- The Mib Compiler now handles REFERENCE in the OBJECT-IDENTITY macro.
Own Id: OTP-2468
1.11.3 Incompatibilities with v2.1.1
- The table
intTrapDestTable
in OTP-SNMPEA-MIB is not used anymore.
- There are three new configuration files;
target_addr.conf
,target_params.conf
andnotify.conf
. The old filetrap_dest.conf
is not used. However, if atrap_dest.conf
file exists, the agent automatically converts that file to the new files.
- The function
snmp:send_trap
no longer takes aCommunityString
as a parameter. This parameter is now optional, and refers to thesnmpNotifyName
insnmpNotifyTable
. Old code that uses the old function does not have to be changed.
- There are two new messages a
net if
process must handle. These are messages to handle Inform-Requests.
1.11.4 Future Improvements
More MIBs from the so-called SNMPv3 effort will be implemented, as these mibs become standards (although these MIBs don't require SNMPv3). This means that more tables from OTP-SNMPEA-MIB become obsolete, e.g.
intCommunityTable
,intAddressTable
andintViewTable
.SNMPv3 itself will be implemented.
1.12 SNMP Development Toolkit v2.1.1
1.12.1 Reported Fixed Bugs and Malfunctions
- The
snmp_note_store
server sometimes didn't invoked its gc, which meant that its internal data structure could grow very large.
Own Id: OTP-1946, OTP-2004
Aux Id: seq451
- If a (possibly user-defined)
net if
process crahses and restarts, the agent could crash as well.
Own Id: OTP-2017
- Failover/takeover of the SNMP agent administering the MIB did not work, since the old implementation tried to delete a Mnesia table on a node which was not up and running (which always is the case at failover). Now the SNMP related Mnesia table is defined to have the
local_content
property.
Own Id: OTP-2146
Aux Id: seq1
1.13 SNMP Development Toolkit v2.1.1
1.13.1 Reported Fixed Bugs and Malfunctions
- The
snmp_note_store
server sometimes didn't invoked its gc, which meant that its internal data structure could grow very large.
Own Id: OTP-1946, OTP-2004
Aux Id: seq451
- If a (possibly user-defined)
net if
process crahses and restarts, the agent could crash as well.
Own Id: OTP-2017
- Failover/takeover of the SNMP agent administering the MIB did not work, since the old implementation tried to delete a Mnesia table on a node which was not up and running (which always is the case at failover). Now the SNMP related Mnesia table is defined to have the
local_content
property.
Own Id: OTP-2146
Aux Id: seq1
1.14 SNMP Development Toolkit v2.1
1.14.1 Improvements and new features
- The agent does not use the application
sockets
anymore. Thus,sockets
does not have to be started before the agent (or manager).
- There are several new functions in the module
snmp
to check the syntax of and convert to/fromDateAndTime
structures.
1.14.2 Reported Fixed Bugs and Malfunctions
- If an
is_set_ok
orundo
instrumentation function crashed because it called an undefined function, the agent treated this as if the instrumentation function succeeded.
Own Id: OTP-1762
Aux Id: seq369
- The function
snmp:date_and_time/0
returns a correctDateAndTime
structure. Previously, the sign in position 9 was wrong.
Own Id: OTP-1838
- Traps larger than the maximum packet size are now handled.
Own Id: OTP-1850
Aux Id: seq416
- The
snmp_note_store
server never invoked its gc, which meant that its intenal data structure could grow very large.
Own Id: OTP-1946
Aux Id: seq451
- Some objects in traps in SNMP v1 MIBs did not get the correct type in the compiled mib. This could lead to that the trap could not be sent.
Own Id: OTP-2063
1.15 SNMP Development Toolkit v2.0
1.15.1 Improvements and new features
- The agent is bilingual, and understands SNMPv1 and SNMPv2c.
- The agent is made multi-threaded (configurable option).
- The agent can be configured to log requests to an Audit Trail Log.
- The application is restructured to be able to restart large parts of the agent in case of an error.
- The NetIf process API is simpler than in previous versions.
- New functions for handling AGENT-CAPABILITES statements in the module
snmp
.
- A few new MIBs are added to the distribution. These are SNMPv2-MIB and SNMPv2-TC. The INTERNAL-MIB has changed its name to OTP-SNMPEA-MIB.
- Added the
coldStart
andwarmStart
traps to the STANDARD-MIB. None of them are sent by default though. The STANDARD-MIB and SNMPv2-MIB defines the same objects and notifications, except for the object specifc to v1 and v2 respectively.
snmp:enum_to_int/2
andsnmp:int_to_enum/2
works for types as well as for objects.
- RowStatus no longer needs to be the last column for
snmp_generic
to work. This allows a table to be extended at a later stage.
- A table doesn't need to have all columns defined. Example:
snmp_generic
can handle a table with columns 1,2,3,5.
snmp_generic
works even though some columns in the middle of a table are not-accessible.
- Default values for strings may use "" syntax.
- The Mib Compiler understands both SNMPv1 and SNMPv2 MIBs and implements cross-version-IMPORTs.
- The Mib Compiler produces several error messages at the same time.
- The Mib Compiler is more strict.
snmp_mgr
can send and receive SNMPv2 messages.
snmp:config/0
generates a sys.config file.
- Added a record definition for the Mnesia table
snmp_variables
tosnmp_types.hrl
.
- The master agent may now be a distributed Erlang applications, and it reloads loaded mib during takeover.
1.15.2 Reported Fixed Bugs and Malfunctions
- The Mib Compiler and
snmp_generic
handle objects with STATUS deprecated and obsolete.
Own Id: OTP-1372
Aux Id: HA47707
- Agent restarts after crashes keeps information about loaded mibs. Previously, the agent restarted, but all loaded mibs were unloaded.
Own Id: OTP-1423
Aux Id: AD84262
- The generated
.hrl
files now starts with an-ifndef
which makes it possible to include the same file several times.
Own Id: OTP-1425
- The agent could under som circumstances crash when a table instrumentation function crashed.
Own Id: OTP-1738
Aux Id: seq351
1.15.3 Incompatibilities with v1.3.1
- The MIBs must be recompiled.
- The MIB compiler is more strict. Now it also checks that macros are imported correctly.
- The NetIf API is entirely re-written. It is now easier to implement a NetIf process.
- The Proxy handling in
snmp_net_if
is removed.
- The INTERNAL-MIB has changed its name to OTP-SNMPEA-MIB.
1.15.4 Known bugs and problems
The User's Guide now describes where the Agent and MIB compiler don't implement the standard.
1.16 SNMP Development Toolkit v1.3.1
1.16.1 Reported Fixed Bugs and Malfunctions
- When trying to create a row that already exists in snmp_local_db, the new row is inserted instead of the old row.
1.17 SNMP Development Toolkit v1.3
1.17.1 Improvements and new features
- The MIB compiler has a new "include_lib"-like option called
il
.
Own Id: OTP-1041
- The
RFC1213-MIB
,STANDARD-MIB
andINTERNAL-MIB
are delivered in compiled form (.bin
) as well as source form. The compiled mibs are located insnmp-1.2.3/priv/mibs
directory. Use the optionil
to the mib compiler to find these files.
Own Id: OTP-1272
- A new module
snmp_index
for building snmp indexes like the one used by Mnesia is added.
Own Id: OTP-1307
snmp:mib_to_hrl
generates OBJECT IDENTIFIERs for all internal nodes in a MIB module, not just for the leaves in the tree.
Own Id: OTP-1319
1.17.2 Reported Fixed Bugs and Malfunctions
- The agent now treats the SNMPv2 error value
wrongValue
correctly.
Own Id: OTP-1162
- It is now possible to load MIBs with short names.
Own Id: OTP-1195
- The MIB-compiler now compiles full-path files.
Own Id: OTP-1217
- The function
snmp:config/0
works for WinNT.
Own Id: OTP-1216
- The agent handles bad index returned from table instrumentation functions.
Own Id: OTP-1222
- The data type
IpAddress
works better.
Own Id: OTP-1234
- The function
snmp:date_and_time/0
now works correctly when called at midnight.
Own Id: OTP-1236
- The documentation of
snmp_generic:table_set_elements/3
is updated to reflect the fact that it is the caller's responsibility to call this function from within a transaction, if Mnesia is used.
Own Id: OTP-1265
- The MIB compiler prints the error message "Unexpected 0" when an INTEGER begins with 0.
Own Id: OTP-1274
- The agent now decodes negative integers correctly.
Own Id: OTP-1298
- Trying to delete a non-existing row implemented with
snmp_generic
now returnsnoError
instead ofinconsistentValue
.
Own Id: OTP-1331
- Default value initialisation now works for Mnesia tables when
snmp_generic:table_set_row/5
is called.
Own Id: OTP-1338
- Trying to set a row implemented with
snmp_generic
when an INDEX column wasread-write
got the agent into an infinite loop.
Own Id: OTP-1342
mib_to_hrl
doesn't generate enum definitions for importedOBJECT-TYPE
s.
Own Id: OTP-1355
- Traps are not only sent to one manager if several managers are specified as trap destinations, but to all of them.
Own Id: OTP-1366
1.18 SNMP Development Toolkit v1.2.1
1.18.1 Improvements and new features
- The file
STANDARD-MIB.hrl
is now included in the directorysnmp/include
. It may de included in source code with-include_lib("snmp/include/STANDARD-MIB.hrl").
Own Id: OTP-1063
Aux Id: HA34986, HA36413
1.18.2 Reported Fixed Bugs and Malfunctions
- Calls to the agent had too short timeout. This was most obvious in calls to
snmp:load_mibs/2
.
Own Id: OTP-1078, OTP-1096
Aux Id: HA36413
snmp:config/0
tried to validate correct IP addresses, resulting in an error when DNS was not used.
Own Id: OTP-1094
snmp:mib_to_hrl/1
generated entries for imported OBJECT IDENTIFIERs and imported DEFVALs, which could result in macro conflict when.hrl
files from more than one MIB was included.
Own Id: OTP-1126
- When a row was
createAndWait
ed, it wasn't possible to set a row toactive
in the same request as the rest of the mandatory columns were set.
Own Id: OTP-1128
snmp:int_to_enum/2
crashed when called with an Oid without any enums.
Own Id: OTP-1129
- The agent could crash if a
RowIndex
in a set-request was of bad type.
Own Id: OTP-1131
1.19 SNMP Development Toolkit v1.2
1.19.1 Improvements and new features
- A new set-phase
undo
is added. When the agent has calledis_set_ok
for an object, it will always call eitherset
orundo
at a later stage. This may be used to reserve resources in theis_set_ok
function.
- More documentation on Mnesia.
- Added conversion functions from OBJECT IDENTIFIER to symbolic name, and vice versa. These are called
snmp:oid_to_name/1
andsnmp:name_to_oid/1
.
- Added conversion functions from enumerated integers to symbolic value, and vice versa. These are called
snmp:int_to_enum/2
andsnmp:enum_to_int/2
.
- Added an extra parameter from the (configurable) Net If process for each SNMP packet. This value can be retrieved by
snmp:current_net_if_data/0
from an instrumentation function.
- Added a function
snmp:date_and_time/0
, which returns a DateAndTime value, according to RFC1903.
- A new function
snmp:str_apply/1
may be used to pass options to the Mib Compiler from the unix command line.
- There is now no need to have a RowStatus column for a read-only table that is implemented with
snmp_generic
.
- A Mnesia table that implements an SNMP table with
snmp_generic
may have more columns than the SNMP table.
- Added a function
snmp:get/2
to retrieve values from the agent from programs.
- The
snmp:config/0
tool handles host names as strings better.
- The Mib Compiler generates better warnings.
- The agent handles atoms as return values from enumerated integers better.
1.19.2 Reported Fixed Bugs and Malfunctions
- DEFVALs for strings are handled correctly by the Mib Compiler.
- The SNMPv2 error code
notWritable
is translated to the SNMPv1 codenoSuchName
.
- The instrumentation function
delete
is now called correctly when unloading a Mib.
- An
is_set_ok
function is added forsnmp_generic:variable_func
.
snmp:mib_to_hrl
doesn't generate output for imported MIB objects.
- The SNMP type
IpAddress
is now BER encoded correctly.
- The agent could hang when last object in the MIB was
not-accessible
, and a GET-NEXT request was received.
- The Mib Compiler doesn't crash when the MIB file doesn't exist.
- The Mib Compiler doesn't crash when an instrumentation function is specified for a column object in a table.
1.19.3 Incompatibilities with v1.1
- The MIBs must be recompiled.
- The contents of the output file from
snmp:mib_to_hrl
has changed. Imported objects are not included. All MIBs with imported objects must be run throughsnmp:mib_to_hrl
, and included in the Erlang code as well.
- The start functions for the agent has changed. Note that this is invisible when Erlang 4.4 is used.