File: notes.html

package info (click to toggle)
erlang-doc-html 1%3A11.b.2-1
links: PTS
area: main
in suites: etch, etch-m68k
size: 23,284 kB
ctags: 10,724
sloc: erlang: 505; ansic: 323; makefile: 62; perl: 61; sh: 45
file content (864 lines) | stat: -rw-r--r-- 17,666 bytes
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- This document was generated using DocBuilder 3.3.3 -->
<HTML>
<HEAD>
  <TITLE>SNMP Release Notes
</TITLE>
  <SCRIPT type="text/javascript" src="../../../../doc/erlresolvelinks.js">
</SCRIPT>
</HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#FF00FF"
      ALINK="#FF0000">
<CENTER>
<A HREF="http://www.erlang.se"><IMG BORDER=0 ALT="[Ericsson AB]" SRC="min_head.gif"></A>
</CENTER>
<A NAME="1"><!-- Empty --></A>
<H2>1 SNMP Release Notes
</H2>
<A NAME="1.1"><!-- Empty --></A>
<H3>1.1 SNMP Development Toolkit 4.8.2</H3>

<P>Version 4.8.2 supports code replacement in runtime from/to
version 4.8.1 and 4.8.<A NAME="1.1.1"><!-- Empty --></A>
<H4>1.1.1 Improvements and new features</H4>

<P>
<UL>

<LI>
         Add timestamp to the verbosity printouts. <BR>

         Own Id: OTP-6214<BR>

        
</LI>


</UL>
<A NAME="1.1.2"><!-- Empty --></A>
<H4>1.1.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         A badly formatted debug printout caused console printouts. <BR>

         Own Id: OTP-6247<BR>

        
</LI>


</UL>
<A NAME="1.1.3"><!-- Empty --></A>
<H4>1.1.3 Incompatibilities</H4>

<P>-<A NAME="1.2"><!-- Empty --></A>
<H3>1.2 SNMP Development Toolkit 4.8.1</H3>

<P>Version 4.8.1 supports code replacement in runtime from/to
version 4.8, 4.7.4 and 4.7.3.<A NAME="1.2.1"><!-- Empty --></A>
<H4>1.2.1 Improvements and new features</H4>

<P>-<A NAME="1.2.2"><!-- Empty --></A>
<H4>1.2.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         Removed an io:format in mini mib utility (used when
converting logs). <BR>

         Own Id: OTP-6177<BR>

        
</LI>


</UL>
<A NAME="1.2.3"><!-- Empty --></A>
<H4>1.2.3 Incompatibilities</H4>

<P>-<A NAME="1.3"><!-- Empty --></A>
<H3>1.3 SNMP Development Toolkit 4.8</H3>

<P>Version 4.8 supports code replacement in runtime from/to
version 4.7.4 and 4.7.3.<A NAME="1.3.1"><!-- Empty --></A>
<H4>1.3.1 Improvements and new features</H4>

<P>
<UL>

<LI>
         Added a config option, <CODE>sndbuf</CODE>, for the net_if-module(s). 
See 
<A HREF="snmp_app.html">application configuration</A> or
<A HREF="snmp_config.html">running the application</A> 
for more info (look for manager_net_if_options and 
agent_net_if_options). <BR>

         Own Id: OTP-6137<BR>

        
</LI>


<LI>
         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.<BR>

         Own Id: OTP-6149<BR>

        
</LI>


<LI>
         Performance improvement when converting audit trail logs.<BR>

         Own Id: OTP-6164<BR>

         Aux Id: Seq 10362<BR>

        
</LI>


</UL>
<A NAME="1.3.2"><!-- Empty --></A>
<H4>1.3.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         [compiler] Allow empty definitions for SMI-II mibs,
i.e. mibs are allowed to only contain the
MODULE-IDENTITY construct. <BR>

         Own Id: OTP-6150<BR>

         Aux Id: Seq 10333<BR>

        
