]> git.evergreen-ils.org Git - OpenSRF.git/blob - doc/RELEASE_NOTES.txt
update release notes for OpenSRF 3.0.1
[OpenSRF.git] / doc / RELEASE_NOTES.txt
1 OpenSRF 3.0.1 release notes
2 ===========================
3
4 Supported platforms
5 -------------------
6 The following Linux distributions are well-tested:
7
8   * Debian 7 (Wheezy), 8 (Jessie), and 9 (Stretch)
9   * Ubuntu 14.04 (Trusty Tahr) and 16.04 LTS (Xenial Xerus)
10
11 OpenSRF 3.0.1
12 -------------
13 OpenSRF 3.0.1 was released on 25 May 2018 and fixes a number of
14 bugs. All users of OpenSRF 3.0.0 are advised to upgrade as soon
15 as possible.
16
17 The following bugs are fixed:
18
19   * LP#1744158: If the WebSockets translator lost its XMPP connection,
20     it could continue to accept requests but would never respond to
21     them. Now, when a WS translator backend gets disconnected from
22     XMPP, it will close the client connection and terminate.
23   * LP#1746577: Under other conditions, a WebSockets translator backend
24     that had lost its XMPP connection could busy-loop, uselessly
25     consuming CPU. This no longer happens.
26   * LP#1762815: This release Fixes an issue in the Perl client time zone
27     handling that resulted in the server defaulting to UTC time instead
28     of the server time zone when no time zone value was received from
29     the client.
30   * LP#1340892: `opensrf.settings` now properly ignores XML comments
31     in `opensrf.xml`, thereby resolving an Evergreen bug where
32     XML comments in the `<marctemplates>` section could break the
33     ability to load MARC templates.
34   * LP#1243841: A number of compilation warnings showing up on newer
35     releases of Debian and Ubuntu are now resolved.
36
37 Acknowledgements
38 ~~~~~~~~~~~~~~~~
39 We would like to thank the following people who contributed to coding
40 and testing for OpenSRF 3.0.1:
41
42   * Galen Charlton
43   * Bill Erickson
44   * Chris Sharp
45   * Jason Stephenson
46
47 OpenSRF 3.0.0
48 -------------
49 OpenSRF 3.0.0 was released on 2 October 2017. It adds support
50 for Debian 9 (Stretch).
51
52 Upgrade Notes
53 ~~~~~~~~~~~~~
54 OpenSRF 3.0 also changes how the shared libraries for services written in
55 C are named.  If upgrading from an earlier version of OpenSRF,
56 `opensrf.xml` should be edited so that shared library file names
57 listed in the `<implementation>` tag start with "lib".  For example,
58
59 [source,sh]
60 ---------------------------------------------------------------------
61             <osrf.math>
62                 <language>C</language>
63                 <implementation>osrf_math.so</implementation>
64 ---------------------------------------------------------------------
65
66 should be changed to:
67
68 [source,sh]
69 ---------------------------------------------------------------------
70             <osrf.math>
71                 <language>C</language>
72                 <implementation>libosrf_math.so</implementation>
73 ---------------------------------------------------------------------
74
75 Note for Evergreen Users
76 ~~~~~~~~~~~~~~~~~~~~~~~~
77 OpenSRF 3.0.0 is the minimum version required to run Evergreen 3.0.
78
79 Acknowledgements
80 ~~~~~~~~~~~~~~~~
81
82 We would like to thank the following people who contributed to OpenSRF 3.0.0:
83
84   * Galen Charlton
85   * Ben Shum
86   * Jason Stephenson