SNMP Release Notes

## 1 SNMP Release Notes

### 1.1 SNMP Development Toolkit 4.8.4

Version 4.8.4 supports code replacement in runtime from/to version 4.8.3, 4.8.2, 4.8.1 and 4.8.

#### 1.1.1 Improvements and new features

-

#### 1.1.2 Reported Fixed Bugs and Malfunctions

- [agent] An Audit Trail Log entry was sometimes done using a list instead of the expected binary for the snmp packet. This caused an error when converting the log to a textfile.
  Own Id: OTP-6408
  Aux Id: Seq 10547

#### 1.1.3 Incompatibilities

-

### 1.2 SNMP Development Toolkit 4.8.3

Version 4.8.3 supports code replacement in runtime from/to version 4.8.2, 4.8.1 and 4.8.

#### 1.2.1 Improvements and new features

-

#### 1.2.2 Reported Fixed Bugs and Malfunctions

- [agent] Verification of ViewTreeFamily (SNMP-VIEW-BASED-ACM-MIB) incorrect. No values other then `null` and `[]` where accepted.
  Own Id: OTP-6337
  Aux Id: Seq 10509
- [agent] Start with type `takeover` did not work.
  Own Id: OTP-6340

#### 1.2.3 Incompatibilities

-

### 1.3 SNMP Development Toolkit 4.8.2

Version 4.8.2 supports code replacement in runtime from/to version 4.8.1 and 4.8.

#### 1.3.1 Improvements and new features

- Add timestamp to the verbosity printouts.
  Own Id: OTP-6214

#### 1.3.2 Reported Fixed Bugs and Malfunctions

- A badly formatted debug printout caused console printouts.
  Own Id: OTP-6247

#### 1.3.3 Incompatibilities

-

### 1.4 SNMP Development Toolkit 4.8.1

Version 4.8.1 supports code replacement in runtime from/to version 4.8, 4.7.4 and 4.7.3.

#### 1.4.1 Improvements and new features

-

#### 1.4.2 Reported Fixed Bugs and Malfunctions

- Removed an io:format in mini mib utility (used when converting logs).
  Own Id: OTP-6177

#### 1.4.3 Incompatibilities

-

### 1.5 SNMP Development Toolkit 4.8

Version 4.8 supports code replacement in runtime from/to version 4.7.4 and 4.7.3.

#### 1.5.1 Improvements and new features

- Added a config option, `sndbuf`, for the net_if-module(s). See application configuration or running the application for more info (look for manager_net_if_options and agent_net_if_options).
  Own Id: OTP-6137
- Improve error handling of the log_to_txt function(s). [snmpm|snmpa]:log_to_txt on a non-existing log-file causes an obscure error reason.
  Own Id: OTP-6149
- Performance improvement when converting audit trail logs.
  Own Id: OTP-6164
  Aux Id: Seq 10362

#### 1.5.2 Reported Fixed Bugs and Malfunctions

- [compiler] Allow empty definitions for SMI-II mibs, i.e. mibs are allowed to only contain the MODULE-IDENTITY construct.
  Own Id: OTP-6150
  Aux Id: Seq 10333

#### 1.5.3 Incompatibilities

-

### 1.6 SNMP Development Toolkit 4.7.4

Version 4.7.4 supports code replacement in runtime from/to version 4.7.3, 4.7.2, 4.7.1 and 4.7.

#### 1.6.1 Improvements and new features

- Add another example, ex2. This example is basically a simple manager module.
  Own Id: OTP-6042

#### 1.6.2 Reported Fixed Bugs and Malfunctions

