doc/RELEASE_NOTES.txt

   1 Release notes for OpenSRF 2.2.0-alpha
   2 =====================================
   3
   4 Supported platforms
   5 -------------------
   6 The following Linux distributions are supported:
   7
   8   * Debian 6 (Squeeze) and 7 (Wheezy)
   9   * Fedora 16, 17, 18
  10   * Ubuntu 10.04 LTS (Lucid Lynx), 12.04 LTS (Precise Pangolin)
  11
  12 New features in 2.2.0
  13 ----------------------
  14
  15 Apache 2.4 support
  16 ~~~~~~~~~~~~~~~~~~
  17 OpenSRF now supports Apache 2.4.
  18
  19 Support graceful reload of Perl services via SIGHUP
  20 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  21 Sending a SIGHUP signal to the listener process of a Perl service will
  22 now cause it to re-read the OpenSRF core configuration and respawn
  23 its child processes.  This allows the log level of the service to be
  24 changed on the fly.
  25
  26 Send Perl warnings to OpenSRF logs
  27 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  28 Warning messages generated by `warn()` and `carp()` calls in Perl
  29 services are now sent to the main OpenSRF log subsystem rather than
  30 the `*_stderr.log` files.
  31
  32 Enable client logtrace with environment vars
  33 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  34 A new environment variable, `OSRF_LOG_CLIENT`, is now recognized which,
  35 if set to true, enables control and generation of the client log trace
  36 value.  This is the same as setting `<client>true</client>` within the
  37 OpenSRF core configuration file.
  38
  39 As a shortcut, if the `MOD_PERL` environment variable is set, assume
  40 client=true.
  41
  42 This allows clients and non-clients to share an OpenSRF core
  43 configuration file, when previously the only difference between the two
  44 was the `<client>` setting.
  45
  46 Significant bugfixes in 2.2.0
  47 -----------------------------
  48
  49 Eliminate CPU spikes caused by use of MultiSession
  50 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  51 The MultiSession module now blocks on the XMPP socket while waiting for
  52 responses from the service requests it fires off rather than using
  53 a CPU-intensive loop to poll for responses.
  54
  55
  56 Fix Java client's parsing of OpenSRF core configuration
  57 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  58 This issue had prevented Java client library from successfully connecting
  59 to an OpenSRF network.
  60
  61 Build improvements
  62 ------------------
  63 OpenSRF's Java libraries can now be built without requiring that
  64 `src/Java/Makefile` be edited manually.
  65
  66 Continuous integration support
  67 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  68 An example configuration file for the http://buildbot.net/[Buildbot] continuous
  69 integration server can be found in `examples/buildbot.cfg`. The most current
  70 version of this file will always be found in the `master` branch of the OpenSRF
  71 git repository.
  72
  73 The build steps configure and compile the code using the default arguments to
  74 `configure`, as well as running the unit tests for C, Perl, and Python, and
  75 running `pylint` against the Python source code.