1
<?xml version="1.0" encoding="latin1" ?>
2
<!DOCTYPE chapter SYSTEM "chapter.dtd">
9
<holder>Ericsson AB, All Rights Reserved</holder>
12
The contents of this file are subject to the Erlang Public License,
13
Version 1.1, (the "License"); you may not use this file except in
14
compliance with the License. You should have received a copy of the
15
Erlang Public License along with this software. If not, it can be
16
retrieved online at http://www.erlang.org/.
18
Software distributed under the License is distributed on an "AS IS"
19
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
20
the License for the specific language governing rights and limitations
23
The Initial Developer of the Original Code is Ericsson AB.
26
<title>OS_Mon Release Notes</title>
27
<prepared>otp_appnotes</prepared>
32
<p>This document describes the changes made to the OS_Mon application.</p>
34
<section><title>Os_Mon 2.1.8</title>
36
<section><title>Fixed Bugs and Malfunctions</title>
39
<p>A problem with <c>OTP-OS-MON-MIB.mib</c> for 64-bit
40
environments has now been fixed. The mib has been
41
extended with 64-bit memory retrieval
42
counterparts.</p><p>In addition, a new function
43
<c>get_os_wordsize/0</c> has been added in the
44
<c>memsup</c> module</p>
49
<p>An error in <c>memsup.c</c> caused the compilation to
50
crash on bsd environments. This has now been fixed.</p>
59
<section><title>Os_Mon 2.1.7</title>
61
<section><title>Fixed Bugs and Malfunctions</title>
64
<p>Fixed a build error that occurred on NetBSD (Thanks to
65
Per Hedeland and Raphael Langerhorst)</p>
73
<section><title>Improvements and New Features</title>
76
<p> Memory information in
77
<c>memsup:get_system_memory_data/0</c> now has additional
78
entries in its property list for linux.</p>
80
Own Id: OTP-7409 Aux Id: seq10984 </p>
87
<section><title>Os_Mon 2.1.6</title>
89
<section><title>Fixed Bugs and Malfunctions</title>
93
System information retrieval on darwin platforms with
94
environments locales not conforming to the C locale
95
caused an error in <c>cpu_sup</c> resulting in process
105
<section><title>Os_Mon 2.1.5</title>
106
<section><title>Improvements and New Features</title>
110
CPU utilization, on linux, is now measured via a port
111
program instead of os:cmd in erlang. This should enhance
114
Own Id: OTP-7108 Aux Id: OTP-6935 </p>
120
<section><title>Os_Mon 2.1.3</title>
121
<section><title>Improvements and New Features</title>
122
<list type="bulleted">
125
Extended memsup memory probing on linux to use a port
126
program to probe memory usage. This is faster then the
127
previous implementation.</p>
129
Own Id: OTP-6860 Aux Id: seq10616 </p>
137
<title>Os_Mon 2.1.2.1</title>
140
<title>Improvements and New Features</title>
141
<list type="bulleted">
143
<p>Minor Makefile changes.</p>
144
<p>Own Id: OTP-6689</p>
151
<title>OS_Mon 2.1.2</title>
154
<title>Fixed Bugs and Malfunctions</title>
155
<list type="bulleted">
157
<p>When the <c>memsup_system_only</c> flag was set to
158
<c>true</c>, a <c>badmatch</c> exception occurred in the
159
function <c>os_mon_mib:get_load/1</c>.</p>
160
<p>Own Id: OTP-6351 Aux Id: seq10517</p>
167
<title>OS_Mon 2.1.1</title>
170
<title>Fixed Bugs and Malfunctions</title>
171
<list type="bulleted">
173
<p>Did not build on Mac OS X.</p>
174
<p>Added support for IRIX. (Thanks to Michel Urvoy and
176
<p>Own Id: OTP-6136</p>
182
<title>Improvements and New Features</title>
183
<list type="bulleted">
185
<p><c>disksup</c>: Now using <c>round(T*100)</c> instead of
186
<c>trunc(T*100)</c> when setting the threshold value
187
given a float <c>T</c>.</p>
188
<p>Own Id: OTP-6153</p>
195
<title>Os_Mon 2.1</title>
198
<title>Fixed Bugs and Malfunctions</title>
199
<list type="bulleted">
201
<p>In 2.0, a call to <c>alarm_handler:get_alarms/0</c> was
202
introduced in <c>memsup</c> and <c>disksup</c>. This will
203
lead to problems if the default <c>alarm_handler</c>
204
event handler is not used, however, and the call has now
205
been removed. (Thanks to Serge Aleynikov for pointing
207
<p>Own Id: OTP-6029</p>
210
<p>A bug that in rare cases caused <c>cpu_sup</c> to crash
211
has been corrected.</p>
212
<p>Own Id: OTP-6102 Aux Id: seq10312 </p>
219
<title>OS_Mon 2.0</title>
220
<p>A note on backwards compatibility: The behaviour of OS_Mon 2.0 is
221
backwards compatible under normal operation, but has changed
222
somewhat in error situations: The services do not terminate
223
and the API functions do not raise exceptions in all cases where
224
they did before. Also, in the case where a service does terminate,
225
the exit reason may be different. See below for details.</p>
228
<title>Fixed Bugs and Malfunctions</title>
229
<list type="bulleted">
231
<p>A call to a OS_Mon service (cpu_sup, disksup, ...) when
232
OS_Mon is not running, or when the service is not
233
available for the OS, or when the service is not started,
234
will no longer result in an exception. Instead a warning
235
is issued via error_logger and a dummy value is returned,
236
which one is specified in the man pages for the
237
respective service.</p>
238
<p>The reason is that it should not be necessary for a
239
service to be started on each and every node of a
240
distributed Erlang system for the OS-MON-MIB and other
241
OS_Mon users to work properly.</p>
242
<p>Own Id: OTP-4332 Aux Id: seq7358 </p>
245
<p>References to the obsolete EVA application in
246
OTP-OS-MON-MIB has been removed.</p>
247
<p>Own Id: OTP-5699</p>
250
<p>Setting the option <c>memsup_system_only</c> to
251
<c>true</c> did not work, but would crash the
252
<c>memsup</c> process.</p>
253
<p>Own Id: OTP-5890 Aux Id: seq10185 </p>
256
<p><c>cpu_sup:nprocs/0</c> returned 0 on FreeBsd.</p>
257
<p>Own Id: OTP-5901</p>
260
<p>If the OS_Mon service <c>disksup</c> or <c>memsup</c> was
261
restarted, the same alarm could be set twice. Also, set
262
alarms were not cleared when the application was stopped.</p>
263
<p>Own Id: OTP-5910</p>
269
<title>Improvements and New Features</title>
270
<list type="bulleted">
272
<p>Thresholds and time intervals in <c>disksup</c> and
273
<c>memsup</c> are now configurable in run-time.</p>
274
<p>Own Id: OTP-4246 Aux Id: Seq7230 </p>
277
<p><c>memsup</c> can now handle systems with more than 4GB
279
<p>Own Id: OTP-5800 Aux Id: seq10130 </p>
282
<p>The entire OS_Mon application (code and documentation)
283
has been reviewed and consequently updated with the goal
284
to make the application more robust, homogeneous and
285
easier to configure.</p>
286
<p>The behaviour under normal operation is backwards
287
compatible. However, recoverable errors now no longer
288
terminate the affected service (and thus possible the
289
entire application), instead <c>error_logger</c> is used
290
to warn the user if/when such errors occurs. Also, in the
291
case of unrecoverable errors, the services have been made
292
more homogeneous with respect to behavior and exit
293
reasons. See below for more information and refer to the
294
man pages for details.</p>
295
<p>Port handling has been unified, meaning that if a port
296
program sends garbage or unexpectedly dies, this is now
297
handled the same way by all OS_Mon services, namely
298
immediate process termination with the exit reason
299
<c>{port_error,Garbage}</c> or <c>{port_died,Reason}</c>,
301
<p>Application configuration parameter handling has been
302
unified. Bad parameter values are no longer silently
303
ignored (<c>disksup</c>) or cause application termination
304
(<c>memsup</c>, <c>os_sup</c>). Instead a warning is
305
issued and the default value for the parameter is used.
306
Also, some cases where a bad parameter value accidentally
307
could be accepted have been corrected.</p>
308
<p>Message handling has been unified. Unknown
309
(<c>gen_server-</c>) calls cause process termination,
310
whereas unknown casts and messages are now ignored by all
312
<p>Own Id: OTP-5897</p>
315
<p>The following changes have been made to the <c>os_sup</c>
317
<p>It is now available on Windows, using <c>nteventlog</c>
319
<p>On Solaris, enabling the service (that is, installing a
320
new configuration file for <c>syslogd</c> etc.) can now
321
be done outside the <c>os_sup</c> process. The reason for
322
this is that the Erlang emulator should normally not be
323
run with <c>root</c> privileges, as is otherwise
324
required. The new application configuration parameter
325
<c>os_sup_config</c> must be set to <c>false</c>.</p>
326
<p>Also, <c>os_sup</c> can now be configured using a new
327
configuration parameter <c>os_sup_mfa</c> to call an
328
arbitrary Erlang function when a message is received from
330
<p>Own Id: OTP-5925</p>
333
<p>The <c>memsup</c> service has been rewritten, replacing
334
the supervised <c>memsup_helper</c> with a linked help
335
process. This gives the <c>memsup</c> process more
336
control and prevents a situation where it gets out of
337
synch with the received memory data and thus possibly
338
returns erroneous results.</p>
339
<p>Own Id: OTP-5927</p>
346
<title>OS_Mon 1.8.1</title>
349
<title>Fixed Bugs and Malfunctions</title>
350
<list type="bulleted">
352
<p><c>cpu_sup:util/0</c> failed with error reason
353
<c>negative_diff</c> when called the first time on a
354
machine (hw) that had been up for a very long time.</p>
355
<p>Own Id: OTP-5869 Aux Id: seq10166</p>
362
<title>OS_Mon 1.8</title>
365
<title>Improvements and New Features</title>
366
<list type="bulleted">
368
<p>The memsup part of the OS_Mon application has been made
369
more stable. If there are (possibly temporary) problems
370
collecting memory data, the interface functions
371
(<c>get_memory_data/0</c>,
372
<c>get_system_memory_data/0</c>) now do not fail, but
373
return the previously collected value, if any, or a dummy
374
value otherwise. Also, a warning message is printed.</p>
375
<p>*** POTENTIAL INCOMPATIBILITY ***</p>
376
<p>Own Id: OTP-5798</p>
383
<title>OS_Mon 1.7.4</title>
386
<title>Fixed Bugs and Malfunctions</title>
387
<list type="bulleted">
389
<p>Corrected several problems in the error handling/error
390
recovery (especially when OS_Mon is starting up).</p>
391
<p>Own Id: OTP-5559</p>
398
<title>OS_Mon 1.7.3</title>
401
<title>Improvements and New Features</title>
402
<list type="bulleted">
404
<p><c>memsup.c</c> will now compile on OpenBSD. (Thanks to
405
Geoff White and Jay Nelson.)</p>
406
<p>The <c>disksup</c> and <c>cpu_sup</c> modules now work on
407
Mac OS X (tested on Mac OS 10.3.8).</p>
408
<p>The <c>memsup</c> module should now work on Linux 2.6.* as
409
well as on older Linuxes. (<c>/proc/meminfo</c> has
410
slightly different formats in different releases of
412
<p>Own Id: OTP-5421 <br></br>
414
Aux Id: OTP-5194, OTP-5228, OTP-5291 </p>
421
<title>OS_Mon 1.7.2</title>
422
<p>This version is identical with 1.7.</p>