- [agent] v1 trap sending minor problems. When sending a v1 trap, the wrong record type (#pdu{}) was used to access the type field (which does not exist in the #tranpdu{} record). This value is used when logging.
  Own Id: OTP-6077
- [manager] Type guard error.
  Kostis Sagonas.
  Own Id: OTP-6074 (dialyzer)
- Misc Dialyzer warnings.
  Own Id: OTP-6068
- [manager] Default value tags may conflict with actual host name. When storing default values for agents, the tag, default, was used for address (and port). This could conflict with an actual host name.
  Own Id: OTP-6062
- Misc doc corrections.
  Own Id: OTP-6044

#### 1.6.3 Incompatibilities

-

### 1.7 SNMP Development Toolkit 4.7.3

Version 4.7.3 supports code replacement in runtime from/to version 4.7.2, 4.7.1 and 4.7.

#### 1.7.1 Improvements and new features

-

#### 1.7.2 Reported Fixed Bugs and Malfunctions

- Misc compiler warning cleanup.
  Own Id: OTP-6031

#### 1.7.3 Incompatibilities

-

### 1.8 SNMP Development Toolkit 4.7.2

Version 4.7.2 supports code replacement in runtime from/to version 4.7.1 and 4.7.

#### 1.8.1 Improvements and new features

- [manager] Improve handling of empty messages. Today when receiving an empty (size = 0) udp message, this will result in a decode failure (a catched function clause), which in turn will be passed on to the user, via a call to the handle_error callback function, in the `Reason` argument. This has now been changed so that instead, the `Reason` argument will get a `empty message` value.
  See handle_error for more details.
  Own Id: OTP-6024

#### 1.8.2 Reported Fixed Bugs and Malfunctions

- [manager] Some error cases are reported to the 'user' with the ReqId and Reason swapped in the call to the handle_error callback function.
  Own Id: OTP-5992

#### 1.8.3 Incompatibilities

-

### 1.9 SNMP Development Toolkit 4.7.1

Version 4.7.1 supports code replacement in runtime from/to version 4.7, 4.6.1 and 4.6.

#### 1.9.1 Improvements and new features

- Added new version info print functions, print_version_info.
  Own Id: OTP-5968
- Updated the documentation for the agent and manager log_to_txt functions.
  Own Id: OTP-5969

#### 1.9.2 Reported Fixed Bugs and Malfunctions

- [manager] The supervision structure contained several errors which unnecessarily caused a complete restart of the manager.
  Own Id: OTP-5963

#### 1.9.3 Incompatibilities

-

### 1.10 SNMP Development Toolkit 4.7

Version 4.7 supports code replacement in runtime from/to version 4.6.1 and 4.6.

#### 1.10.1 Improvements and new features

- Add simple backup mechanism, see agent backup and manager backup.
  Own Id: OTP-5870
- Improve handling of faulty data base files.
  Added new agent and manager config option, `db_init_error`, see config for more info.
  Own Id: OTP-5934
  Aux Id: Seq 10202
- Added possibility to configure restart type for each of the components (default is permanent for the agent and transient for the manager). See config for more info.
  Own Id: OTP-5935
- [compiler] Improve error printouts.
  Own Id: OTP-5937

#### 1.10.2 Reported Fixed Bugs and Malfunctions

-

#### 1.10.3 Incompatibilities

-

### 1.11 SNMP Development Toolkit 4.6.1

Version 4.6.1 supports code replacement in runtime from/to version 4.6.

#### 1.11.1 Improvements and new features

-

#### 1.11.2 Reported Fixed Bugs and Malfunctions

- [agent] SNMP sha/aes decryption did not work.
  Magnus Fröberg
  Own Id: OTP-5834
- [agent] The SNMP agent internal data base (local db) uses dets, and does not properly handle error's from e.g. lookup.
  Own Id: OTP-5838

#### 1.11.3 Incompatibilities

-

### 1.12 SNMP Development Toolkit 4.6

Version 4.6 supports code replacement in runtime from/to version 4.5.

#### 1.12.1 Improvements and new features

- Improved application start flexibillity. It is now possible to start snmp aplication components (agent or manager) after the application has been started. It is even possible to start an "empty" snmp application and start the agent and/or manager afterwards. See start_agent and start_manager.
  Own Id: OTP-5797
  Aux Id: Seq 10128
- [agent] Adding utility function to convert old application config to current agent config. See the convert_config for more info.
  Own Id: OTP-5787
- Improved handling of audit trail logs. See the atl_repair config for more info.
  Own Id: OTP-5771
- [manager] Introduced the notify_started function used by a client to get a notification when the manager is started.
  Own Id: OTP-5763

#### 1.12.2 Reported Fixed Bugs and Malfunctions

- Misc documentaion corrections.
  Own Id: OTP-5829
  Aux Id: Seq 10152

#### 1.12.3 Incompatibilities

-

### 1.13 SNMP Development Toolkit 4.5

Version 4.5 supports code replacement in runtime from/to version 4.4.1 and 4.4.

#### 1.13.1 Improvements and new features

- [manager] Introduced the inform request behaviour configuration option to allow the user to specify how/when the manager shall acknowledge inform-request's.
  Own Id: OTP-5733
- [manager] In order to improve application behaviour, all callback function (see the snmpm_user behaviour) calls are now done by spawned processes (and not as previously by the SNMP manager server process).
  Own Id: OTP-5726
- [manager] In order to present the various error reason's returned by the manager, a format_reason function has been added. The error reasons this function handles are those returned by the (sync and async) get, get-next, get-bulk and set-functions (see the snmpm module) as well as the `Reason` argument of the handle_error function of the user callback module.
  Own Id: OTP-5581
  Aux Id: Seq 9870

#### 1.13.2 Reported Fixed Bugs and Malfunctions

- [manager] The (error) report according to RFC 2572, chapter 7.2 point 6) was never sent.
  Own Id: OTP-5742
