| 1 | arm4 -- History of visible changes. |
|---|
| 2 | |
|---|
| 3 | Copyright (C) 2005-2007, David Carter <dcarter@arm4.org> |
|---|
| 4 | See the end for copying conditions. |
|---|
| 5 | |
|---|
| 6 | Please send arm4 bug reports to dcarter@arm4.org or use our |
|---|
| 7 | online system at arm4.org |
|---|
| 8 | |
|---|
| 9 | Version 0.6 |
|---|
| 10 | |
|---|
| 11 | This release improves the agent's stability, although that work is still |
|---|
| 12 | ongoing. It's definitely ready for the serious user, but probably more |
|---|
| 13 | the developer or tester than on a production system. A heavily stressed |
|---|
| 14 | system may still experience some agent crashes. That being said, it |
|---|
| 15 | is being used in production environments, but you've been warned. |
|---|
| 16 | |
|---|
| 17 | For now, the requirement for xmlrpc-c has been removed, as the XMLRPC |
|---|
| 18 | reporting system is far from ready. This may be brought back in the |
|---|
| 19 | future as reporting options are explored further. |
|---|
| 20 | |
|---|
| 21 | Tickets closed in this release: |
|---|
| 22 | |
|---|
| 23 | 29 Crashing clients can leave an open message queue |
|---|
| 24 | 32 Add ability to disable RPC server |
|---|
| 25 | 35 Daemon should not accept HUP signals while backing up, or before the db is initialized |
|---|
| 26 | 37 A daemon should be able to detect an already running instance and exit |
|---|
| 27 | 43 arm4.conf needs parameters to controll the Berkeley in memory transaction sizes |
|---|
| 28 | 8 Add data aging |
|---|
| 29 | 23 Parrameterize queue, shared memory, and db home paths |
|---|
| 30 | 33 External programs may crash during DB backup |
|---|
| 31 | 34 Utility programs should be able to specify an archive as a command line option |
|---|
| 32 | 36 Add option to arm4_collect to show what the current collection state is |
|---|
| 33 | 38 When shutting down a program, full message queues may prevent the -s command from getting through |
|---|
| 34 | 40 Integrate arm4_collect into arm4_control |
|---|
| 35 | 41 Builds on RH Enterprise WS 4 require _GNU_SOURCE defined |
|---|
| 36 | 42 Move arm4_daemon's --remove and --clean functionality to arm4_control |
|---|
| 37 | 47 error messages should use syslog facility |
|---|
| 38 | 18 Daemon should be able to operate in user space with configurable parameters |
|---|
| 39 | 46 running arm4_control wipe twice causes a segmentation fault |
|---|
| 40 | |
|---|
| 41 | Known Issues |
|---|
| 42 | |
|---|
| 43 | 1. The agent isn't ready for OS X due to some limitations in its pthreads |
|---|
| 44 | implementation. |
|---|
| 45 | 2. All authorized users are able to control the agent. This needs to be |
|---|
| 46 | restricted. |
|---|
| 47 | 3. Archive operations can report problems opening files. This can be |
|---|
| 48 | ignored. |
|---|
| 49 | 4. Under certain circumstances, a hung or aborted daemon can prevent an |
|---|
| 50 | instrumented application from continuing |
|---|
| 51 | |
|---|
| 52 | Version 0.5 |
|---|
| 53 | |
|---|
| 54 | This release makes a more complete agent. Most subbuffer types are |
|---|
| 55 | now supported, including user buffers, diagnostic buffers, and |
|---|
| 56 | user defined metrics. |
|---|
| 57 | |
|---|
| 58 | Performance has been improved using the Berkeley DB in-memory transaction |
|---|
| 59 | feature. This requires version 4.3 or later, so this is a change in the base |
|---|
| 60 | system requirements. The configuration program has been changed to reflect |
|---|
| 61 | this. |
|---|
| 62 | |
|---|
| 63 | There are some new and expanded tests in the test directory. This is the |
|---|
| 64 | first step in a validation test suite that will be expanded as development |
|---|
| 65 | goes on. |
|---|
| 66 | |
|---|
| 67 | A new debugging utility has been introduced. arm4_dump allows the developer |
|---|
| 68 | to view the contents of the repository database. This isn't meant to be a user |
|---|
| 69 | level tool. |
|---|
| 70 | |
|---|
| 71 | Tickets closed in this release: |
|---|
| 72 | |
|---|
| 73 | 28 arm4_report fails to report transactions on Solaris |
|---|
| 74 | 3 Add support for user-defined metrics |
|---|
| 75 | 24 Aliases should be at the library level, not the daemon |
|---|
| 76 | 22 Add ability to turn ARM collection on and off |
|---|
| 77 | 25 Add support for user buffers in transactions |
|---|
| 78 | 26 Add support for diagnostic details in transactions |
|---|
| 79 | |
|---|
| 80 | Known Issues |
|---|
| 81 | |
|---|
| 82 | In certain cases, program crashes involving programs linked with libarm4 |
|---|
| 83 | may leave an open unnamed message queue. This will need to be removed |
|---|
| 84 | manually, or it will linger until the next reboot. |
|---|
| 85 | |
|---|
| 86 | |
|---|
| 87 | Version 0.4 |
|---|
| 88 | |
|---|
| 89 | The primary purpose of this release was to add an XMLRPC |
|---|
| 90 | reporting interface that could be used by web management tools, |
|---|
| 91 | but along the way many core deficiencies were uncovered and fixed. |
|---|
| 92 | |
|---|
| 93 | The structure of the ARM library and daemon have changed with |
|---|
| 94 | all of the database accesses having moved from the library to |
|---|
| 95 | the daemon. This results in more IPC calls, but greatly improves |
|---|
| 96 | the stability of the agent. |
|---|
| 97 | |
|---|
| 98 | The daemon now contains an XMLRPC interface that is being used to |
|---|
| 99 | develop a web management interface. This interface should not be |
|---|
| 100 | considered stable and is very likely to change as development continues. |
|---|
| 101 | |
|---|
| 102 | Some of the options to the daemon have changed in name and/or function, |
|---|
| 103 | so please read the documentation before using. |
|---|
| 104 | |
|---|
| 105 | Tickets closed in this release: |
|---|
| 106 | |
|---|
| 107 | 13 Berkeley DB permission errors cause database corruption |
|---|
| 108 | 12 Add XMLRPC based reporting interface |
|---|
| 109 | 15 API calls should accept empty ids |
|---|
| 110 | 19 Need to exit gracefully when daemon is unable to create shared regions |
|---|
| 111 | 21 The -r option to arm4_daemon doesn't remove the message queue |
|---|
| 112 | 16 arm_register_application accepts blank names and names with trailing blanks |
|---|
| 113 | 17 The -r option to arm4_daemon doesn't remove the databases as advertised |
|---|
| 114 | |
|---|
| 115 | Known Issues |
|---|
| 116 | |
|---|
| 117 | The agent doesn't currently support user defined metrics. This is |
|---|
| 118 | targeted for the next release. |
|---|
| 119 | |
|---|
| 120 | In certain cases, program crashes involving programs linked with libarm4 |
|---|
| 121 | may leave an open unnamed message queue. This will need to be removed |
|---|
| 122 | manually, or it will linger until the next reboot. |
|---|
| 123 | |
|---|
| 124 | ------------------------------------------------------- |
|---|
| 125 | Copying information: |
|---|
| 126 | |
|---|
| 127 | Copyright (C) 2005-2006, David Carter <dcarter@arm4.org> |
|---|
| 128 | |
|---|
| 129 | Permission is granted to anyone to make or distribute verbatim copies |
|---|
| 130 | of this document as received, in any medium, provided that the |
|---|
| 131 | copyright notice and this permission notice are preserved, |
|---|
| 132 | thus giving the recipient permission to redistribute in turn. |
|---|
| 133 | |
|---|
| 134 | Permission is granted to distribute modified versions |
|---|
| 135 | of this document, or of portions of it, |
|---|
| 136 | under the above conditions, provided also that they |
|---|
| 137 | carry prominent notices stating who last changed them. |
|---|
| 138 | |
|---|
