aboutsummaryrefslogtreecommitdiffstats
path: root/lib/os_mon/doc/src/notes.xml
diff options
context:
space:
mode:
authorErlang/OTP <[email protected]>2009-11-20 14:54:40 +0000
committerErlang/OTP <[email protected]>2009-11-20 14:54:40 +0000
commit84adefa331c4159d432d22840663c38f155cd4c1 (patch)
treebff9a9c66adda4df2106dfd0e5c053ab182a12bd /lib/os_mon/doc/src/notes.xml
downloadotp-84adefa331c4159d432d22840663c38f155cd4c1.tar.gz
otp-84adefa331c4159d432d22840663c38f155cd4c1.tar.bz2
otp-84adefa331c4159d432d22840663c38f155cd4c1.zip
The R13B03 release.OTP_R13B03
Diffstat (limited to 'lib/os_mon/doc/src/notes.xml')
-rw-r--r--lib/os_mon/doc/src/notes.xml537
1 files changed, 537 insertions, 0 deletions
diff --git a/lib/os_mon/doc/src/notes.xml b/lib/os_mon/doc/src/notes.xml
new file mode 100644
index 0000000000..1a8551f57d
--- /dev/null
+++ b/lib/os_mon/doc/src/notes.xml
@@ -0,0 +1,537 @@
+<?xml version="1.0" encoding="latin1" ?>
+<!DOCTYPE chapter SYSTEM "chapter.dtd">
+
+<chapter>
+ <header>
+ <copyright>
+ <year>2004</year><year>2009</year>
+ <holder>Ericsson AB. All Rights Reserved.</holder>
+ </copyright>
+ <legalnotice>
+ The contents of this file are subject to the Erlang Public License,
+ Version 1.1, (the "License"); you may not use this file except in
+ compliance with the License. You should have received a copy of the
+ Erlang Public License along with this software. If not, it can be
+ retrieved online at http://www.erlang.org/.
+
+ Software distributed under the License is distributed on an "AS IS"
+ basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
+ the License for the specific language governing rights and limitations
+ under the License.
+
+ </legalnotice>
+
+ <title>OS_Mon Release Notes</title>
+ <prepared>otp_appnotes</prepared>
+ <docno>nil</docno>
+ <date>nil</date>
+ <rev>nil</rev>
+ <file>notes.xml</file>
+ </header>
+ <p>This document describes the changes made to the OS_Mon application.</p>
+
+<section><title>Os_Mon 2.2.4</title>
+
+ <section><title>Fixed Bugs and Malfunctions</title>
+ <list>
+ <item>
+ <p>
+ Memsup did not read memory correctly on MaxOSX
+ Snowleopard. This has now been corrected. (Thanks to Joel
+ Reymont)</p>
+ <p>
+ Own Id: OTP-8211</p>
+ </item>
+ <item>
+ <p>
+ Removed unused code in <c>cpu_sup.erl</c>.</p>
+ <p>
+ Own Id: OTP-8226</p>
+ </item>
+ </list>
+ </section>
+
+
+ <section><title>Improvements and New Features</title>
+ <list>
+ <item>
+ <p>
+ The documentation is now built with open source tools
+ (xsltproc and fop) that exists on most platforms. One
+ visible change is that the frames are removed.</p>
+ <p>
+ Own Id: OTP-8201</p>
+ </item>
+ </list>
+ </section>
+
+</section>
+
+<section><title>Os_Mon 2.2.3</title>
+
+ <section><title>Fixed Bugs and Malfunctions</title>
+ <list>
+ <item>
+ <p>
+ A missing define in <c>memsup.c</c> caused a build error
+ on IRIX machines. This has now been fixed.</p>
+ <p>
+ Own Id: OTP-8094</p>
+ </item>
+ </list>
+ </section>
+
+</section>
+
+<section><title>Os_Mon 2.2.2</title>
+
+ <section><title>Fixed Bugs and Malfunctions</title>
+ <list>
+ <item>
+ <p>
+ disksup:get_disk_data/0 returned disk volume in bytes
+ instead of kbytes as stated in the documentation. The
+ problem occurred on Windows only and is now corrected.</p>
+ <p>
+ *** POTENTIAL INCOMPATIBILITY ***</p>
+ <p>
+ Own Id: OTP-7741</p>
+ </item>
+ </list>
+ </section>
+
+</section>
+
+<section><title>Os_Mon 2.2.1</title>
+
+ <section><title>Fixed Bugs and Malfunctions</title>
+ <list>
+ <item>
+ <p>An error in <c>memsup</c> could cause <c>os_mon</c> to
+ report erroneous memory values on windows for ranges of
+ memory between 2GB and 4GB. This have now been fixed.</p>
+ <p>
+ Own Id: OTP-7944</p>
+ </item>
+ </list>
+ </section>
+
+
+ <section><title>Improvements and New Features</title>
+ <list>
+ <item>
+ <p>Added support for dragonfly OS.</p>
+ <p>
+ Own Id: OTP-7938</p>
+ </item>
+ </list>
+ </section>
+
+</section>
+
+<section><title>Os_Mon 2.2</title>
+
+ <section><title>Improvements and New Features</title>
+ <list>
+ <item>
+ <p>The copyright notices have been updated.</p>
+ <p>
+ Own Id: OTP-7851</p>
+ </item>
+ </list>
+ </section>
+
+</section>
+
+<section><title>Os_Mon 2.1.8</title>
+
+ <section><title>Fixed Bugs and Malfunctions</title>
+ <list>
+ <item>
+ <p>A problem with <c>OTP-OS-MON-MIB.mib</c> for 64-bit
+ environments has now been fixed. The mib has been
+ extended with 64-bit memory retrieval
+ counterparts.</p><p>In addition, a new function
+ <c>get_os_wordsize/0</c> has been added in the
+ <c>memsup</c> module</p>
+ <p>
+ Own Id: OTP-7441</p>
+ </item>
+ <item>
+ <p>An error in <c>memsup.c</c> caused the compilation to
+ crash on bsd environments. This has now been fixed.</p>
+ <p>
+ Own Id: OTP-7558</p>
+ </item>
+ </list>
+ </section>
+
+</section>
+
+<section><title>Os_Mon 2.1.7</title>
+
+ <section><title>Fixed Bugs and Malfunctions</title>
+ <list>
+ <item>
+ <p>Fixed a build error that occurred on NetBSD (Thanks to
+ Per Hedeland and Raphael Langerhorst)</p>
+ <p>
+ Own Id: OTP-7505</p>
+ </item>
+ </list>
+ </section>
+
+
+ <section><title>Improvements and New Features</title>
+ <list>
+ <item>
+ <p> Memory information in
+ <c>memsup:get_system_memory_data/0</c> now has additional
+ entries in its property list for linux.</p>
+ <p>
+ Own Id: OTP-7409 Aux Id: seq10984 </p>
+ </item>
+ </list>
+ </section>
+
+</section>
+
+<section><title>Os_Mon 2.1.6</title>
+
+ <section><title>Fixed Bugs and Malfunctions</title>
+ <list>
+ <item>
+ <p>
+ System information retrieval on darwin platforms with
+ environments locales not conforming to the C locale
+ caused an error in <c>cpu_sup</c> resulting in process
+ termination.</p>
+ <p>
+ Own Id: OTP-7320</p>
+ </item>
+ </list>
+ </section>
+
+</section>
+
+<section><title>Os_Mon 2.1.5</title>
+ <section><title>Improvements and New Features</title>
+ <list>
+ <item>
+ <p>
+ CPU utilization, on linux, is now measured via a port
+ program instead of os:cmd in erlang. This should enhance
+ performance.</p>
+ <p>
+ Own Id: OTP-7108 Aux Id: OTP-6935 </p>
+ </item>
+ </list>
+ </section>
+</section>
+
+ <section><title>Os_Mon 2.1.3</title>
+ <section><title>Improvements and New Features</title>
+ <list type="bulleted">
+ <item>
+ <p>
+ Extended memsup memory probing on linux to use a port
+ program to probe memory usage. This is faster then the
+ previous implementation.</p>
+ <p>
+ Own Id: OTP-6860 Aux Id: seq10616 </p>
+ </item>
+ </list>
+ </section>
+ </section>
+
+
+ <section>
+ <title>Os_Mon 2.1.2.1</title>
+
+ <section>
+ <title>Improvements and New Features</title>
+ <list type="bulleted">
+ <item>
+ <p>Minor Makefile changes.</p>
+ <p>Own Id: OTP-6689</p>
+ </item>
+ </list>
+ </section>
+ </section>
+
+ <section>
+ <title>OS_Mon 2.1.2</title>
+
+ <section>
+ <title>Fixed Bugs and Malfunctions</title>
+ <list type="bulleted">
+ <item>
+ <p>When the <c>memsup_system_only</c> flag was set to
+ <c>true</c>, a <c>badmatch</c> exception occurred in the
+ function <c>os_mon_mib:get_load/1</c>.</p>
+ <p>Own Id: OTP-6351 Aux Id: seq10517</p>
+ </item>
+ </list>
+ </section>
+ </section>
+
+ <section>
+ <title>OS_Mon 2.1.1</title>
+
+ <section>
+ <title>Fixed Bugs and Malfunctions</title>
+ <list type="bulleted">
+ <item>
+ <p>Did not build on Mac OS X.</p>
+ <p>Added support for IRIX. (Thanks to Michel Urvoy and
+ Daniel Solaz.)</p>
+ <p>Own Id: OTP-6136</p>
+ </item>
+ </list>
+ </section>
+
+ <section>
+ <title>Improvements and New Features</title>
+ <list type="bulleted">
+ <item>
+ <p><c>disksup</c>: Now using <c>round(T*100)</c> instead of
+ <c>trunc(T*100)</c> when setting the threshold value
+ given a float <c>T</c>.</p>
+ <p>Own Id: OTP-6153</p>
+ </item>
+ </list>
+ </section>
+ </section>
+
+ <section>
+ <title>Os_Mon 2.1</title>
+
+ <section>
+ <title>Fixed Bugs and Malfunctions</title>
+ <list type="bulleted">
+ <item>
+ <p>In 2.0, a call to <c>alarm_handler:get_alarms/0</c> was
+ introduced in <c>memsup</c> and <c>disksup</c>. This will
+ lead to problems if the default <c>alarm_handler</c>
+ event handler is not used, however, and the call has now
+ been removed. (Thanks to Serge Aleynikov for pointing
+ this out.)</p>
+ <p>Own Id: OTP-6029</p>
+ </item>
+ <item>
+ <p>A bug that in rare cases caused <c>cpu_sup</c> to crash
+ has been corrected.</p>
+ <p>Own Id: OTP-6102 Aux Id: seq10312 </p>
+ </item>
+ </list>
+ </section>
+ </section>
+
+ <section>
+ <title>OS_Mon 2.0</title>
+ <p>A note on backwards compatibility: The behaviour of OS_Mon 2.0 is
+ backwards compatible under normal operation, but has changed
+ somewhat in error situations: The services do not terminate
+ and the API functions do not raise exceptions in all cases where
+ they did before. Also, in the case where a service does terminate,
+ the exit reason may be different. See below for details.</p>
+
+ <section>
+ <title>Fixed Bugs and Malfunctions</title>
+ <list type="bulleted">
+ <item>
+ <p>A call to a OS_Mon service (cpu_sup, disksup, ...) when
+ OS_Mon is not running, or when the service is not
+ available for the OS, or when the service is not started,
+ will no longer result in an exception. Instead a warning
+ is issued via error_logger and a dummy value is returned,
+ which one is specified in the man pages for the
+ respective service.</p>
+ <p>The reason is that it should not be necessary for a
+ service to be started on each and every node of a
+ distributed Erlang system for the OS-MON-MIB and other
+ OS_Mon users to work properly.</p>
+ <p>Own Id: OTP-4332 Aux Id: seq7358 </p>
+ </item>
+ <item>
+ <p>References to the obsolete EVA application in
+ OTP-OS-MON-MIB has been removed.</p>
+ <p>Own Id: OTP-5699</p>
+ </item>
+ <item>
+ <p>Setting the option <c>memsup_system_only</c> to
+ <c>true</c> did not work, but would crash the
+ <c>memsup</c> process.</p>
+ <p>Own Id: OTP-5890 Aux Id: seq10185 </p>
+ </item>
+ <item>
+ <p><c>cpu_sup:nprocs/0</c> returned 0 on FreeBsd.</p>
+ <p>Own Id: OTP-5901</p>
+ </item>
+ <item>
+ <p>If the OS_Mon service <c>disksup</c> or <c>memsup</c> was
+ restarted, the same alarm could be set twice. Also, set
+ alarms were not cleared when the application was stopped.</p>
+ <p>Own Id: OTP-5910</p>
+ </item>
+ </list>
+ </section>
+
+ <section>
+ <title>Improvements and New Features</title>
+ <list type="bulleted">
+ <item>
+ <p>Thresholds and time intervals in <c>disksup</c> and
+ <c>memsup</c> are now configurable in run-time.</p>
+ <p>Own Id: OTP-4246 Aux Id: Seq7230 </p>
+ </item>
+ <item>
+ <p><c>memsup</c> can now handle systems with more than 4GB
+ of RAM.</p>
+ <p>Own Id: OTP-5800 Aux Id: seq10130 </p>
+ </item>
+ <item>
+ <p>The entire OS_Mon application (code and documentation)
+ has been reviewed and consequently updated with the goal
+ to make the application more robust, homogeneous and
+ easier to configure.</p>
+ <p>The behaviour under normal operation is backwards
+ compatible. However, recoverable errors now no longer
+ terminate the affected service (and thus possible the
+ entire application), instead <c>error_logger</c> is used
+ to warn the user if/when such errors occurs. Also, in the
+ case of unrecoverable errors, the services have been made
+ more homogeneous with respect to behavior and exit
+ reasons. See below for more information and refer to the
+ man pages for details.</p>
+ <p>Port handling has been unified, meaning that if a port
+ program sends garbage or unexpectedly dies, this is now
+ handled the same way by all OS_Mon services, namely
+ immediate process termination with the exit reason
+ <c>{port_error,Garbage}</c> or <c>{port_died,Reason}</c>,
+ respectively.</p>
+ <p>Application configuration parameter handling has been
+ unified. Bad parameter values are no longer silently
+ ignored (<c>disksup</c>) or cause application termination
+ (<c>memsup</c>, <c>os_sup</c>). Instead a warning is
+ issued and the default value for the parameter is used.
+ Also, some cases where a bad parameter value accidentally
+ could be accepted have been corrected.</p>
+ <p>Message handling has been unified. Unknown
+ (<c>gen_server-</c>) calls cause process termination,
+ whereas unknown casts and messages are now ignored by all
+ OS_Mon services.</p>
+ <p>Own Id: OTP-5897</p>
+ </item>
+ <item>
+ <p>The following changes have been made to the <c>os_sup</c>
+ service:</p>
+ <p>It is now available on Windows, using <c>nteventlog</c>
+ as backend.</p>
+ <p>On Solaris, enabling the service (that is, installing a
+ new configuration file for <c>syslogd</c> etc.) can now
+ be done outside the <c>os_sup</c> process. The reason for
+ this is that the Erlang emulator should normally not be
+ run with <c>root</c> privileges, as is otherwise
+ required. The new application configuration parameter
+ <c>os_sup_config</c> must be set to <c>false</c>.</p>
+ <p>Also, <c>os_sup</c> can now be configured using a new
+ configuration parameter <c>os_sup_mfa</c> to call an
+ arbitrary Erlang function when a message is received from
+ the OS.</p>
+ <p>Own Id: OTP-5925</p>
+ </item>
+ <item>
+ <p>The <c>memsup</c> service has been rewritten, replacing
+ the supervised <c>memsup_helper</c> with a linked help
+ process. This gives the <c>memsup</c> process more
+ control and prevents a situation where it gets out of
+ synch with the received memory data and thus possibly
+ returns erroneous results.</p>
+ <p>Own Id: OTP-5927</p>
+ </item>
+ </list>
+ </section>
+ </section>
+
+ <section>
+ <title>OS_Mon 1.8.1</title>
+
+ <section>
+ <title>Fixed Bugs and Malfunctions</title>
+ <list type="bulleted">
+ <item>
+ <p><c>cpu_sup:util/0</c> failed with error reason
+ <c>negative_diff</c> when called the first time on a
+ machine (hw) that had been up for a very long time.</p>
+ <p>Own Id: OTP-5869 Aux Id: seq10166</p>
+ </item>
+ </list>
+ </section>
+ </section>
+
+ <section>
+ <title>OS_Mon 1.8</title>
+
+ <section>
+ <title>Improvements and New Features</title>
+ <list type="bulleted">
+ <item>
+ <p>The memsup part of the OS_Mon application has been made
+ more stable. If there are (possibly temporary) problems
+ collecting memory data, the interface functions
+ (<c>get_memory_data/0</c>,
+ <c>get_system_memory_data/0</c>) now do not fail, but
+ return the previously collected value, if any, or a dummy
+ value otherwise. Also, a warning message is printed.</p>
+ <p>*** POTENTIAL INCOMPATIBILITY ***</p>
+ <p>Own Id: OTP-5798</p>
+ </item>
+ </list>
+ </section>
+ </section>
+
+ <section>
+ <title>OS_Mon 1.7.4</title>
+
+ <section>
+ <title>Fixed Bugs and Malfunctions</title>
+ <list type="bulleted">
+ <item>
+ <p>Corrected several problems in the error handling/error
+ recovery (especially when OS_Mon is starting up).</p>
+ <p>Own Id: OTP-5559</p>
+ </item>
+ </list>
+ </section>
+ </section>
+
+ <section>
+ <title>OS_Mon 1.7.3</title>
+
+ <section>
+ <title>Improvements and New Features</title>
+ <list type="bulleted">
+ <item>
+ <p><c>memsup.c</c> will now compile on OpenBSD. (Thanks to
+ Geoff White and Jay Nelson.)</p>
+ <p>The <c>disksup</c> and <c>cpu_sup</c> modules now work on
+ Mac OS X (tested on Mac OS 10.3.8).</p>
+ <p>The <c>memsup</c> module should now work on Linux 2.6.* as
+ well as on older Linuxes. (<c>/proc/meminfo</c> has
+ slightly different formats in different releases of
+ Linux.)</p>
+ <p>Own Id: OTP-5421 <br></br>
+
+ Aux Id: OTP-5194, OTP-5228, OTP-5291 </p>
+ </item>
+ </list>
+ </section>
+ </section>
+
+ <section>
+ <title>OS_Mon 1.7.2</title>
+ <p>This version is identical with 1.7.</p>
+ </section>
+</chapter>
+