- [agent] Check of notification name collision could fail due to incorrect record name (assumed to be `#trap`, but could also be `#notification`). This only cases a problem when the application is compiled with the strict_record_tests option.
  Own Id: OTP-5740
- [agent] Table get-request failure in some cases.
  Own Id: OTP-5732
  Aux Id: Seq 10087
- Explicitly sync all audit trail log's upon termination.
  Own Id: OTP-5727

#### 1.13.3 Incompatibilities

- [manager] The snmpm_network_interface behaviour has been updated (see inform_response and definition of the manager net if).
  Own Id: OTP-5733

### 1.14 SNMP Development Toolkit 4.4.1

Version 4.4.1 supports code replacement in runtime from/to version 4.4.

#### 1.14.1 Improvements and new features

- [manager] Add monitoring of the SNMP manager. The SNMP application consists of two different runtime parts, the agent and the manager. They are independent of each other. The agent is "permanent" and the manager "transient". In order to handle manager crashes a simple monitor (and demonitor) function has been added.
  Own Id: OTP-5720

#### 1.14.2 Reported Fixed Bugs and Malfunctions

- [manager] If sending a set-request containing an 'OCTET STRING' with an invalid integer (valid integer are 0-255), the encoding will fail and cause the net_if process to crash.
  Own Id: OTP-5719

#### 1.14.3 Incompatibilities

-

### 1.15 SNMP Development Toolkit 4.4

Version 4.4 supports code replacement in runtime from/to version 4.3.

#### 1.15.1 Improvements and new features

- Updated and extended the agent info retrieval function. Also added an info retrieval function for the manager.
  Own Id: OTP-5666
- [manager] Added get-bulk functionality, see (sync) get-bulk and (async) get-bulk for more info.
  Own Id: OTP-5669

#### 1.15.2 Reported Fixed Bugs and Malfunctions

- [manager] Mini-MIB not properly initiated which could cause a server crash if the name_to_oid or oid_to_name functions where called (if no mib's where loaded).
  Own Id: OTP-5675
- [manager] The out packet counter was not incremented for sent v1/v2 messages.
  Own Id: OTP-5676
- [manager] The request GC process was started with the wrong default value (idle) which could (unlikely but still) cause problems after a code-change.
  Own Id: OTP-5678
- Bad handling of error cases (corrupt log file) when converting log files (i.e. when calling the function log_to_txt).
  Own Id: OTP-5703

#### 1.15.3 Incompatibilities

- [agent] The format of the info returned by the agent info retrieval function has been changed. The info can be converted to the old format by calling the old_info_format).
  function. Own Id: OTP-5666

### 1.16 Release notes history

For information about older versions see release notes history.

Copyright © 1991-2007 Ericsson AB