</LI>


</UL>
<A NAME="1.3.3"><!-- Empty --></A>
<H4>1.3.3 Incompatibilities</H4>

<P>-<A NAME="1.4"><!-- Empty --></A>
<H3>1.4 SNMP Development Toolkit 4.7.4</H3>

<P>Version 4.7.4 supports code replacement in runtime from/to
version 4.7.3, 4.7.2, 4.7.1 and 4.7.<A NAME="1.4.1"><!-- Empty --></A>
<H4>1.4.1 Improvements and new features</H4>

<P>
<UL>

<LI>
         Add another example, 
<A HREF="snmp_impl_example_manager.html">ex2</A>. 
This example is basically a simple manager module. <BR>

         Own Id: OTP-6042<BR>

        
</LI>


</UL>
<A NAME="1.4.2"><!-- Empty --></A>
<H4>1.4.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         [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.<BR>
 
         Own Id: OTP-6077<BR>

        
</LI>


<LI>
         [manager] Type guard error.<BR>
 
Kostis Sagonas.<BR>
 
         Own Id: OTP-6074 (dialyzer)<BR>

        
</LI>


<LI>
         Misc Dialyzer warnings.<BR>
 
         Own Id: OTP-6068<BR>

        
</LI>


<LI>
         [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.<BR>
 
         Own Id: OTP-6062<BR>

        
</LI>


<LI>
         Misc doc corrections.<BR>
 
         Own Id: OTP-6044<BR>

        
</LI>


</UL>
<A NAME="1.4.3"><!-- Empty --></A>
<H4>1.4.3 Incompatibilities</H4>

<P>-<A NAME="1.5"><!-- Empty --></A>
<H3>1.5 SNMP Development Toolkit 4.7.3</H3>

<P>Version 4.7.3 supports code replacement in runtime from/to
version 4.7.2, 4.7.1 and 4.7.<A NAME="1.5.1"><!-- Empty --></A>
<H4>1.5.1 Improvements and new features</H4>

<P>-<A NAME="1.5.2"><!-- Empty --></A>
<H4>1.5.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         Misc compiler warning cleanup.<BR>
 
         Own Id: OTP-6031<BR>

        
</LI>


</UL>
<A NAME="1.5.3"><!-- Empty --></A>
<H4>1.5.3 Incompatibilities</H4>

<P>-<A NAME="1.6"><!-- Empty --></A>
<H3>1.6 SNMP Development Toolkit 4.7.2</H3>

<P>Version 4.7.2 supports code replacement in runtime from/to
version 4.7.1 and 4.7.<A NAME="1.6.1"><!-- Empty --></A>
<H4>1.6.1 Improvements and new features</H4>

<P>
<UL>

<LI>
         [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 
<A HREF="snmpm_user.html#handle_error">handle_error</A> 
callback function, in the <CODE>Reason</CODE> argument. 
This has now been changed so that instead, the 
<CODE>Reason</CODE> argument will get a <CODE>empty message</CODE> 
value.<BR>

See 
<A HREF="snmpm_user.html#handle_error">handle_error</A> 
for more details. <BR>

         Own Id: OTP-6024<BR>

        
</LI>


</UL>
<A NAME="1.6.2"><!-- Empty --></A>
<H4>1.6.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         [manager] Some error cases are reported to the 'user'
with the ReqId and Reason swapped in the call to the
<A HREF="snmpm_user.html#handle_error">handle_error</A> 
callback function.<BR>
 
         Own Id: OTP-5992<BR>

        
</LI>


</UL>
<A NAME="1.6.3"><!-- Empty --></A>
<H4>1.6.3 Incompatibilities</H4>

<P>-<A NAME="1.7"><!-- Empty --></A>
<H3>1.7 SNMP Development Toolkit 4.7.1</H3>

<P>Version 4.7.1 supports code replacement in runtime from/to
version 4.7, 4.6.1 and 4.6.<A NAME="1.7.1"><!-- Empty --></A>
<H4>1.7.1 Improvements and new features</H4>

<P>
<UL>

<LI>
         Added new version info print functions, 
<A HREF="snmp.html#print_version_info">print_version_info</A>.<BR>

         Own Id: OTP-5968<BR>

        
</LI>


<LI>
         Updated the documentation for the 
<A HREF="snmpa.html#log_to_txt">agent</A> and 
<A HREF="snmpm.html#log_to_txt">manager</A>
log_to_txt functions.<BR>

         Own Id: OTP-5969<BR>

        
</LI>


</UL>
<A NAME="1.7.2"><!-- Empty --></A>
<H4>1.7.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

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

        
</LI>


</UL>
<A NAME="1.7.3"><!-- Empty --></A>
<H4>1.7.3 Incompatibilities</H4>

<P>-<A NAME="1.8"><!-- Empty --></A>
<H3>1.8 SNMP Development Toolkit 4.7</H3>

<P>Version 4.7 supports code replacement in runtime from/to
version 4.6.1 and 4.6.<A NAME="1.8.1"><!-- Empty --></A>
<H4>1.8.1 Improvements and new features</H4>

<P>
<UL>

<LI>
         Add simple backup mechanism, 
see <A HREF="snmpa.html#backup">agent backup</A> 
and <A HREF="snmpm.html#backup">manager backup</A>.<BR>

         Own Id: OTP-5870<BR>

        
</LI>


<LI>
         Improve handling of faulty data base files.<BR>

         Added new agent and manager config option, 
<CODE>db_init_error</CODE>, see 
<A HREF="snmp_config.html">config</A> for more 
info.<BR>

         Own Id: OTP-5934<BR>

         Aux Id: Seq 10202<BR>

        
</LI>


<LI>
         Added possibility to configure restart type for each of 
the components (default is permanent for the agent and 
transient for the manager).
See <A HREF="snmp_config.html">config</A> for more 
info.<BR>

         Own Id: OTP-5935<BR>

        
</LI>


<LI>
         [compiler] Improve error printouts.<BR>

         Own Id: OTP-5937<BR>

        
</LI>


</UL>
<A NAME="1.8.2"><!-- Empty --></A>
<H4>1.8.2 Reported Fixed Bugs and Malfunctions</H4>

<P>-<A NAME="1.8.3"><!-- Empty --></A>
<H4>1.8.3 Incompatibilities</H4>

<P>-<A NAME="1.9"><!-- Empty --></A>
<H3>1.9 SNMP Development Toolkit 4.6.1</H3>

<P>Version 4.6.1 supports code replacement in runtime from/to
version 4.6.<A NAME="1.9.1"><!-- Empty --></A>
<H4>1.9.1 Improvements and new features</H4>

<P>-<A NAME="1.9.2"><!-- Empty --></A>
<H4>1.9.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         [agent] SNMP sha/aes decryption did not work.
<BR>
Magnus Frberg<BR>
 
         Own Id: OTP-5834<BR>

        
</LI>


<LI>
         [agent] The SNMP agent internal data base (local db)
uses dets, and does not properly handle error's from
e.g. lookup.<BR>
 
         Own Id: OTP-5838<BR>

        
</LI>


</UL>
<A NAME="1.9.3"><!-- Empty --></A>
<H4>1.9.3 Incompatibilities</H4>

<P>-<A NAME="1.10"><!-- Empty --></A>
<H3>1.10 SNMP Development Toolkit 4.6</H3>

<P>Version 4.6 supports code replacement in runtime from/to
version 4.5.<A NAME="1.10.1"><!-- Empty --></A>
<H4>1.10.1 Improvements and new features</H4>

<P>
<UL>

<LI>
         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 &#34;empty&#34; snmp 
                application and start the agent and/or manager 
                afterwards. See 
<A HREF="snmp.html#start_agent">start_agent</A> and 
<A HREF="snmp.html#start_manager">start_manager</A>.
                <BR>
 
         Own Id: OTP-5797<BR>

         Aux Id: Seq 10128<BR>

        
</LI>


<LI>
         [agent] Adding utility function to convert old 
                application config to current agent config.
See the <A HREF="snmpa.html#convert_config">convert_config</A> 
for more info.<BR>
 
         Own Id: OTP-5787<BR>

        
</LI>


<LI>
         Improved handling of audit trail logs.
See the <A HREF="snmp_app.html">atl_repair</A> 
config for more info.<BR>
 
         Own Id: OTP-5771<BR>

        
</LI>


<LI>
         [manager] Introduced the 
<A HREF="snmpm.html#notify_started">notify_started</A> 
function used by a <STRONG>client</STRONG> to get a notification 
when the manager is started.<BR>
 
         Own Id: OTP-5763<BR>

        
</LI>


</UL>
<A NAME="1.10.2"><!-- Empty --></A>
<H4>1.10.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         Misc documentaion corrections.<BR>
 
         Own Id: OTP-5829<BR>

         Aux Id: Seq 10152<BR>

        
</LI>


</UL>
<A NAME="1.10.3"><!-- Empty --></A>
<H4>1.10.3 Incompatibilities</H4>

<P>-<A NAME="1.11"><!-- Empty --></A>
<H3>1.11 SNMP Development Toolkit 4.5</H3>

<P>Version 4.5 supports code replacement in runtime from/to
version 4.4.1 and 4.4.<A NAME="1.11.1"><!-- Empty --></A>
<H4>1.11.1 Improvements and new features</H4>

<P>
<UL>

<LI>
         [manager] Introduced the 
<A HREF="snmp_app.html">inform request behaviour</A> 
configuration option to allow the user to specify
how/when the manager shall acknowledge inform-request's.<BR>
 
         Own Id: OTP-5733<BR>

        
</LI>


<LI>
         [manager] In order to improve application behaviour,
all callback function (see the 
<A HREF="snmpm_user.html">snmpm_user behaviour</A>) 
calls
are now done by spawned processes (and not as previously
by the SNMP manager server process).<BR>
 
         Own Id: OTP-5726<BR>

        
</LI>


<LI>
         [manager] In order to present the various error 
                reason's returned by the manager, a 
<A HREF="snmpm.html#format_reason">format_reason</A> 
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 <A HREF="snmpm.html">snmpm</A> module) 
as well as the 
                <CODE>Reason</CODE> argument of the 
<A HREF="snmpm_user.html#handle_error">handle_error</A> 
function of the 
<A HREF="snmpm_user.html">user callback module</A>.<BR>
 
         Own Id: OTP-5581<BR>

         Aux Id: Seq 9870<BR>

        
</LI>


</UL>
<A NAME="1.11.2"><!-- Empty --></A>
<H4>1.11.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         [manager] The (error) report according to RFC 2572, chapter
7.2 point 6) was never sent.<BR>
 
         Own Id: OTP-5742
        <BR>

</LI>


<LI>
         [agent] Check of notification name collision
                could fail due to incorrect record name (assumed to
                be <CODE>#trap</CODE>, but could also be <CODE>#notification</CODE>). 
                This only cases a problem when the application is 
                compiled with the strict_record_tests option.<BR>
 
         Own Id: OTP-5740<BR>

        
</LI>


<LI>
         [agent] Table get-request failure in some cases.<BR>
 
         Own Id: OTP-5732<BR>

         Aux Id: Seq 10087<BR>

        
</LI>


<LI>
         Explicitly sync all audit trail log's upon termination.<BR>
 
         Own Id: OTP-5727<BR>

        
</LI>


</UL>
<A NAME="1.11.3"><!-- Empty --></A>
<H4>1.11.3 Incompatibilities</H4>

<P>
<UL>

<LI>
         [manager] The 
<A HREF="snmpm_network_interface.html">snmpm_network_interface</A> 
behaviour has been updated (see 
<A HREF="snmpm_network_interface.html#inform_response">inform_response</A> and 
<A HREF="snmp_manager_netif.html">definition of the manager net if</A>).<BR>

         Own Id: OTP-5733<BR>

        
</LI>


</UL>
<A NAME="1.12"><!-- Empty --></A>
<H3>1.12 SNMP Development Toolkit 4.4.1</H3>

<P>Version 4.4.1 supports code replacement in runtime from/to
version 4.4.<A NAME="1.12.1"><!-- Empty --></A>
<H4>1.12.1 Improvements and new features</H4>

<P>
<UL>

<LI>
         [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 &#34;permanent&#34;
and the manager &#34;transient&#34;. In order to handle
manager crashes a simple 
<A HREF="snmpm.html#monitor">monitor</A> 
(and <A HREF="snmpm.html#demonitor">demonitor</A>) 
function has been added.<BR>
 
         Own Id: OTP-5720<BR>

        
</LI>


</UL>
<A NAME="1.12.2"><!-- Empty --></A>
<H4>1.12.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         [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.<BR>
 
         Own Id: OTP-5719<BR>

        
</LI>


</UL>
<A NAME="1.12.3"><!-- Empty --></A>
<H4>1.12.3 Incompatibilities</H4>

<P>-<A NAME="1.13"><!-- Empty --></A>
<H3>1.13 SNMP Development Toolkit 4.4</H3>

<P>Version 4.4 supports code replacement in runtime from/to
version 4.3.<A NAME="1.13.1"><!-- Empty --></A>
<H4>1.13.1 Improvements and new features</H4>

<P>
<UL>

<LI>
         Updated and extended the 
<A HREF="snmpa.html#info">agent</A>
info retrieval function. Also added an info retrieval 
function for the 
<A HREF="snmpm.html#info">manager</A>.<BR>
 
         Own Id: OTP-5666<BR>

        
</LI>


<LI>
         [manager] Added get-bulk functionality, see 
<A HREF="snmpm.html#gb">(sync) get-bulk</A>
and 
<A HREF="snmpm.html#agb">(async) get-bulk</A>
for more info.<BR>
 
         Own Id: OTP-5669<BR>

        
</LI>


</UL>
<A NAME="1.13.2"><!-- Empty --></A>
<H4>1.13.2 Reported Fixed Bugs and Malfunctions</H4>

<P>
<UL>

<LI>
         [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).<BR>
 
         Own Id: OTP-5675<BR>

        
</LI>


<LI>
         [manager] The out packet counter was not incremented for 
sent v1/v2 messages.<BR>
 
         Own Id: OTP-5676<BR>

        
</LI>


<LI>
         [manager] The request GC process was started with the 
wrong default value (idle) which could (unlikely but 
still) cause problems after a code-change.<BR>
 
         Own Id: OTP-5678<BR>

        
</LI>


<LI>
         Bad handling of error cases (corrupt log file) when 
converting log files (i.e. when calling the function 
log_to_txt).<BR>
 
         Own Id: OTP-5703<BR>

        
</LI>


</UL>
<A NAME="1.13.3"><!-- Empty --></A>
<H4>1.13.3 Incompatibilities</H4>

<P>
<UL>

<LI>
         [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 
         <A HREF="snmpa.html#old_info_format">old_info_format</A>).<BR>

function. 
         Own Id: OTP-5666<BR>

        
</LI>


</UL>
<A NAME="1.14"><!-- Empty --></A>
<H3>1.14 Release notes history</H3>

<P>For information about older versions see
<A TARGET="_top" HREF="part_notes_history_frame.html">  release notes history</A>.<CENTER>
<HR>
<SMALL>
Copyright &copy; 1991-2006
<A HREF="http://www.erlang.se">Ericsson AB</A><BR>
</SMALL>
</CENTER>
</BODY>
</HTML>