Update NEWS a bit
[odlparent.git] / docs / NEWS.rst
1 ========================
2 ODL Parent release notes
3 ========================
4
5 Version 11.0.0
6 --------------
7 This is a major upgrade from version 9, with breaking changes; downstream projects may need to make changes to upgrade
8 to this version.
9
10 Improvements and new features
11 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
12 * Minimum required ``Java`` version is 17. Attempts to build a downstream project or load in a previous Java version
13   will result in a failure.
14
15 * The declaration for ``argparse4j`` has been addded. See
16   `ODLPARENT-289 <https://jira.opendaylight.org/browse/ODLPARENT-289>`__ for more information.
17
18 Upstream version removals
19 ~~~~~~~~~~~~~~~~~~~~~~~~~
20 The following upstream dependencies have been removed from dependency/plugin management:
21
22 * Declaration of ``Google Truth`` has been removed. This dependency is not used by any active downstream. See
23   `ODLPARENT-283 <https://jira.opendaylight.org/browse/ODLPARENT-283>`__ for more information.
24
25 * Declaration of ``commons-codec`` has been removed. This dependency is not used by any active downstream. See
26   `ODLPARENT-285 <https://jira.opendaylight.org/browse/ODLPARENT-285>`__ for more information.
27
28 * Declaration of ``commons-fileupload`` has been removed. This dependency is not used by any active downstream. See
29   `ODLPARENT-286 <https://jira.opendaylight.org/browse/ODLPARENT-286>`__ for more information.
30
31 * Declaration of ``commons-net`` has been removed. This dependency is not used by any active downstream. See
32   `ODLPARENT-287 <https://jira.opendaylight.org/browse/ODLPARENT-287>`__ for more information.
33
34 * Declaration of ``jsonassert`` has been removed. This dependency is not used by any active downstream. See
35   `ODLPARENT-288 <https://jira.opendaylight.org/browse/ODLPARENT-288>`__ for more information.
36
37 * Declaration of ``jung`` has been removed. This dependency is not used by any active downstream. See
38   `ODLPARENT-290 <https://jira.opendaylight.org/browse/ODLPARENT-290>`__ for more information.
39
40 * Declaration of ``spring-osgi-mock`` has been removed. This dependency is not used by any active downstream.
41
42 Third-party dependencies
43 ~~~~~~~~~~~~~~~~~~~~~~~~
44 * Checkstyle `10.2 → 10.3 <https://checkstyle.org/releasenotes.html#Release_10.3>`__
45
46 * Jackson `2.13.2 → 2.13.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.13.3>`__
47
48 * Jersey 2.27 → 2.35, release notes:
49    * `2.28 <https://eclipse-ee4j.github.io/jersey.github.io/release-notes/2.28.html>`__
50    * `2.29 <https://github.com/eclipse-ee4j/jersey/releases/tag/2.29>`__
51    * `2.29.1 <https://github.com/eclipse-ee4j/jersey/releases/tag/2.29.1>`__
52    * `2.30 <https://github.com/eclipse-ee4j/jersey/releases/tag/2.30>`__
53    * `2.30.1 <https://github.com/eclipse-ee4j/jersey/releases/tag/2.30.1>`__
54    * `2.31 <https://github.com/eclipse-ee4j/jersey/releases/tag/2.31>`__
55    * `2.32 <https://github.com/eclipse-ee4j/jersey/releases/tag/2.32>`__
56    * `2.33 <https://github.com/eclipse-ee4j/jersey/releases/tag/2.33>`__
57    * `2.34 <https://github.com/eclipse-ee4j/jersey/releases/tag/2.34>`__
58    * `2.35 <https://github.com/eclipse-ee4j/jersey/releases/tag/2.35>`__
59
60 * Karaf `4.3.7 → 4.4.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12349243>`__
61
62 * Mockito 4.5.1 → 4.6.1, release notes:
63   * `4.6.0 <https://github.com/mockito/mockito/releases/tag/v4.6.0>`__
64   * `4.6.1 <https://github.com/mockito/mockito/releases/tag/v4.6.1>`__
65
66 * SpotBugs `4.6.0 → 4.7.0 <https://github.com/spotbugs/spotbugs/releases/tag/4.7.0>`__
67
68 Plugin upgrades
69 ~~~~~~~~~~~~~~~
70 * cyclonedx-maven-plugin 2.5.3 → 2.6.2
71
72 * maven-bundle-plugin `5.1.5 → 5.1.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12351722>`__
73
74 * maven-javadoc-plugin 3.1.1 → 3.4.0, release notes:
75   * `3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12345698>`__
76   * `3.3.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12346637>`__
77   * `3.3.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12347807>`__
78   * `3.3.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12350586>`__
79   * `3.4.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12330874>`__
80
81 * maven-surefire-plugin 2.22.2 → 3.0.0-M6, release notes:
82   * `3.0.0-M1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317927&version=12342871>`__
83   * `3.0.0-M2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317927&version=12344396>`__
84   * `3.0.0-M3 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317927&version=12342872>`__
85   * `3.0.0-M4 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317927&version=12344668>`__
86   * `3.0.0-M5 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317927&version=12344612>`__
87   * `3.0.0-M6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317927&version=12344613>`__
88
89 * project-info-reports-plugin `3.2.2 → 3.3.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317821&version=12351604>`__
90
91 * spotbugs-maven-plugin `4.6.0.0 → 4.7.0.0 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-4.7.0.0>`__
92
93 Version 10.0.0
94 --------------
95 This is a major upgrade from version 9, with breaking changes; downstream projects may need to make changes to upgrade
96 to this version.
97
98 Log4Shell and similar vulnerabilities
99 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
100 This release addresses following security issues by its adopting ``log4j-2.17.1``,
101 ``logback-1.2.10`` and ``pax-logging-2.0.14``:
102
103 * `CVE-2021-42550 <https://nvd.nist.gov/vuln/detail/CVE-2021-42550>`__ and related problems
104   were further mitigated by reducing complexity in ``logback-1.2.10``
105
106 * `CVE-2021-44228 <https://nvd.nist.gov/vuln/detail/CVE-2021-44228>`__
107
108 * `CVE-2021-44832 <https://nvd.nist.gov/vuln/detail/CVE-2021-44832>`__
109
110 * `CVE-2021-45046 <https://nvd.nist.gov/vuln/detail/CVE-2021-45046>`__
111
112 * `CVE-2021-45105 <https://nvd.nist.gov/vuln/detail/CVE-2021-45105>`__
113
114 Upstream version removals
115 ~~~~~~~~~~~~~~~~~~~~~~~~~
116 The following upstream dependencies have been removed from dependency/plugin management:
117
118 * Declaration of ``blueprint-maven-plugin`` has been removed. This plugin has not seen a release in 3 years
119   and its use typically leads to split container definitions. Users are advised to migrate to either
120   hand-written Blueprint XML files or, preferrably, migrate to OSGi Declarative Services. See
121   `ODLPARENT-267 <https://jira.opendaylight.org/browse/ODLPARENT-267>`__ for more information.
122
123 * The declaration and execution of ``maven-pmd-plugin`` has been removed. See
124   `ODLPARENT-269 <https://jira.opendaylight.org/browse/ODLPARENT-269>`__ for more information.
125
126 * All ``Xtend`` dependency and plugin declarations have been removed. Xtend is currently only used by
127   a single artifact in MD-SAL, hence the dependency is best managed there. Furthermore Xtend is facing
128   challenges around maintainership, hence its use is discouraged. See
129   `ODLPARENT-273 <https://jira.opendaylight.org/browse/ODLPARENT-273>`__ for more information.
130
131 * All ``Powermock``  dependency declarations have been removed. We have very few remaining downstream
132   users, who can manage this dependency themselves. The version of ``Mockito`` we declare has facilities
133   to cover all use cases previously covered only by PowerMock. See
134   `ODLPARENT-275 <https://jira.opendaylight.org/browse/ODLPARENT-275>`__ for more information.
135
136 * Declarations of ``osgi.annotation``, ``osgi.cmpn`` and ``osgi.core`` have been removed. These are
137   monolithic JARs providing, which are no longer shipped in OSGi Release 8. Users are advised to use
138   component dependencies, such as ``org.osgi.annotation.bundle``, ``org.osgi.framework``,
139   ``org.osgi.service.component.annotations`` and similar. See
140   `ODLPARENT-277 <https://jira.opendaylight.org/browse/ODLPARENT-277>`__ for more information.
141
142 * The ``H2 Database`` version declaration has been removed. It is used only by as single downstream
143   user, who also provides its OSGi packaging and hence it is best maintained there.
144
145 Improvements and new features
146 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
147 * Minimum ``Maven`` version required to build projects using ``odlparent`` has been raised to ``3.8.3``.
148   See `ODLPARENT-260 <https://jira.opendaylight.org/browse/ODLPARENT-260>`__ for more information.
149 * Unit tests are now using ``JUnit 5 Jupiter Engime`` for unit test execution, with ``JUnit 4`` tests
150   supported by ``junit-vintage-engine``. This enables downstreams to use the much more modern JUnit 5 APIs
151   as well as the corresponding Mockito integration out of the box. See
152   `ODLPARENT-271 <https://jira.opendaylight.org/browse/ODLPARENT-271>`__ for more information.
153 * A CycloneDX SBOM is generated by default for all artifacts using ``odlparent-lite``. See
154   `ODLPARENT-280 <https://jira.opendaylight.org/browse/ODLPARENT-280>`__ for more information.
155 * ``netty-transport-native-epoll`` is now supported on Linux/AArch64. See
156   `ODLPARENT-241 <https://jira.opendaylight.org/browse/ODLPARENT-241>`__ for more information.
157 * A number of stale Karaf ``custom.properties`` have been removed. See
158   `ODLPARENT-34 <https://jira.opendaylight.org/browse/ODLPARENT-34>`__ for more information.
159 * Karaf features are now tested when building with Java versions up to and including 17.
160 * SpotBugs analysis is now enabled when building with Java versions up to and including 17.
161
162 Third-party dependencies
163 ~~~~~~~~~~~~~~~~~~~~~~~~
164 * Bouncy Castle `1.69 → 1.70 <https://www.bouncycastle.org/releasenotes.html>`__
165
166 * Checkstyle 8.45.1 → 9.2.1, release notes:
167   * `9.0 <https://checkstyle.org/releasenotes.html#Release_9.0>`__
168   * `9.0 <https://checkstyle.org/releasenotes.html#Release_9.0.1>`__
169   * `9.1 <https://checkstyle.org/releasenotes.html#Release_9.1>`__
170   * `9.2 <https://checkstyle.org/releasenotes.html#Release_9.2>`__
171   * `9.2.1 <https://checkstyle.org/releasenotes.html#Release_9.2.1>`__
172
173 * Dropwizard Metrics 4.1.25 → 4.2.8, release notes:
174   * `4.2.0 <https://github.com/dropwizard/metrics/releases/tag/v4.2.0>`__
175   * `4.2.1 <https://github.com/dropwizard/metrics/releases/tag/v4.2.1>`__
176   * `4.2.2 <https://github.com/dropwizard/metrics/releases/tag/v4.2.2>`__
177   * `4.2.3 <https://github.com/dropwizard/metrics/releases/tag/v4.2.3>`__
178   * `4.2.4 <https://github.com/dropwizard/metrics/releases/tag/v4.2.4>`__
179   * `4.2.5 <https://github.com/dropwizard/metrics/releases/tag/v4.2.5>`__
180   * `4.2.6 <https://github.com/dropwizard/metrics/releases/tag/v4.2.6>`__
181   * `4.2.7 <https://github.com/dropwizard/metrics/releases/tag/v4.2.7>`__
182   * `4.2.8 <https://github.com/dropwizard/metrics/releases/tag/v4.2.8>`__
183
184 * GSON `2.8.9 → 2.9.0 <https://github.com/google/gson/releases/tag/gson-parent-2.9.0>`__
185
186 * Guava 30.1.1 → 31.1, release notes:
187   * `31.0 <https://github.com/google/guava/releases/tag/v31.0>`__
188   * `31.0.1 <https://github.com/google/guava/releases/tag/v31.0.1>`__
189   * `31.1 <https://github.com/google/guava/releases/tag/v31.1>`__
190
191 * Jackson `2.16.5 → 2.16.6 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.6>`__
192
193 * Javassist 3.27.0 → 3.28.0
194
195 * Karaf 4.3.3 → 4.3.6, release notes:
196   * `4.3.4 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12350547>`__
197   * `4.3.5 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12350856>`__
198   * `4.3.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12351123>`__
199
200 * Log4J 2.14.1 → 2.17.1, release notes:
201   * `2.15.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.15.0>`__
202   * `2.16.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.16.0>`__
203   * `2.17.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.17.0>`__
204   * `2.17.1 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.17.1>`__
205
206 * Logback `1.2.5 → 1.2.10 <http://logback.qos.ch/news.html>`__
207
208 * Mockito 3.12.4 → 4.3.1, release notes:
209   * `4.0.0 <https://github.com/mockito/mockito/releases/tag/v4.0.0>`__
210   * `4.2.0 <https://github.com/mockito/mockito/releases/tag/v4.1.0>`__
211   * `4.3.0 <https://github.com/mockito/mockito/releases/tag/v4.2.0>`__
212   * `4.3.1 <https://github.com/mockito/mockito/releases/tag/v4.3.1>`__
213
214 * Netty 4.1.67 → 4.1.74, release notes:
215   * `4.1.70 <https://netty.io/news/2021/10/11/4-1-70-Final.html>`__
216   * `4.1.71 <https://netty.io/news/2021/12/09/4-1-71-Final.html>`__
217   * `4.1.72 <https://netty.io/news/2021/12/13/4-1-72-Final.html>`__
218   * `4.1.73 <https://netty.io/news/2022/01/12/4-1-73-Final.html>`__
219   * `4.1.74 <https://netty.io/news/2022/02/08/4-1-74-Final.html>`__
220
221 * Sevntu `1.40.0 → 1.41.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.41.0>`__
222
223 * Woodstox 6.2.6 → 6.2.8, release notes:
224   * `6.2.7 <https://github.com/FasterXML/woodstox/milestone/24?closed=1>`__
225   * `6.2.8 <https://github.com/FasterXML/woodstox/milestone/26?closed=1>`__
226
227 * xmlunit 2.8.3 → 2.9.0, release notes:
228   * `2.8.4 <https://github.com/xmlunit/xmlunit/releases/tag/v2.8.4>`__
229   * `2.9.0 <https://github.com/xmlunit/xmlunit/releases/tag/v2.9.0>`__
230
231 Plugin upgrades
232 ~~~~~~~~~~~~~~~
233 * asciidoctor-maven-plugin `2.2.1 → 2.2.2 <https://github.com/asciidoctor/asciidoctor-maven-plugin/releases/tag/asciidoctor-maven-plugin-2.2.2>`__
234
235 * bnd-maven-plugin 6.0.0 → 6.2.0, release notes:
236   * `6.1.0 <https://github.com/bndtools/bnd/wiki/Changes-in-6.1.0>`__
237   * `6.2.0 <https://github.com/bndtools/bnd/wiki/Changes-in-6.2.0>`__
238
239 * builder-helper-maven-plugin `3.2.0 → 3.3.0 <https://github.com/mojohaus/build-helper-maven-plugin/releases/tag/build-helper-maven-plugin-3.3.0>`__
240
241 * git-commit-id-maven-plugin `4.0.5 → 5.0.0 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v5.0.0>`__
242
243 * maven-compiler-plugin 3.8.1 → 3.10.0, release notes:
244   * `3.9.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317225&version=12345214>`__
245   * `3.10.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317225&version=12351256>`__
246
247 * maven-bundle-plugin 5.1.2 → 5.1.4, release notes:
248   * `5.1.3 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12350117>`__
249   * `5.1.4 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12351195>`__
250
251 * maven-jar-plugin 3.2.0 → 3.2.2, release notes:
252   * `3.2.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12348050>`__
253   * `3.2.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12351215>`__
254
255 * maven-plugin-plugin `3.6.1 → 3.6.2 <https://maven.apache.org/docs/3.6.2/release-notes.html>`__
256
257 * maven-site-plugin `3.9.1 → 3.10.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317923&version=12348370>`__
258
259 * modernizer-maven-plugin `2.2.0 → 2.3.0 <https://github.com/gaul/modernizer-maven-plugin/releases/tag/modernizer-maven-plugin-2.3.0>`__
260
261 * spotbugs-maven-plugin 3.12.2 → 4.5.3, release notes:
262   `4.0.0 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#400---2020-02-15>`__
263   `4.0.1 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#401---2020-03-19>`__
264   `4.0.2 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#402---2020-04-15>`__
265   `4.0.3 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#403---2020-05-13>`__
266   `4.0.4 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#404---2020-06-09>`__
267   `4.0.5 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#405---2020-06-20>`__
268   `4.0.6 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#406---2020-06-23>`__
269   `4.1.0 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#410---2020-07-30>`__
270   `4.1.1 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#411---2020-07-31>`__
271   `4.1.2 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#412---2020-08-18>`__
272   `4.1.3 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#413---2020-09-25>`__
273   `4.1.4 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#414---2020-10-15>`__
274   `4.2.0 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#420---2020-11-28>`__
275   `4.2.1 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#421---2021-02-04>`__
276   `4.2.2 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#422---2021-03-03>`__
277   `4.2.3 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#423---2021-04-12>`__
278   `4.3.0 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#430---2021-07-01>`__
279   `4.4.0 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#440---2021-08-12>`__
280   `4.4.1 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#441---2021-09-07>`__
281   `4.4.2 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#442---2021-10-08>`__
282   `4.5.0 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#450---2021-11-05>`__
283   `4.5.1 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#451---2021-12-08>`__
284   `4.5.2 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#452---2021-12-13>`__
285   `4.5.3 <https://github.com/spotbugs/spotbugs/blob/4.5.3/CHANGELOG.md#453---2022-01-04>`__
286
287 Version 9.0.8
288 -------------
289 This is a bug-fix upgrade from version 9.0.7.
290
291 Bug fixes
292 ~~~~~~~~~
293 * The fix for `ODLPARENT-220 <https://jira.opendaylight.org/browse/ODLPARENT-220>`__ ended up
294   changing behavior and packaging ``INFO.yaml`` instead of ``PROJECT_INFO.yaml``. This has now
295   been fixed.
296
297 Version 9.0.7
298 -------------
299 This is a bug-fix upgrade from version 9.0.6.
300
301 Bug fixes
302 ~~~~~~~~~
303 * The upgrade of ``maven-dependency-plugin`` to version 3.2.0 has caused a regression in accuracy
304   of reports, with quite a few false positives being generated. The declaration has been rolled
305   back to version 3.1.2 with a few tweaks to improve JDK compatibility. See
306   `ODLPARENT-270 <https://jira.opendaylight.org/browse/ODLPARENT-270>`__ for more information.
307
308 Improvements
309 ~~~~~~~~~~~~
310 * The declaration and invocation of ``script-maven-plugin`` has been replaced with a dedicated
311   plugin providing the same functionality in a much more performant way.  See
312   `ODLPARENT-220 <https://jira.opendaylight.org/browse/ODLPARENT-220>`__ for more information.
313
314 * A new parent pom.xml, ``bnd-parent``, is now available as an alternative to the existing
315   ``bundle-parent``.  It has a more streamlined integration with other plugins, for example
316   maven-jar-plugin, and a much healthier community. See
317   `ODLPARENT-258 <https://jira.opendaylight.org/browse/ODLPARENT-258>`__ for more information.
318
319 * The definition of ``odl-karaf-feat-jdbc`` feature has been reworked to not pull in the entire
320   ``enterprise`` feature repository, leading to significant savings in terms of Karaf distribution
321   size for most downstream projects. See
322   `ODLPARENT-266 <https://jira.opendaylight.org/browse/ODLPARENT-266>`__ for more information.
323
324 * The declaration of ``maven-compiler-plugin`` is now available in ``odlparent-lite``. This is
325   improves locality, as the JDK version enforcement is already part of odlparent-lite.
326
327 Third-party dependencies
328 ~~~~~~~~~~~~~~~~~~~~~~~~
329 * GSON 2.8.5 → 2.8.8, release notes:
330   * `2.8.6 <https://github.com/google/gson/blob/master/CHANGELOG.md#version-286>`__
331   * `2.8.7 <https://github.com/google/gson/blob/master/CHANGELOG.md#version-287>`__
332   * `2.8.8 <https://github.com/google/gson/blob/master/CHANGELOG.md#version-288>`__
333
334 * Jolokia `1.7.0 → 1.7.1 <https://jolokia.org/changes-report.html#a1.7.1>`__
335
336 * Mockito 3.9.0 → 3.12.4, release notes:
337   * `3.9.2 <https://github.com/mockito/mockito/releases/tag/v3.9.2>`__
338   * `3.9.3 <https://github.com/mockito/mockito/releases/tag/v3.9.3>`__
339   * `3.9.7 <https://github.com/mockito/mockito/releases/tag/v3.9.7>`__
340   * `3.9.9 <https://github.com/mockito/mockito/releases/tag/v3.9.9>`__
341   * `3.9.10 <https://github.com/mockito/mockito/releases/tag/v3.9.10>`__
342   * `3.11.0 <https://github.com/mockito/mockito/releases/tag/v3.11.0>`__
343   * `3.11.1 <https://github.com/mockito/mockito/releases/tag/v3.11.1>`__
344   * `3.11.2 <https://github.com/mockito/mockito/releases/tag/v3.11.2>`__
345   * `3.12.0 <https://github.com/mockito/mockito/releases/tag/v3.12.0>`__
346   * `3.12.1 <https://github.com/mockito/mockito/releases/tag/v3.12.1>`__
347   * `3.12.2 <https://github.com/mockito/mockito/releases/tag/v3.12.2>`__
348   * `3.12.3 <https://github.com/mockito/mockito/releases/tag/v3.12.3>`__
349
350 * Netty 4.1.67 → 4.1.69, release notes:
351   * `4.1.68 <https://netty.io/news/2021/09/09/4-1-68-Final.html>`__
352   * `4.1.69 <https://netty.io/news/2021/10/11/4-1-69-Final.html>`__
353
354 Version 9.0.6
355 -------------
356 This is a bug-fix upgrade from version 9.0.5.
357
358 Third-party dependencies
359 ~~~~~~~~~~~~~~~~~~~~~~~~
360 * Jackson 2.11.4 → 2.12.5, release notes:
361   * `2.12 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12>`__
362   * `2.12.1 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.1>`__
363   * `2.12.2 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.2>`__
364   * `2.12.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.3>`__
365   * `2.12.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.4>`__
366   * `2.12.5 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.12.5>`__
367
368 * Jetty 9.4.40 → 9.4.43.v20210629, release notes:
369   * `9.4.41.v20210516 <https://github.com/eclipse/jetty.project/releases/tag/jetty-9.4.41.v20210516>`__
370   * `9.4.42.v20210604 <https://github.com/eclipse/jetty.project/releases/tag/jetty-9.4.42.v20210604>`__
371   * `9.4.43.v20210629 <https://github.com/eclipse/jetty.project/releases/tag/jetty-9.4.43.v20210629>`__
372
373 * Jolokia `1.6.2 → 1.7.0 <https://jolokia.org/changes-report.html#a1.7.0>`__
374
375 * Karaf `4.3.2 → 4.3.3 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12350142>`__
376
377 * Pax URL 2.5.4 → 2.6.7, release notes:
378   * `2.6.0 <https://github.com/ops4j/org.ops4j.pax.url/milestone/67?closed=1>`__
379   * `2.6.3 <https://github.com/ops4j/org.ops4j.pax.url/milestone/68?closed=1>`__
380   * `2.6.4 <https://github.com/ops4j/org.ops4j.pax.url/milestone/69?closed=1>`__
381   * `2.6.6 <https://github.com/ops4j/org.ops4j.pax.url/milestone/71?closed=1>`__
382   * `2.6.7 <https://github.com/ops4j/org.ops4j.pax.url/milestone/72?closed=1>`__
383
384 Plugin upgrades
385 ~~~~~~~~~~~~~~~
386 * maven-enforcer-plugin `3.0.0-M3 → 3.0.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317520&version=12346527>`__
387
388 * asciidoctor-maven-plugin 2.1.0 → 2.2.1
389
390 Version 9.0.5
391 -------------
392 This is a minor upgrade from version 9.0.4.
393
394 Bug fixes
395 ~~~~~~~~~
396 * Previous patch to address Bouncy Castle missed a critical piece for populating boot class path. This has now
397   been corrected.
398
399
400 Version 9.0.4
401 -------------
402 This is a minor upgrade from version 9.0.3.
403
404 Bug fixes
405 ~~~~~~~~~
406 * The upgrade to Bouncy Castle 1.69 turned out to be broken due to some code movement and introduction of a new
407   ``bcutil-jdk15on`` artifact. It has also highlighted duplicate packaging, where Karaf's features would install
408   version 1.66, while we have been on a newer version for some time. Both these issues have now ween resolved.
409   See `ODLPARENT-254 <https://jira.opendaylight.org/browse/ODLPARENT-254>`__ for more information.
410
411
412 Version 9.0.3
413 -------------
414 This is a minor upgrade from version 9.0.2.
415
416 Third-party dependencies
417 ~~~~~~~~~~~~~~~~~~~~~~~~
418 * awaitility `4.0.3 → 4.1.0 <https://raw.githubusercontent.com/awaitility/awaitility/master/changelog.txt>`__
419
420 * Bouncy Castle `1.68 → 1.69 <https://www.bouncycastle.org/releasenotes.html>`__
421
422 * Checkstyle 8.42 → 8.45.1, release notes:
423   * `8.43 <https://checkstyle.org/releasenotes.html#Release_8.43>`__
424   * `8.44 <https://checkstyle.org/releasenotes.html#Release_8.44>`__
425   * `8.45 <https://checkstyle.org/releasenotes.html#Release_8.45>`__
426   * `8.45.1 <https://checkstyle.org/releasenotes.html#Release_8.45.1>`__
427
428 * commons-io 2.8.0 → 2.11.0, release notes:
429   * `2.9.0 <https://commons.apache.org/proper/commons-io/changes-report.html#a2.9.0>`__
430   * `2.10.0 <https://commons.apache.org/proper/commons-io/changes-report.html#a2.10.0>`__
431   * `2.11.0 <https://commons.apache.org/proper/commons-io/changes-report.html#a2.11.0>`__
432
433 * Dropwizard Metrics 4.1.21 → 4.1.25, release notes:
434   * `4.1.22 <https://github.com/dropwizard/metrics/releases/tag/v4.1.22>`__
435   * `4.1.23 <https://github.com/dropwizard/metrics/releases/tag/v4.1.23>`__
436   * `4.1.24 <https://github.com/dropwizard/metrics/releases/tag/v4.1.24>`__
437   * `4.1.25 <https://github.com/dropwizard/metrics/releases/tag/v4.1.25>`__
438
439 * Google Truth `1.1.2 → 1.1.3 <https://github.com/google/truth/releases/tag/release_1_1_3>`__
440
441 * logback 1.2.3 → 1.2.5, release notes:
442   * `1.2.4 <https://jira.qos.ch/issues/?jql=project+%3D+LOGBACK+AND+fixVersion+%3D+1.2.4>`__
443   * `1.2.5 <https://jira.qos.ch/issues/?jql=project+%3D+LOGBACK+AND+fixVersion+%3D+1.2.5>`__
444
445 * Netty 4.1.65 → 4.1.67, release notes:
446   * `4.1.66 <https://netty.io/news/2021/07/16/4-1-66-Final.html>`__
447   * `4.1.67 <https://netty.io/news/2021/08/16/4-1-67-Final.html>`__
448
449 * Sevntu `1.39.0 → 1.40.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.40.0>`__
450
451 * ThreeTen `1.6.0 → 1.7.0 <https://www.threeten.org/threeten-extra/changes-report.html#a1.7.0>`__
452
453 Plugin upgrades
454 ~~~~~~~~~~~~~~~
455 * git-commit-id-plugin `4.0.4 → 4.0.5 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.5>`__
456
457 * Jacoco Maven plugin `0.8.6 → 0.8.7 <https://github.com/jacoco/jacoco/releases/tag/v0.8.7>`__
458
459 * maven-dependency-plugin `3.1.2 → 3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317227&version=12348705>`__
460
461 * maven-plugin-plugin `3.6.0 → 3.6.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317820&version=12344365>`__
462
463 * project-info-reports-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317821&version=12349521>`__
464
465 Version 9.0.2
466 -------------
467 This is a minor upgrade from version 9.0.1.
468
469 Bug fixes
470 ~~~~~~~~~
471 * The upgrade to Karaf 4.3.0 caused a slight misalignment of ``org.apache.felix.metatype``
472   and ``org.osgi.service.event`` versions, leading to an unnecessary rewiring of the container
473   most notably during Single Feature Test. This has now been corrected.
474   See `ODLPARENT-253 <https://jira.opendaylight.org/browse/ODLPARENT-253>`__ for more information.
475
476 * ``stax-utils`` component has a default dependency on ``com.bea.xml:jsr174-ri``, which is not
477   resolvable from Maven Central. This artifact is not needed with modern JRE versions, hence add
478   an explicit exclusion.
479
480 Third-party dependencies
481 ~~~~~~~~~~~~~~~~~~~~~~~~
482 * Jetty 9.4.38.v20210224 → 9.4.40.v20210413, release notes:
483   * `9.4.39.v20210325 <https://github.com/eclipse/jetty.project/releases/tag/jetty-9.4.39.v20210325>`__
484   * `9.4.40.v20210413 <https://github.com/eclipse/jetty.project/releases/tag/jetty-9.4.40.v20210413>`__
485
486 * Karaf `4.3.1 → 4.3.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12349968>`__
487
488 * Netty `4.1.63 → 4.1.65 <https://netty.io/news/2021/05/19/4-1-65-Final.html>`__
489
490 Version 9.0.1
491 -------------
492 This is a minor upgrade from version 9.0.0.
493
494 Bug fixes
495 ~~~~~~~~~
496 The upgrade of ``duplicate-finder-maven-plugin`` ended up triggering build failures on ``.api_description``
497 files packaged in artifacts. This regression has now been fixed.
498
499 Third-party dependencies
500 ~~~~~~~~~~~~~~~~~~~~~~~~
501 * Checkstyle `8.41 → 8.42 <https://checkstyle.org/releasenotes.html#Release_8.42>`__.
502
503 * Dropwizard Metrics 4.1.19 → 4.1.21, release notes:
504   * `4.1.20 <https://github.com/dropwizard/metrics/releases/tag/v4.1.20>`__
505   * `4.1.21 <https://github.com/dropwizard/metrics/releases/tag/v4.1.21>`__
506
507 * LMAX Disruptor 3.4.2 → 3.4.4, release notes:
508   * `3.4.3 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.3>`__
509   * `3.4.3 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.4>`__
510
511 * Woodstox `6.2.5 → 6.2.6 <https://github.com/FasterXML/woodstox/milestone/23?closed=1>`__
512
513 * XBean finder `4.18 → 4.19 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12348824>`__
514
515 Plugin upgrades
516 ~~~~~~~~~~~~~~~
517 * maven-bundle-plugin 4.2.1 → 5.1.2, release notes:
518   * `5.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12346016>`__
519   * `5.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12350026>`__
520
521 Version 9.0.0
522 -------------
523 This is a major upgrade from version 8, with breaking changes; downstream projects may need to make changes to upgrade
524 to this version.
525
526 Upstream version removals
527 ~~~~~~~~~~~~~~~~~~~~~~~~~
528 The following upstream dependencies have been removed from dependency management:
529
530 * ``javax.inject:javax.inject``. This dependency should be provided by target runtime. Furthermore we provide the same
531   functionality via ``com.guicedee.services:javax.inject``, which is properly declared and is a JPMS module. See
532   `ODLPARENT-246 <https://jira.opendaylight.org/browse/ODLPARENT-246>`__ for more information.
533
534 Improvements
535 ~~~~~~~~~~~~
536 * The configuration of ``maven-compiler-plugin`` has been updated to expand ``javac`` warning options to include almost
537   all of them.
538 * The default description in parent ``pom.xml`` has been updated to only include ``${project.artifactId}``, not a generic
539   blurb. See `ODLPARENT-244 <https://jira.opendaylight.org/browse/ODLPARENT-244>`__ for more information.
540 * The ``single-feature-test`` substrate has been updated to allow Java Flight Recorder to be enabled during testing runs.
541   This feature has falled into disrepair as the JFR facility has been productized.
542 * Configuration of various components has been updated to be deactivated when executing with JDK versions newer than 11,
543   so that odlparent infrastructure works out of the box with JDK 16, albeit sacrificing some validation. Most notably
544   ``SpotBugs`` and ``Single Feature Test`` are disabled, with corresponding notices displayed.
545 * We now expose the ability to check dependency declaration consistency via ``maven-dependency-plugin``'s ``analyze-only``
546   goal. This functionality is enabled by default, but does not cause the build to fail when inconsistencies are found. It
547   can be disabled by on a per-artifact basis by definining ``odlparent.dependency.skip`` property to ``true``. It can also
548   be configured to fail the build on a per-artifact basis by defining ``odlparent.dependency.enforce`` property to ``true``.
549
550 Third-party dependencies
551 ~~~~~~~~~~~~~~~~~~~~~~~~
552 * Antlr 4.8-1 → 4.9.2, release notes:
553   * `4.9 <https://github.com/antlr/antlr4/releases/tag/4.9>`__
554   * `4.9.1 <https://github.com/antlr/antlr4/releases/tag/4.9.1>`__
555   * `4.9.2 <https://github.com/antlr/antlr4/releases/tag/4.9.2>`__
556
557 * Checkstyle 8.39.0 → 8.41.1, release notes:
558   * `8.40.0 <https://checkstyle.org/releasenotes.html#Release_8.40.0>`__
559   * `8.41.0 <https://checkstyle.org/releasenotes.html#Release_8.41.0>`__
560   * `8.41.1 <https://checkstyle.org/releasenotes.html#Release_8.41.1>`__
561
562 * commons-lang3 `3.11 → 3.12 <https://commons.apache.org/proper/commons-lang/changes-report.html#a3.12>`__
563
564 * Dropwizard Metrics 4.1.12.1 → 4.1.19, release notes:
565   * `4.1.13 <https://github.com/dropwizard/metrics/releases/tag/v4.1.13>`__
566   * `4.1.14 <https://github.com/dropwizard/metrics/releases/tag/v4.1.14>`__
567   * `4.1.15 <https://github.com/dropwizard/metrics/releases/tag/v4.1.15>`__
568   * `4.1.16 <https://github.com/dropwizard/metrics/releases/tag/v4.1.16>`__
569   * `4.1.17 <https://github.com/dropwizard/metrics/releases/tag/v4.1.17>`__
570   * `4.1.18 <https://github.com/dropwizard/metrics/releases/tag/v4.1.18>`__
571   * `4.1.19 <https://github.com/dropwizard/metrics/releases/tag/v4.1.19>`__
572
573 * Enunciate `2.13.2 → 2.13.3 <https://github.com/stoicflame/enunciate/releases/tag/v2.13.3>`__
574
575 * Google Truth 1.1 → 1.1.2, release notes:
576   * `1.1.1 <https://github.com/google/truth/releases/tag/release_1_1_1>`__
577   * `1.1.2 <https://github.com/google/truth/releases/tag/release_1_1_2>`__
578
579 * Guava 29.0 → 30.1.1, release notes:
580   * `30.0 <https://github.com/google/guava/releases/tag/v30.0>`__
581   * `30.1 <https://github.com/google/guava/releases/tag/v30.1>`__
582   * `30.1.1 <https://github.com/google/guava/releases/tag/v30.1.1>`__
583
584 * JUnit `4.13.1 → 4.13.2 <https://github.com/junit-team/junit4/blob/HEAD/doc/ReleaseNotes4.13.2.md>`__
585
586 * Karaf `4.3.0 → 4.3.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12348818>`__
587
588 * Log4J 2.13.3 → 2.14.1, release notes:
589   * `2.14.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.14.0>`__
590   * `2.14.1 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.14.1>`__
591
592 * Netty 4.1.59 → 4.1.63, release notes:
593   * `4.1.60 <https://netty.io/news/2021/03/09/4-1-60-Final.html>`__
594   * `4.1.61 <https://netty.io/news/2021/03/30/4-1-61-Final.html>`__
595   * `4.1.62 <https://netty.io/news/2021/03/31/4-1-62-Final.html>`__
596   * `4.1.63 <https://netty.io/news/2021/04/01/4-1-63-Final.html>`__
597
598 * Sevntu `1.38.0 → 1.39.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.39.0>`__
599
600 * ThreeTen `1.5.0 → 1.6.0 <https://www.threeten.org/threeten-extra/changes-report.html#a1.6.0>`__
601
602 * Woodstox `6.2.4 → 6.2.5 <https://github.com/FasterXML/woodstox/milestone/22?closed=1>`__
603
604 * Xtend `2.24.0 → 2.25.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2021/03/02/version-2-25-0>`__
605
606 Plugin upgrades
607 ~~~~~~~~~~~~~~~
608 * Asciidoctor 1.5.7.1 → 2.1.0 (with related AsciidoctorJ upgrades)
609   * `2.0.0 <https://github.com/asciidoctor/asciidoctor-maven-plugin/releases/tag/asciidoctor-maven-plugin-2.0.0>`__
610   * `2.1.0 <https://github.com/asciidoctor/asciidoctor-maven-plugin/releases/tag/asciidoctor-maven-plugin-2.1.0>`__
611
612 * git-commit-id-plugin 3.0.1 → 4.0.4, release notes:
613   * `4.0.0 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.0>`__
614   * `4.0.1 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.1>`__
615   * `4.0.2 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.2>`__
616   * `4.0.3 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.3>`__
617   * `4.0.4 <https://github.com/git-commit-id/git-commit-id-maven-plugin/releases/tag/v4.0.4>`__
618
619 * modernizer-maven-plugin `2.1.0 → 2.2.0 <https://github.com/gaul/modernizer-maven-plugin/releases/tag/modernizer-maven-plugin-2.2.0>`__
620
621 Version 8.1.1
622 -------------
623 This is a minor upgrade from version 8.1.0.
624
625 Improvements
626 ~~~~~~~~~~~~
627 * Support for building a `static Karaf distribution <https://karaf.apache.org/manual/latest/#_instances_and_distributions_goals>`__
628   has been added. It is driven by a new parent pom.xml, ``karaf-dist-static``. For more information
629   see Karaf documentation and `ODLPARENT-251 <https://jira.opendaylight.org/browse/ODLPARENT-251>`__.
630 * Support for `improved documentation tags <https://bugs.openjdk.java.net/browse/JDK-8068562>`__ has
631   been added to default ``maven-javadoc-plugin`` configuration. See
632   `ODLPARENT-252 <https://jira.opendaylight.org/browse/ODLPARENT-252>`__ for more information.
633 * Version declaration for ``osgi.annotation`` has been added.
634
635 Third-party dependencies
636 ~~~~~~~~~~~~~~~~~~~~~~~~
637 * commons-net `3.7.2 → 3.8.0 <https://commons.apache.org/proper/commons-net/changes-report.html#a3.8.0>`__
638
639 * Netty `4.1.58 → 4.1.59 <https://netty.io/news/2021/02/08/4-1-59-Final.html>`__
640
641 * Woodstox `6.2.3 → 6.2.4 <https://github.com/FasterXML/woodstox/milestone/21?closed=1>`__
642
643 Plugin upgrades
644 ~~~~~~~~~~~~~~~
645 * maven-checkstyle-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317223&version=12347024>`__
646
647 * maven-invoker-plugin `3.2.1 → 3.2.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317525&version=12346157>`__
648
649 Version 8.1.0
650 -------------
651 This is a minor upgrade from version 8.0.1, with some potentially-breaking
652 changes.
653
654 The most prominent is the upgrade to Karaf 4.3.0, which brings in a host of
655 updates to related components -- including OSGi Release 7 and Jackson 2.11.x.
656
657 Feature updates
658 ~~~~~~~~~~~~~~~
659 * The ``odl-jackson-2.10`` feature and artifact were renamed to ``odl-jackson-2.11``
660   to reflect the bump in Jackson version.
661
662 Third-party dependencies
663 ~~~~~~~~~~~~~~~~~~~~~~~~
664 * Bouncy Castle `1.66 → 1.68 <https://www.bouncycastle.org/releasenotes.html>`__
665
666 * Checkstyle 8.36.1 → 8.39.0, release notes:
667   * `8.36.2 <https://checkstyle.org/releasenotes.html#Release_8.36.2>`__
668   * `8.37.0 <https://checkstyle.org/releasenotes.html#Release_8.37.0>`__
669   * `8.38.0 <https://checkstyle.org/releasenotes.html#Release_8.38.0>`__
670   * `8.39.0 <https://checkstyle.org/releasenotes.html#Release_8.39.0>`__
671
672 * commons-net 3.7 → 3.7.2, release notes:
673   * `3.7.1 <https://commons.apache.org/proper/commons-net/changes-report.html#a3.7.1>`__
674   * `3.7.2 <https://commons.apache.org/proper/commons-net/changes-report.html#a3.7.2>`__
675
676 * enunciate `2.13.1 → 2.13.2 <https://github.com/stoicflame/enunciate/releases/tag/v2.13.2>`__
677
678 * Jackson 2.10.5 → 2.11.4, release notes:
679   * `2.11.0 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.11>`__
680   * `2.11.1 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.11.1>`__
681   * `2.11.2 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.11.2>`__
682   * `2.11.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.11.3>`__
683   * `2.11.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.11.4>`__
684
685 * Karaf `4.2.10 → 4.3.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12343304>`__
686
687 * Netty 4.1.53 → 4.1.58, release notes:
688   * `4.1.54 <https://netty.io/news/2020/11/11/4-1-54-Final.html>`__
689   * `4.1.55 <https://netty.io/news/2020/12/08/4-1-55-Final.html>`__
690   * `4.1.56 <https://netty.io/news/2020/12/17/4-1-56-Final.html>`__
691   * `4.1.57 <https://netty.io/news/2021/01/12/4-1-57-Final.html>`__
692   * `4.1.58 <https://netty.io/news/2021/01/13/4-1-58-Final.html>`__
693
694 * Google Truth `1.0.1 → 1.1 <https://github.com/google/truth/releases/tag/release_1_1>`__
695
696 * Powermock 2.0.7 → 2.0.9, release notes:
697   * `2.0.8 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#208>`__
698   * `2.0.9 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#209>`__
699
700 * Sevntu `1.37.1 → 1.38.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.38.0>`__
701
702 * XBean finder `4.17 → 4.18 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12348171>`__
703
704 * xmlunit 2.7.0 → 2.8.2, release notes:
705   * `2.8.0 <https://github.com/xmlunit/xmlunit/releases/tag/v2.8.0>`__
706   * `2.8.1 <https://github.com/xmlunit/xmlunit/releases/tag/v2.8.1>`__
707   * `2.8.2 <https://github.com/xmlunit/xmlunit/releases/tag/v2.8.2>`__
708
709 * Xtend `2.23.0 → 2.24.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2020/12/01/version-2-24-0>`__
710
711 Plugin upgrades
712 ~~~~~~~~~~~~~~~
713 * build-helper-maven-plugin `3.1.0 → 3.2.0 <https://github.com/mojohaus/build-helper-maven-plugin/issues?q=is%3Aissue+milestone%3A3.1.0+is%3Aclosed>`__
714
715 * duplicate-finder-maven-plugin `1.4.0 → 1.5.0 <https://github.com/basepom/duplicate-finder-maven-plugin/releases/tag/duplicate-finder-maven-plugin-1.5.0>`__
716
717 * exec-maven-plugin `1.6.0 → 3.0.0 <https://github.com/mojohaus/exec-maven-plugin/releases/tag/exec-maven-plugin-3.0.0>`__
718
719 * maven-pmd-plugin `3.13.0 → 3.14.0 <https://www.mail-archive.com/announce@maven.apache.org/msg00978.html>`__
720
721 * maven-resource-plugin `3.9.0 → 3.9.1 <https://www.mail-archive.com/announce@maven.apache.org/msg00972.html>`__
722
723 * maven-site-plugin `3.9.0 → 3.9.1 <https://www.mail-archive.com/announce@maven.apache.org/msg00966.html>`__
724
725 * versions-maven-plugin `2.7 → 2.8.1 <https://github.com/mojohaus/versions-maven-plugin/releases/tag/versions-maven-plugin-2.8.1>`__
726
727
728 Version 8.0.1
729 -------------
730 This is a minor big-fix/enhancement update from verision 8.0.0.
731
732 Improvements
733 ~~~~~~~~~~~~
734 * ``javax.inject`` is now provided by the artifact from `GuicedEE <https://guicedee.com/>`__.
735   This improves things a lot, as it is a proper jar (not MANIFEST.MF warning), it also is
736   a JPMS module, hence can be used for linkage. This dependency is properly ``scope=provided``,
737   so it should not leak into runtimes where it should not be.
738   See `ODLPARENT-247 <https://jira.opendaylight.org/browse/ODLPARENT-247>`__ for details.
739
740 * Transitive dependencies of Guava are now mostly filtered from runtime, so that we do not
741   require ``wrap`` for them. We still retain checker-qual, as we are actively using those
742   and it is a proper bundle.
743   See `ODLPARENT-248 <https://jira.opendaylight.org/browse/ODLPARENT-248>`__ for details.
744
745 Third-party dependencies
746 ~~~~~~~~~~~~~~~~~~~~~~~~
747 * Jackson `2.10.4 → 2.10.5 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.10.5>`__
748
749 * JaCoCo `0.8.5 → 0.8.6 <https://github.com/jacoco/jacoco/releases/tag/v0.8.6>`__
750
751 * JUnit `4.13.0 → 4.13.1 <https://github.com/junit-team/junit4/blob/HEAD/doc/ReleaseNotes4.13.1.md>`__
752
753 * Karaf `4.2.9 → 4.2.10 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12348288>`__
754
755 * Netty `4.1.52 → 4.1.53 <https://netty.io/news/2020/10/13/4-1-53-Final.html>`__
756
757 * Pax-Exam `4.13.3 → 4.13.4 <https://ops4j1.jira.com/secure/ReleaseNote.jspa?projectId=10170&version=24393>`__
758
759 * Woodstox 6.2.1 → 6.2.3, fixed issues:
760   * `6.2.2 <https://github.com/FasterXML/woodstox/issues/112>`__
761   * `6.2.3 <https://github.com/FasterXML/woodstox/issues/117>`__
762
763
764 Version 8.0.0
765 -------------
766 This is a major upgrade from version 7, with breaking changes; downstream projects may need to make changes to upgrade
767 to this version.
768
769 Improvements
770 ~~~~~~~~~~~~
771 * ``modernizer-maven-plugin`` configuration has been updated to issue warnings for constructs
772   improved in all Java versions up to and including Java 11.
773
774 * ``modernizer-maven-plugin`` is configured by default to fail the build when it issues any
775   warnings. This behavior can be opted-out of on a per-artifact basis by defining
776   ``odlparent.modernizer.enforce`` property to ``false``.
777
778 Upstream version removals
779 ~~~~~~~~~~~~~~~~~~~~~~~~~
780 The following upstream dependencies have been removed from dependency management:
781
782 * ``javax.json``. This dependency is used only in Neutron project, hence this version is best
783   maintained there. See `ODLPARENT-238 <https://jira.opendaylight.org/browse/ODLPARENT-238>`__
784   for details.
785
786 * All ``org.eclipse.persistence`` artifacts. These dependencies are only used in Neutron,
787   which actually duplicates the declarations, hence they are best maintained there.
788   See `ODLPARENT-237 <https://jira.opendaylight.org/browse/ODLPARENT-237>`__ for details.
789
790 * All ``org.apache.sshd`` and ``net.i2p.crypto`` artifacts. Overriding versions does not play
791   nice with Karaf's versions during ``feature:install``, causing issues when the installing
792   over an SSH connection. NETCONF project is providing a repackaged version in OpenDaylight
793   namespace. See `ODLPARENT-233 <https://jira.opendaylight.org/browse/ODLPARENT-233>`__ for
794   details.
795
796 * ``jettison``. This dependency is used only in LISP Flow Mapping project for integration
797   tests, hence this version is best maintained there.
798   See `ODLPARENT-239 <https://jira.opendaylight.org/browse/ODLPARENT-239>`__ for details.
799
800 * All ``com.typesafe``, ``io.aeron``, ``org.agrona``, ``org.scala-lang`` declarations. Akka is
801   removing their support for OSGi, with no working releases in their current ``2.6.x.`` branch.
802   Since dealing with these requires quite a bit of dance, which needs to sit outside of odlparent POM,
803   the controller project will package Akka to the extent it needs.
804   See `ODLPARENT-243 <https://jira.opendaylight.org/browse/ODLPARENT-243>`__ for details.
805
806 * ``org.apache.felix.dependencymanager`` and ``org.apache.felix.dependencymanager.shell``. These
807   components are ancient, having been replaced by either Blueprint or Declarative Services. The only
808   project using these is AAA, hence it is best to maintain these declarations there.
809
810 Feature removals
811 ~~~~~~~~~~~~~~~~
812 * ``odl-apache-sshd`` feature has been removed, mirroring the removal of related dependency
813   declarations. See `ODLPARENT-233 <https://jira.opendaylight.org/browse/ODLPARENT-233>`__ for details.
814
815 * ``odl-akka-all``, ``odl-akka-scala-2.13``, ``odl-akka-system-2.5``, ``odl-akka-clustering-2.5``
816   and ``odl-akka-persistence-2.5`` features. mirroring the removal of related dependency declarations.
817   See `ODLPARENT-243 <https://jira.opendaylight.org/browse/ODLPARENT-243>`__ for details.
818
819 Third-party dependencies
820 ~~~~~~~~~~~~~~~~~~~~~~~~
821 * awaitility `3.0.0 → 4.0.3 <https://github.com/awaitility/awaitility/wiki/ReleaseNotes40>`__
822
823 * checkstyle 8.34 → 8.36.1, release notes:
824   * `8.35 <https://checkstyle.org/releasenotes.html#Release_8.35>`__
825   * `8.36 <https://checkstyle.org/releasenotes.html#Release_8.36>`__
826   * `8.36.1 <https://checkstyle.org/releasenotes.html#Release_8.36.1>`__
827
828 * commons-codec `1.14 → 1.15 <https://commons.apache.org/proper/commons-codec/changes-report.html#a1.15>`__
829
830 * commons-io `2.7 → 2.8.0 <https://commons.apache.org/proper/commons-io/changes-report.html#a2.8.0>`__
831
832 * commons-net `3.6 → 3.7 <https://commons.apache.org/proper/commons-net/changes-report.html#a3.7>`__
833
834 * dropwizard-metrics 4.1.9 → 4.1.12.1, release notes:
835   * `4.1.10 <https://github.com/dropwizard/metrics/releases/tag/v4.1.10>`__
836   * `4.1.10.1 <https://github.com/dropwizard/metrics/releases/tag/v4.1.10.1>`__
837   * `4.1.11 <https://github.com/dropwizard/metrics/releases/tag/v4.1.11>`__
838   * `4.1.12 <https://github.com/dropwizard/metrics/releases/tag/v4.1.12>`__
839   * `4.1.12.1 <https://github.com/dropwizard/metrics/releases/tag/v4.1.12.1>`__
840
841 * Guava `28.2 → 29.0 <https://github.com/google/guava/releases/tag/v29.0>`__
842
843 * immutables.org → 2.8.8, release notes:
844   * `2.8.0 <https://github.com/immutables/immutables/releases/tag/2.8.0>`__
845   * `2.8.1 <https://github.com/immutables/immutables/releases/tag/2.8.1>`__
846   * `2.8.2 <https://github.com/immutables/immutables/releases/tag/2.8.2>`__
847   * `2.8.3 <https://github.com/immutables/immutables/releases/tag/2.8.3>`__
848   * `2.8.4 <https://github.com/immutables/immutables/releases/tag/2.8.4>`__
849   * `2.8.8 <https://github.com/immutables/immutables/releases/tag/2.8.8>`__
850
851 * mockito `3.3.3 → 3.5.11 <https://github.com/mockito/mockito/blob/release/3.x/doc/release-notes/official.md>`__
852
853 * Netty `4.1.51 → 4.1.52 <https://netty.io/news/2020/09/08/4-1-52-Final.html>`__
854
855 * Xtend `2.22.0 → 2.23.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2020/09/01/version-2-23-0>`__
856
857 Plugin upgrades
858 ~~~~~~~~~~~~~~~
859 * maven-archetype-plugin `3.1.2 → 3.2.0 <https://blogs.apache.org/maven/entry/apache-maven-archetype-plugin-version1>`__
860
861 * project-info-reports-plugin `3.1.0 → 3.1.1 <https://blogs.apache.org/maven/entry/apache-maven-project-info-reports1>`__
862
863 Version 7.0.5
864 -------------
865 This is a bug-fix upgrade from version 7.0.4.
866
867 Bug fixes
868 ~~~~~~~~~
869 * ``odl-netty-4`` feature definition specified both ``x86_64`` and ``aarch64`` artifacts
870   for ``netty-native-epoll``. This actually results only in ``aarch64`` package being
871   installed, rendering epoll unavailable on ``x86_64`` architecture. This has been corrected
872   by removing the ``aarch64`` package.
873   See `ODLPARENT-240 <https://jira.opendaylight.org/browse/ODLPARENT-240>`__ for details.
874
875 Version 7.0.4
876 -------------
877 This is a security/bug-fix upgrade from version 7.0.3.
878
879 Bug fixes
880 ~~~~~~~~~
881 * ``Single Feature Test`` setup of the JVM for Karaf container ended up using
882   wrong versions of Karaf components, leading to a failure to initialize
883   OSGiLocator and subsequent warnings with stack traces. This has now been
884   corrected.
885   See `ODLPARENT-228 <https://jira.opendaylight.org/browse/ODLPARENT-228>`__ for details.
886 * Pax-Exam setup interacts badly with pipes used by maven-surefire plugin,
887   leading to pauses lasting around 30 seconds after SFT test success.
888   This has now been worked around by using maven-surefire-plugin version 3.0.0-M5,
889   with TCP sockets used for communication.
890   See `ODLPARENT-179 <https://jira.opendaylight.org/browse/ODLPARENT-179>`__ for details.
891 * Our Jersey dependency was held back on version 2.25.1 during Neon upgrade cycle, mostly
892   due to large-scale incompatibilities around JAX-RS version. We have upgraded to Karaf-4.2.8+,
893   which pulls in JAX-RS 2.1, hence re-aligning to a more modern version, 2.27, is now
894   feasible.
895   See `ODLPARENT-208 <https://jira.opendaylight.org/browse/ODLPARENT-208>`__ for details.
896
897 Third-party dependencies
898 ~~~~~~~~~~~~~~~~~~~~~~~~
899 * Bouncy Castle `1.65 → 1.66 <https://www.bouncycastle.org/releasenotes.html>`__
900
901 * Checkstyle 8.32 → 8.34, release notes:
902   * `8.33 <https://checkstyle.org/releasenotes.html#Release_8.33>`__
903   * `8.34 <https://checkstyle.org/releasenotes.html#Release_8.34>`__
904
905 * commons-io `2.6 → 2.7 <https://commons.apache.org/proper/commons-io/changes-report.html#a2.7>`__
906
907 * Jersey 2.25.1 → 2.27, release notes:
908   * `2.26 <https://eclipse-ee4j.github.io/jersey.github.io/release-notes/2.26.html>`__
909   * `2.27 <https://eclipse-ee4j.github.io/jersey.github.io/release-notes/2.27.html>`__
910
911 * Karaf `4.2.8 → 4.2.9, with related upgrades <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345539>`__
912
913 * Netty 4.1.49 → 4.1.51, release notes:
914   * `4.1.50 <https://netty.io/news/2020/05/13/4-1-50-Final.html>`__
915   * `4.1.51 <https://netty.io/news/2020/07/09/4-1-51-Final.html>`__
916
917 * Scala `2.13.2 → 2.13.3 <https://github.com/scala/scala/releases/tag/v2.13.3>`__
918
919 * TrieMap `1.1.0 → 1.2.0 <https://github.com/PANTHEONtech/triemap/releases/tag/triemap-1.2.0>`__
920
921 * XBean finder 4.14 → 4.17, release notes:
922   * `4.15 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12345583>`__
923   * `4.16 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12345584>`__
924   * `4.17 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12346905>`__
925
926 Plugin upgrades
927 ~~~~~~~~~~~~~~~
928 * maven-project-info-reports-plugin `3.0.0 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317821&version=12346620>`__.
929
930 * maven-shade-plugin `3.2.3 → 3.2.4 <https://blogs.apache.org/maven/entry/apache-maven-shade-plugin-version5>`__
931
932 Version 7.0.3
933 -------------
934 This is a security/bug-fix upgrade from version 7.0.2. Changes in this release
935 pertain strictly to Karaf packaging and do not affect other runtimes.
936
937 Bug fixes
938 ~~~~~~~~~
939 * Felix SCR 2.1.16, as shipping before Karaf-4.2.9, contains a bug, which could
940   lead to NullPointerException being thrown when components were examined. This
941   has been rectified via upgrade to Felix SCR 2.1.20.
942   See `ODLPARENT-236 <https://jira.opendaylight.org/browse/ODLPARENT-236>`__ for details.
943 * Karaf-4.2.8 changed packaged log4j2 version, rendering the configuration supplied
944   with ``ODLPARENT-231`` inconsistent. This has led to a warning being printed in the
945   Karaf console on each startup. This has now been corrected.
946 * Karaf-4.2.8 is packaging pax-logging-1.11.4, which embeds a a vulnerable version
947   of log4j2 (2.3.0). This would render the upgrades delivered in version 7.0.2
948   ineffective at runtime, potentially leading to exposure. This has been corrected
949   with upgrade of pax-logging to 1.11.6, which is packaging log4j2-2.3.2.
950
951 Version 7.0.2
952 -------------
953 This is a security/bug-fix upgrade from version 7.0.1.
954
955 Improvements
956 ~~~~~~~~~~~~
957 * Infrastructure for identifying confidential log messages was added, along with
958   Karaf configuration update to routing such messages into a separate log file.
959   See `ODLPARENT-231 <https://jira.opendaylight.org/browse/ODLPARENT-231>`__ for details.
960
961 * Netty has been disconnected from Javassist way back in its 4.1.9 release, but
962   we failed to notice. This has now been rectified by ``odl-netty-4`` not depending
963   on ``odl-javassist-3``.
964
965 Third-party dependencies
966 ~~~~~~~~~~~~~~~~~~~~~~~~
967 * Checkstyle `8.31 → 8.32 <https://checkstyle.org/releasenotes.html#Release_8.32>`__
968
969 * Dropwizard Metrics 4.1.5 → 4.1.9, release notes:
970   * `4.1.6 <https://github.com/dropwizard/metrics/releases/tag/v4.1.6>`__
971   * `4.1.7 <https://github.com/dropwizard/metrics/releases/tag/v4.1.7>`__
972   * `4.1.8 <https://github.com/dropwizard/metrics/releases/tag/v4.1.8>`__
973   * `4.1.9 <https://github.com/dropwizard/metrics/releases/tag/v4.1.9>`__
974
975 * Enunciate 2.12.1 → 2.13.1, release notes:
976   * `2.13.0 <https://github.com/stoicflame/enunciate/releases/tag/v2.13.0>`__
977   * `2.13.1 <https://github.com/stoicflame/enunciate/releases/tag/v2.13.1>`__
978
979 * Jackson 2.10.2 → 2.10.4, release notes:
980   * `2.10.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.10.3>`__
981   * `2.10.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.10.4>`__
982
983 * log4j2 2.13.1 → 2.13.3, release notes:
984   * `2.13.2 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.2>`__
985   * `2.13.3 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.3>`__
986
987 * Netty `4.1.48 → 4.1.49 <https://netty.io/news/2020/02/28/4-1-46-Final.html>`__
988
989 * Powermock `2.0.6 → 2.0.7 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#207>`__
990
991 * Scala `2.13.1 → 2.13.2 <https://github.com/scala/scala/releases/tag/v2.13.2>`__
992
993 * Woodstox 6.1.1 → 6.2.1, release notes:
994   * `6.2.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-6.2#620-25-apr-2020>`__
995   * `6.2.1 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-6.2#621-13-may-2020>`__
996
997 * xmlunit 2.6.3 → 2.7.0, release notes:
998   * `2.6.4 <https://github.com/xmlunit/xmlunit/releases/tag/v2.6.4>`__
999   * `2.7.0 <https://github.com/xmlunit/xmlunit/releases/tag/v2.7.0>`__
1000
1001 Plugin upgrades
1002 ~~~~~~~~~~~~~~~
1003 * builder-helper-maven-plugin `3.0.0 → 3.1.0 <https://github.com/mojohaus/build-helper-maven-plugin/issues?q=is%3Aissue+milestone%3A3.1.0+is%3Aclosed>`__
1004
1005 * duplicate-finder-maven-plugin `1.3.0 → 1.4.0 <https://github.com/basepom/duplicate-finder-maven-plugin/releases/tag/duplicate-finder-maven-plugin-1.4.0>`__
1006
1007 * maven-antrun-plugin `1.8 → 3.0.0 <https://blogs.apache.org/maven/entry/apache-maven-antrun-plugin-version>`__
1008
1009 * maven-assembly-plugin `3.2.0 → 3.3.0 <https://blogs.apache.org/maven/entry/apache-maven-assembly-plugin-version1>`__
1010
1011 * maven-invoker-plugin `3.2.0 → 3.2.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317525&version=12344863>`__
1012
1013 * maven-remote-resources-plugin `1.6.0 → 1.7.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317825&version=12331232>`__
1014
1015 * maven-shade-plugin `3.2.2 → 3.2.3 <https://blogs.apache.org/maven/entry/apache-maven-shade-plugin-version4>`__
1016
1017 Version 7.0.1
1018 -------------
1019 This is a bug-fix upgrade from version 7.0.0.
1020
1021 Bug fixes
1022 ~~~~~~~~~
1023 * Upgrade of ``maven-javadoc-plugin`` is causing issues in downstream javadoc jobs and therefore it has been reverted.
1024   See `ODLPARENT-229 <https://jira.opendaylight.org/browse/ODLPARENT-229>`__ for details.
1025
1026 Third-party dependencies
1027 ~~~~~~~~~~~~~~~~~~~~~~~~
1028 * Akka `2.5.30 → 2.5.31 <https://akka.io/blog/news/2020/03/31/akka-2.5.31-released>`__
1029
1030 * Bouncy Castle `1.64 → 1.65 <https://www.bouncycastle.org/releasenotes.html>`__
1031
1032 * Checkstyle `8.30 → 8.31 <https://checkstyle.org/releasenotes.html#Release_8.31>`__
1033
1034 * commons-lang3 `3.9 → 3.10 <https://commons.apache.org/proper/commons-lang/changes-report.html#a3.10>`__
1035
1036 * Xtend 1.19.0 → 1.21.0, release notes:
1037   * `1.20.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/12/03/version-2-20-0>`__
1038   * `1.21.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2020/03/03/version-2-21-0>`__
1039
1040 Version 7.0.0
1041 -------------
1042 This is a major upgrade from version 6, with breaking changes; downstream projects may need to make changes to upgrade
1043 to this version.
1044
1045 Property removals
1046 ~~~~~~~~~~~~~~~~~
1047 * ``enforcer.version`` and ``projectinfo`` properties were removed. These properties do not serve any legal purpose as
1048   the plugins referenced by them are declared in ``pluginManagement`` section.
1049
1050 Upstream version removals
1051 ~~~~~~~~~~~~~~~~~~~~~~~~~
1052 The following upstream dependencies have been removed from dependency management:
1053
1054 * ``immutables.org/value`` without ``<classifier>annotations</classifier>``
1055
1056 * ``javax.xml.bind/jaxb-api``, replaced with ``jakarta.xml.bind/jakarta.xml.bind-api``
1057
1058 * ``com.google.inject/guice``
1059
1060 * ``com.mycila.guice.extensions/mycila-guice-jsr250``
1061
1062 * ``org.apache.shiro/shiro-core``
1063
1064 * ``org.apache.shiro/shiro-web``
1065
1066 Feature removals
1067 ~~~~~~~~~~~~~~~~
1068 * ``odl-akka-leveldb-0.10`` feature was removed. This feature provided leveldb-backed implementation of Akka
1069   Persistence, which is not supported for production environments by upstream. Furthermore this feature relied on a
1070   custom-built binary, which we do not have a means to reproduce -- limiting our portability. The controller project,
1071   which is the only downstream user of persistence provides an alternative implementation, hence we are removing this
1072   historical baggage. See `ODLPARENT-213 <https://jira.opendaylight.org/browse/ODLPARENT-213>`__ for details.
1073
1074 * ``odl-caffeine-2`` feature was removed. This feature provided a ``JSR-107 JCache`` implementation, an API deemed to
1075   be problematic where high-performance and correctness in required.
1076
1077 New features
1078 ~~~~~~~~~~~~
1079 * OSGi R6 Declarative Services enabled in Karaf. The ``scr`` feature is now part of startup features, hence Service
1080   Component Runtime can be used without incurring an additional refresh.
1081   See `ODLPARENT-227 <https://jira.opendaylight.org/browse/ODLPARENT-227>`__ for details.
1082
1083 Third-party dependencies
1084 ~~~~~~~~~~~~~~~~~~~~~~~~
1085 * Akka `2.5.29 → 2.5.30 <https://akka.io/blog/news/2020/03/12/akka-2.5.30-released>`__
1086
1087 * antl4r `4.7.2 → 4.8-1 <https://github.com/antlr/antlr4/releases/tag/4.8>`__
1088
1089 * Asciidoctor `1.5.7.1 → 1.5.8 <https://github.com/asciidoctor/asciidoctor/releases/tag/v1.5.8>`__
1090
1091 * Checkstyle 8.26 → 8.30, release notes:
1092   * `8.27 <https://checkstyle.org/releasenotes.html#Release_8.27>`__
1093   * `8.28 <https://checkstyle.org/releasenotes.html#Release_8.28>`__
1094   * `8.29 <https://checkstyle.org/releasenotes.html#Release_8.29>`__
1095   * `8.30 <https://checkstyle.org/releasenotes.html#Release_8.30>`__
1096
1097 * Dropwizard Metrics 4.0.5 → 4.1.5, release notes:
1098   * `4.1.0-rc0 <https://github.com/dropwizard/metrics/releases/tag/v4.1.0-rc0>`__
1099   * `4.1.0-rc2 <https://github.com/dropwizard/metrics/releases/tag/v4.1.0-rc2>`__
1100   * `4.1.0-rc3 <https://github.com/dropwizard/metrics/releases/tag/v4.1.0-rc3>`__
1101   * `4.1.1 <https://github.com/dropwizard/metrics/releases/tag/v4.1.1>`__
1102   * `4.1.2 <https://github.com/dropwizard/metrics/releases/tag/v4.1.2>`__
1103   * `4.1.3 <https://github.com/dropwizard/metrics/releases/tag/v4.1.3>`__
1104   * `4.1.4 <https://github.com/dropwizard/metrics/releases/tag/v4.1.4>`__
1105
1106 * Google Truth 0.43 → 1.0.1, release notes:
1107   * `0.44 <https://github.com/google/truth/releases/tag/release_0_44>`__
1108   * `0.45 <https://github.com/google/truth/releases/tag/release_0_45>`__
1109   * `0.46 <https://github.com/google/truth/releases/tag/release_0_46>`__
1110   * `1.0-rc1 <https://github.com/google/truth/releases/tag/release_1_0_rc1>`__
1111   * `1.0-rc2 <https://github.com/google/truth/releases/tag/release_1_0_rc2>`__
1112   * `1.0 <https://github.com/google/truth/releases/tag/release_1_0>`__
1113   * `1.0.1 <https://github.com/google/truth/releases/tag/release_1_0_1>`__
1114
1115 * Guava 27.1 → 28.2, release notes:
1116   * `28.0 <https://github.com/google/guava/releases/tag/v28.0>`__
1117   * `28.1 <https://github.com/google/guava/releases/tag/v28.1>`__
1118   * `28.2 <https://github.com/google/guava/releases/tag/v28.2>`__
1119
1120 * Javassist 3.26.0 → 3.27.0
1121
1122 * jdt-annotations 2.2.100 → 2.2.400
1123
1124 * Karaf 4.2.6 → 4.2.8, with related upgrades, release notes:
1125   * `4.2.7 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345539>`__
1126   * `4.2.8 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12346100>`__
1127
1128 * log4j2 `2.13.0 → 2.13.1 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.1>`__
1129
1130 * Netty 4.1.45 → 4.1.48, release notes:
1131   * `4.1.46 <https://netty.io/news/2020/02/28/4-1-46-Final.html>`__
1132   * `4.1.47 <https://netty.io/news/2020/03/09/4-1-47-Final.html>`__
1133   * `4.1.48 <https://netty.io/news/2020/03/17/4-1-48-Final.html>`__
1134
1135 * Powermock 2.0.4 → 2.0.6, release notes:
1136   * `2.0.5 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#205>`__
1137   * `2.0.6 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#206>`__
1138
1139 * Scala 2.12.10 → 2.13.1, release notes:
1140   * `2.13.0 <https://github.com/scala/scala/releases/tag/v2.13.0>`__
1141   * `2.13.1 <https://github.com/scala/scala/releases/tag/v2.13.1>`__
1142
1143 * scala-java8-compat 0.8.0 → 0.9.1, release notes:
1144   * `0.9.0 <https://github.com/scala/scala-java8-compat/releases/tag/v0.9.0>`__
1145   * `0.9.1 <https://github.com/scala/scala-java8-compat/releases/tag/v0.9.1>`__
1146
1147 * Sevntu 1.36.0 → 1.37.1, release notes:
1148   * `1.37.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.37.0>`__
1149   * `1.37.1 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.37.1>`__
1150
1151 * woodstox-core 5.3.0 → 6.1.1
1152
1153 Plugin upgrades
1154 ~~~~~~~~~~~~~~~
1155
1156 * findbugs-slf4j `1.4.0 → 1.5.0 <https://github.com/KengoTODA/findbugs-slf4j/blob/master/CHANGELOG.md#150---2019-07-04>`__
1157
1158 * maven-checkstyle-plugin `3.1.0 → 3.1.1 <https://blogs.apache.org/maven/entry/apache-maven-checkstyle-plugin-version1>`__
1159
1160 * maven-dependency-plugin `3.1.1 → 3.1.2 <https://blogs.apache.org/maven/entry/apache-maven-dependency-plugin-version2>`__
1161
1162 * maven-enforcer-plugin `3.0.0-M2 → 3.0.0-M3 <https://blogs.apache.org/maven/entry/apache-maven-enforcer-version-3>`__
1163
1164 * maven-javadoc-plugin `3.1.1 → 3.2.0 <https://blogs.apache.org/maven/entry/apache-maven-javadoc-plugin-version1>`__
1165
1166 * maven-shade-plugin `3.2.1 → 3.2.2 <https://blogs.apache.org/maven/entry/apache-maven-shade-plugin-version3>`__
1167
1168 * modernizer-maven-plugin `2.0.0 → 2.1.0 <https://github.com/gaul/modernizer-maven-plugin/releases/tag/modernizer-maven-plugin-2.1.0>`__
1169
1170 * pmd-maven-plugin `3.12.0 → 3.13.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-version2>`__
1171
1172 Version 6.0.5
1173 -------------
1174 This is a bug-fix upgrade from version 6.0.4.
1175
1176 Third-party dependencies
1177 ~~~~~~~~~~~~~~~~~~~~~~~~
1178 * Akka 2.5.26 → 2.5.29, release notes:
1179   * `2.5.27 <https://akka.io/blog/news/2019/12/10/akka-2.5.27-released>`__
1180   * `2.5.29 <https://akka.io/blog/news/2020/01/28/akka-2.5.29-released>`__
1181
1182 * commons-codec `1.13 → 1.14 <https://commons.apache.org/proper/commons-codec/changes-report.html#a1.14>`__
1183
1184 * Jackson `2.9.10 → 2.9.10.20200103 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9#micro-patches>`__
1185
1186 Plugin upgrades
1187 ~~~~~~~~~~~~~~~
1188 * maven-source-plugin `3.2.0 → 3.2.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12346480>`__
1189
1190 Version 6.0.4
1191 -------------
1192 This is a bug-fix upgrade from version 6.0.3.
1193
1194 Bug fixes
1195 ~~~~~~~~~
1196 * ``single-feature-test`` was using outdated repositories, including Maven Central,
1197   which `broke on Jan 15, 2020 <https://support.sonatype.com/hc/en-us/articles/360041287334-Central-501-HTTPS-Required>`__.
1198   This has been corrected.
1199
1200 Third-party dependencies
1201 ~~~~~~~~~~~~~~~~~~~~~~~~
1202
1203 * JUnit 4.11 → 4.13, release notes:
1204   * `4.12 <https://github.com/junit-team/junit4/blob/master/doc/ReleaseNotes4.12.md>`__
1205   * `4.13 <https://github.com/junit-team/junit4/blob/master/doc/ReleaseNotes4.13.md>`__
1206
1207 * log4j2 2.11.2 → 2.13.0, release notes:
1208   * `2.12.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.0>`__
1209   * `2.12.1 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.12.1>`__
1210   * `2.13.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.0>`__
1211
1212 * netty 4.1.42 → 4.1.45, release notes:
1213   * `4.1.43 <https://netty.io/news/2019/10/24/4-1-43-Final.html>`__
1214   * `4.1.44 <https://netty.io/news/2019/12/18/4-1-44-Final.html>`__
1215   * `4.1.45 <https://netty.io/news/2020/01/13/4-1-45-Final.html>`__
1216
1217 Plugin upgrades
1218 ~~~~~~~~~~~~~~~
1219 * maven-assembly-plugin 2.2-beta5 → 3.2.0
1220
1221 * maven-archetype-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12345957>`__
1222
1223 Version 6.0.3
1224 -------------
1225 This is a bug-fix upgrade from version 6.0.2.
1226
1227 Bug fixes
1228 ~~~~~~~~~
1229 * The fix for `ODLPARENT-216 <https://jira.opendaylight.org/browse/ODLPARENT-216>`__ ended up
1230   breaking ``org.kohsuke.metainf-services`` integration. While this could be fixed in downstreams
1231   by adding proper </annotationProcessorPaths> entry, it is a regression from 6.0.1.
1232
1233 Version 6.0.2
1234 -------------
1235 This is a security/bug-fix upgrade from version 6.0.1.
1236
1237 Bug fixes
1238 ~~~~~~~~~
1239 * ``single-feature-parent`` was setting up Karaf repositories incorrectly, leading to
1240   the test using unpatched Karaf resources. This has now been fixed and the test run
1241   is using environment equivalent to the contents of the distribution. See
1242   `ODLPARENT-209 <https://jira.opendaylight.org/browse/ODLPARENT-209>`__ for details.
1243
1244 * ``immutables.org`` integration relied on pre-JDK9 way of integration, where the annotation processor
1245   was just dropped as a dependency. This does not work with JDK9+ artifacts which are also explicit
1246   JMPS modules. Note that users are advised to switch to depending on the ``annotations``-classified
1247   artifact. See `ODLPARENT-216 <https://jira.opendaylight.org/browse/ODLPARENT-216>`__ for details.
1248
1249 * Assembled Karaf distribution did not perform proper JDK checks and allowed launching with JDK8,
1250   leading to a failure to install OpenDaylight components with an error stack, which confuses users
1251   not familiar with OSGi. The distribution now refuses to start with anything other than JDK11. See
1252   `ODLPARENT-218 <https://jira.opendaylight.org/browse/ODLPARENT-218>`__ for details.
1253
1254 Third-party dependencies
1255 ~~~~~~~~~~~~~~~~~~~~~~~~
1256
1257 * Akka `2.5.25 → 2.5.26 <https://akka.io/blog/news/2019/10/17/akka-2.5.26-released>`__
1258
1259 * Checkstyle 8.20 → 8.26, release notes:
1260   * `8.21 <https://checkstyle.org/releasenotes.html#Release_8.21>`__
1261   * `8.22 <https://checkstyle.org/releasenotes.html#Release_8.22>`__
1262   * `8.23 <https://checkstyle.org/releasenotes.html#Release_8.23>`__
1263   * `8.24 <https://checkstyle.org/releasenotes.html#Release_8.24>`__
1264   * `8.25 <https://checkstyle.org/releasenotes.html#Release_8.25>`__
1265   * `8.26 <https://checkstyle.org/releasenotes.html#Release_8.26>`__
1266
1267 * H2 database `1.4.199 → 1.4.200 <http://www.h2database.com/html/changelog.html>`__
1268
1269 * Hamcrest `2.1 → 2.2 <https://github.com/hamcrest/JavaHamcrest/releases/tag/v2.2>`__
1270
1271 * JaCoCo `0.8.4 → 0.8.5 <https://github.com/jacoco/jacoco/releases/tag/v0.8.5>`__
1272
1273 * Karaf 4.2.2 → 4.2.6, release notes:
1274   * `4.2.3 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12344587>`__
1275   * `4.2.4 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12344856>`__
1276   * `4.2.5 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345153>`__
1277   * `4.2.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345365>`__
1278
1279 * Powermock `2.0.2 → 2.0.4 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#204>`__
1280
1281 * Sevntu `1.35.0 → 1.36.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.36.0>`__
1282
1283 Plugin upgrades
1284 ~~~~~~~~~~~~~~~
1285
1286 * maven-bundle-plugin `4.1.0 → 4.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12345491>`__
1287
1288 * maven-jar-plugin `3.1.2 → 3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12345503>`__
1289
1290 * maven-source-plugin `3.1.0 → 3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12345522>`__
1291
1292 * modernizer-maven-plugin `1.9.0 → 2.0.0 <https://github.com/gaul/modernizer-maven-plugin/releases/tag/modernizer-maven-plugin-2.0.0>`__
1293
1294 Version 6.0.1
1295 -------------
1296 This is a security/bug-fix upgrade from version 6.0.0.
1297
1298 Bug fixes
1299 ~~~~~~~~~
1300 * ``karaf-plugin`` ignored exceptions coming from its failure to resolve ${karaf.etc} variable. This
1301   has now been fixed and the URL handling has been revised to fix build on Windows. See
1302   `ODLPARENT-214 <https://jira.opendaylight.org/browse/ODLPARENT-214>`__ for details.
1303
1304 * ``leveldb-jni`` jar, which has been seeded to nexus.opendaylight.org long time ago is not published
1305   in Maven Central. This has been resolved by repackaging this jar and publishing it from odlparent.
1306   See `ODLPARENT-210 <https://jira.opendaylight.org/browse/ODLPARENT-210>`__ for details.
1307
1308 Third-party dependencies
1309 ~~~~~~~~~~~~~~~~~~~~~~~~
1310
1311 * Bouncy Castle `1.63 → 1.64 <http://www.bouncycastle.org/releasenotes.html>`__
1312
1313 * Jackson `2.9.9 → 2.9.10 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.10>`__
1314
1315 * Javassist 3.24.1-GA → 3.26.0-GA
1316
1317 * Guice 4.1.0 → 4.2.2, release notes:
1318   * `4.2.0 <https://github.com/google/guice/wiki/Guice42>`__
1319   * `4.2.1 <https://github.com/google/guice/wiki/Guice421>`__
1320   * `4.2.2 <https://github.com/google/guice/wiki/Guice422>`__
1321
1322 * Mockito 2.25.1 → 2.28.2, release notes:
1323   * `2.25.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2252>`__
1324   * `2.25.3 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2253>`__
1325   * `2.25.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2254>`__
1326   * `2.25.5 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2255>`__
1327   * `2.25.6 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2256>`__
1328   * `2.25.7 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2257>`__
1329   * `2.26.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2261>`__
1330   * `2.26.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2262>`__
1331   * `2.27.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2271>`__
1332   * `2.27.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2272>`__
1333   * `2.27.3 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2273>`__
1334   * `2.27.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2274>`__
1335   * `2.27.5 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2275>`__
1336   * `2.28.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2280>`__
1337
1338 * Netty 4.1.39 → 4.1.42, release notes:
1339   * `4.1.41 <https://netty.io/news/2019/09/12/4-1-41-Final.html>`__
1340   * `4.1.42 <https://netty.io/news/2019/09/25/4-1-42-Final.html>`__
1341
1342 * pt-triemap `1.0.6 → 1.1.0 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.1.0>`__
1343
1344 * reactive-streams `1.0.2 → 1.0.3 <http://www.reactive-streams.org/announce-1.0.3>`__
1345
1346 * stax2-api `3.1.4 → 4.2 <https://github.com/FasterXML/stax2-api/blob/master/release-notes/VERSION>`__
1347
1348 * woodstox-core 5.0.3 → 5.3.0, release notes:
1349   * `5.1.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.1>`__
1350   * `5.2.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.2>`__
1351   * `5.3.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.3>`__
1352
1353 Version 6.0.0
1354 -------------
1355 This is a major upgrade from version 5, with breaking changes; projects will
1356 need to make changes to upgrade to this version.
1357
1358 Java 11 is required
1359 ~~~~~~~~~~~~~~~~~~~
1360 This release sets ``maven.compiler.release=11`` and enforces that the JDK used to build
1361 is Java 11+. As there may be issues with various maven plugins when faced with JDK9+
1362 constructs and JDK11+ classes, target release can be controlled on a per-artifact
1363 basis (i.e. target Java 10 with ``maven.compiler.release=10`` property).
1364
1365 This release has been validated with ``openjdk-11.0.4`` and is not supported on any lower
1366 version. As usual, we recommend using latest available JDK/JRE for Java 11 during development
1367 and deployment.
1368
1369 Checkstyle/SpotBugs/Modernizer run by default
1370 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1371 With this release code artifacts always run ``maven-checkstyle-plugin``, ``spotbugs-maven-plugin``
1372 and ``modernizer-maven-plugin``. Checkstyle and SpotBugs run in enforcing mode, i.e. will fail
1373 build if any violations are found. Modernizer is configured to report Java 8-compatible constructs
1374 and will not fail the build unless instructed to do so.
1375
1376 Behavior of each of these is controlled via a maven property on a per-artifact basis:
1377
1378 * ``odlparent.checkstyle.enforce`` controls checkstyle enforcement: defaults to ``true``, but can be set to ``false``
1379 * ``odlparent.checkstyle.skip`` controls checkstyle invocation: defaults to ``false``, but can be set to ``true``
1380 * ``odlparent.spotbugs.enforce`` controls SpotBugs enforcement: defaults to ``true``, but can be set to ``false``
1381 * ``odlparent.spotbugs.skip`` controls SpotBugs invocation: defaults to ``false``, but can be set to ``true``
1382 * ``odlparent.modernizer.enforce`` controls modernizer enforcement: defaults to ``false``, but can be set to ``true``
1383 * ``odlparent.modernizer.skip`` controls modernizer invocation: defaults to ``false``, but can be set to ``true``
1384 * ``odlparent.modernizer.target`` controls modernizer Java version: defaults to ``1.8``, but can be set to ``1.11`` or similar
1385
1386 Bug fixes
1387 ~~~~~~~~~
1388
1389 * ``blueprint container`` had ``org.apache.aries.blueprint.preemptiveShutdown`` set to false
1390   to enable it to work with Config Subsystem. As that component is long gone, this property has
1391   been removed as part of `ODLPARENT-34 <https://jira.opendaylight.org/browse/ODLPARENT-34>`__.
1392   Furthermore, system properties related to Config Subsystem/NETCONF integration have been removed
1393   as well.
1394
1395 Upstream version removals
1396 ~~~~~~~~~~~~~~~~~~~~~~~~~
1397
1398 The following upstream dependencies have been removed from dependency management:
1399
1400 * com.google.code.findbugs/jsr305
1401
1402 Third-party dependencies
1403 ~~~~~~~~~~~~~~~~~~~~~~~~
1404
1405 The dependency on `xmlunit-assertj` and `modernizer-maven-annotations` has been added and the following
1406 dependencies have been upgraded:
1407
1408 * Akka 2.5.23 → 2.5.25, release notes:
1409   * `2.5.24 <https://akka.io/blog/news/2019/08/09/akka-2.5.24-released>`__
1410   * `2.5.25 <https://akka.io/blog/news/2019/08/20/akka-2.5.25-released>`__
1411
1412 * apache-sshd `2.2.0 → 2.3.0 <https://github.com/apache/mina-sshd/blob/master/docs/changes/2.3.0.md>`__
1413
1414 * Bouncy Castle `1.62 → 1.63 <https://www.bouncycastle.org/releasenotes.html>`__
1415
1416 * commons-beanutils `1.9.3 → 1.9.4 <https://www.apache.org/dist/commons/beanutils/RELEASE-NOTES.txt>`__
1417
1418 * commons-codec `1.12 → 1.13 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
1419
1420 * commons-text 1.6 → 1.8, release notes:
1421   * `1.7 <https://commons.apache.org/proper/commons-text/changes-report.html#a1.7>`__
1422   * `1.8 <https://commons.apache.org/proper/commons-text/changes-report.html#a1.8>`__
1423
1424 * Checkstyle 8.18 → 8.20, release notes:
1425   * `8.19 <https://checkstyle.org/releasenotes.html#Release_8.19>`__
1426   * `8.20 <https://checkstyle.org/releasenotes.html#Release_8.20>`__
1427
1428 * jackson-databind `2.9.9 → 2.9.9.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9#micro-patches>`__
1429
1430 * jaxb-api 2.2.8 → 2.3.0, aligning it with Karaf-provided version
1431
1432 * Netty 4.1.36 → 4.1.39, release notes:
1433   * `4.1.37 <https://netty.io/news/2019/06/28/4-1-37-Final.html>`__
1434   * `4.1.38 <https://netty.io/news/2019/07/24/4-1-38-Final.html>`__
1435   * `4.1.39 <https://netty.io/news/2019/08/13/4-1-39-Final.html>`__
1436
1437 * Sevntu 1.32.0 → 1.35.0, release notes:
1438   * `1.33.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
1439   * `1.34.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.34.0>`__
1440   * `1.34.1 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.34.1>`__
1441   * `1.35.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.35.0>`__
1442
1443 * Scala 2.12.8 → 2.12.9, release notes:
1444   * `2.12.9 <https://github.com/scala/scala/releases/tag/v2.12.9>`__
1445   * `2.12.10 <https://github.com/scala/scala/releases/tag/v2.12.10>`__
1446
1447 * slf4j `1.7.25 → 1.7.28 <https://www.slf4j.org/news.html>`__
1448
1449 * triemap `1.0.5 → 1.0.6 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.0.6>`__
1450
1451 * typesafe/ssl-config `0.3.7 → 0.3.8 <https://github.com/lightbend/ssl-config/compare/v0.3.7...v0.3.8>`__
1452
1453 * Xtend 1.17.1 → 1.19.0, release notes:
1454   * `1.18.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/06/04/version-2-18-0>`__
1455   * `1.19.0 <https://www.eclipse.org/Xtext/releasenotes.html#/releasenotes/2019/09/03/version-2-19-0>`__
1456
1457 Plugin upgrades
1458 ~~~~~~~~~~~~~~~
1459
1460 * git-commit-id-plugin 2.2.6 → 3.0.1, release notes:
1461   * `3.0.0 <https://github.com/git-commit-id/maven-git-commit-id-plugin/releases/tag/v3.0.0>`__
1462   * `3.0.1 <https://github.com/git-commit-id/maven-git-commit-id-plugin/releases/tag/v3.0.1>`__
1463
1464 * maven-javadoc-plugin `3.1.0 → 3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12345060>`__
1465
1466 * pmd-maven-plugin `3.11.0 → 3.12.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-version1>`__
1467
1468 * spotbugs-maven-plugin 3.1.11  → 3.1.12.2, release notes:
1469   * `3.1.12 <https://github.com/spotbugs/spotbugs-maven-plugin/compare/spotbugs-maven-plugin-3.1.11...spotbugs-maven-plugin-3.1.12>`__
1470   * `3.1.12.1 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-3.1.12.1>`__
1471   * `3.1.12.2 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-3.1.12.2>`__
1472
1473 Version 5.0.1
1474 -------------
1475
1476 This is a bug-fix upgrade from version 5.0.0.
1477
1478 Third-party dependencies
1479 ~~~~~~~~~~~~~~~~~~~~~~~~
1480
1481 The following dependencies have been upgraded:
1482
1483 * Akka 2.5.21 → 2.5.23, release notes:
1484   * `2.5.22 <https://akka.io/blog/news/2019/04/03/akka-2.5.22-released>`__
1485   * `2.5.23 <https://akka.io/blog/news/2019/05/21/akka-2.5.23-released>`__
1486
1487 * asciidoctorj-diagram 1.5.12 → 1.5.16
1488
1489 * Bouncy Castle `1.61 → 1.62 <http://www.bouncycastle.org/releasenotes.html>`__
1490
1491 * commons-lang3 `3.8.1 → 3.9 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__
1492
1493 * JaCoCo `0.8.3 → 0.8.4 <https://github.com/jacoco/jacoco/releases/tag/v0.8.4>`__
1494
1495 * Jackson `2.9.8 → 2.9.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.9>`__
1496
1497 * Jolokia 1.6.0 → 1.6.2, release notes:
1498   * `1.6.1 <https://jolokia.org/changes-report.html#a1.6.1>`__
1499   * `1.6.2 <https://jolokia.org/changes-report.html#a1.6.2>`__
1500
1501 * Mockito `2.25.0 → 2.25.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2251>`__
1502
1503 * Netty 4.1.34 → 4.1.36, release notes:
1504   * `4.1.35 <https://netty.io/news/2019/04/17/4-1-35-Final.html>`__
1505   * `4.1.36 <https://netty.io/news/2019/04/30/4-1-36-Final.html>`__
1506
1507 * PowerMock 2.0.0 → 2.0.2, release notes:
1508   * `2.0.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.1>`__
1509   * `2.0.2 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.2>`__
1510
1511 * Reactive Streams `1.0.1 → 1.0.2 <https://www.lightbend.com/blog/update-reactive-streams-102-released>`__
1512
1513 * scala-parser-combinators `1.1.1 → 1.1.2 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.2>`__
1514
1515 * Sevntu `1.32.0 → 1.33.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
1516
1517 * Typesafe Config `1.3.2 → 1.3.3 <https://github.com/lightbend/config/releases/tag/v1.3.3>`__
1518
1519 * triemap `1.0.4 → 1.0.5 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.0.5>`__
1520
1521 * XBean finder 4.12 → 4.14, release notes:
1522   * `4.13 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12344253&projectId=12310312>`__
1523   * `4.14 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12345220>`__
1524
1525 * xmlunit `2.6.2 → 2.6.3 <https://github.com/xmlunit/xmlunit/releases/tag/v2.6.3>`__
1526
1527 * Xtend `2.17.0 → 2.17.1 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/04/03/version-2-17-1>`__
1528
1529 Plugin upgrades
1530 ~~~~~~~~~~~~~~~
1531
1532 * maven-archetype-plugin 3.0.1 → 3.1.1, release notes:
1533   * `3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12340346>`__
1534   * `3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12345450>`__
1535
1536 * maven-bundle-plugin `4.1.0 → 4.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12345047>`__
1537
1538 * maven-checkstyle-plugin `3.1.0 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317223&version=12342397>`__
1539
1540 * maven-compiler-plugin `3.8.0 → 3.8.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317225&version=12343484>`__
1541
1542 * maven-help-plugin `3.1.1 → 3.2.0 <https://blog.soebes.de/blog/2019/04/22/apache-maven-help-plugin-version-3-dot-2-0-released/>`__
1543
1544 * maven-jar-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12344629>`__
1545
1546 * maven-plugin-plugin `3.5.2 → 3.6.0 <https://blogs.apache.org/maven/entry/apache-maven-plugin-tools-version1>`__
1547
1548 * maven-source-plugin `3.0.1 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12336941>`__
1549
1550 * maven-surefire-plugin 2.22.1 → 2.22.2
1551
1552 New plugins
1553 ~~~~~~~~~~~
1554
1555 * ``modernizer-maven-plugin`` declared, allowing downstreams to more easily activate it,
1556   and so detect code which should be updated to more modern equivalent.
1557
1558 New features
1559 ~~~~~~~~~~~~
1560
1561 * ``odl-caffeine-2`` provides a pre-packaged feature for the Caffeine caching framework,
1562   along with the Guava compabitility layer.
1563
1564 Version 5.0.0
1565 -------------
1566
1567 This is a major upgrade from version 4, with breaking changes; projects will
1568 need to make changes to upgrade to this version.
1569
1570 The most significant change is `ODLPARENT-198 <https://jira.opendaylight.org/browse/ODLPARENT-198>`__,
1571 which removes JSR305 from default dependencies and does not present it at class path by default.
1572
1573 Deleted artifacts
1574 ~~~~~~~~~~~~~~~~~
1575
1576 ``findbugs`` has been removed, as its only purpose was to provide FindBugs
1577 rule definitions. Equivalent definitions are available in ``spotbugs``.
1578
1579 Bug fixes
1580 ~~~~~~~~~
1581
1582 * ``blueprint-maven-plugin`` used to scan the entire classpath, resulting in potential conflicts
1583   across projects. Scanning is now limited to ``${project.groupId}``, limiting conflict domain
1584   to single project. See `ODLPARENT-109 <https://jira.opendaylight.org/browse/ODLPARENT-109>`__.
1585
1586 * ``bundle-maven-plugin`` configuration ignored generated ServiceLoader service entries,
1587   which has now been fixed. See `ODLPARENT-197 <https://jira.opendaylight.org/browse/ODLPARENT-197>`__.
1588
1589 * Bundle tests are now enabled by default. See `ODLPARENT-158 <https://jira.opendaylight.org/browse/ODLPARENT-158>`__
1590   and `ODLPARENT-80 <https://jira.opendaylight.org/browse/ODLPARENT-80>`__ for details.
1591
1592 * Karaf log file rollover was not explictly set up, leading to inability to easily override
1593   the defaults. See `ODLPARENT-153 <https://jira.opendaylight.org/browse/ODLPARENT-153>`__ for details.
1594
1595 * Karaf log file used to use default maximum 16MiB file size, this has now been increased to 64MiB.
1596   See `ODLPARENT-154 <https://jira.opendaylight.org/browse/ODLPARENT-154>`__.
1597
1598 * ``features-test`` excluded opendaylight-karaf-empty's transitive dependencies, leading
1599   to the need to re-declare them in single-feature-parent. This re-declaration was forgotten
1600   in for ``bcpkix-framework-ext`` and ``bcprov-framework-ext`` bundles, which lead to them
1601   not being present in the local repository. See `ODLPARENT-130 <https://jira.opendaylight.org/browse/ODLPARENT-130>`__.
1602
1603 Upstream version removals
1604 ~~~~~~~~~~~~~~~~~~~~~~~~~
1605
1606 The following upstream dependencies have been removed from dependency management:
1607
1608 * cassandra-driver-core
1609
1610 * org.codehaus.enunciate/enunciate-core-annotations
1611
1612 * org.jboss.resteasy/jaxrs-api
1613
1614 * org.json/json
1615
1616 * org.osgi/org.osgi.compendium
1617
1618 Removed features
1619 ~~~~~~~~~~~~~~~~
1620
1621 * odl-jersey-1
1622
1623 * ``features-akka`` feature repository has been integrated into ``features-odlparent``
1624
1625 Third-party dependencies
1626 ~~~~~~~~~~~~~~~~~~~~~~~~
1627
1628 The following dependencies have been upgraded:
1629
1630 * apache-sshd `2.0.0 → 2.2.0 <https://github.com/apache/mina-sshd/compare/sshd-2.0.0...sshd-2.2.0>`__
1631
1632 * Aeron 1.12.0 → 1.15.3, release notes:
1633   * `1.13.0 <https://github.com/real-logic/aeron/releases/tag/1.13.0>`__
1634   * `1.14.0 <https://github.com/real-logic/aeron/releases/tag/1.14.0>`__
1635   * `1.15.0 <https://github.com/real-logic/aeron/releases/tag/1.15.0>`__
1636   * `1.15.1 <https://github.com/real-logic/aeron/releases/tag/1.15.1>`__
1637   * `1.15.2 <https://github.com/real-logic/aeron/releases/tag/1.15.2>`__
1638   * `1.15.3 <https://github.com/real-logic/aeron/releases/tag/1.15.3>`__
1639
1640 * Agrona 0.9.27 → 0.9.33, release notes:
1641   * `0.9.28 <https://github.com/real-logic/agrona/releases/tag/0.9.28>`__
1642   * `0.9.29 <https://github.com/real-logic/agrona/releases/tag/0.9.29>`__
1643   * `0.9.30 <https://github.com/real-logic/agrona/releases/tag/0.9.30>`__
1644   * `0.9.31 <https://github.com/real-logic/agrona/releases/tag/0.9.31>`__
1645   * `0.9.32 <https://github.com/real-logic/agrona/releases/tag/0.9.32>`__
1646   * `0.9.33 <https://github.com/real-logic/agrona/releases/tag/0.9.33>`__
1647
1648 * Akka 2.5.19 → 2.5.21, release notes:
1649   * `2.5.20 <https://akka.io/blog/news/2019/01/29/akka-2.5.20-released>`__
1650   * `2.5.21 <https://akka.io/blog/news/2019/02/13/akka-2.5.21-released>`__
1651
1652 * antl4r `4.7.1 → 4.7.2 <https://github.com/antlr/antlr4/releases/tag/4.7.2>`__
1653
1654 * asciidoctorj-diagram 1.5.11 → 1.5.12
1655
1656 * Bouncy Castle `1.60 → 1.61 <http://www.bouncycastle.org/releasenotes.html>`__
1657
1658 * checkstyle 8.16 → 8.18, release notes:
1659   * `8.17 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.17>`__
1660   * `8.18 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.18>`__
1661
1662 * commons-codec `1.11 → 1.12 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
1663
1664 * Google Error Prone 2.3.2 → 2.3.3
1665
1666 * Google Guava 25.1 → 27.1, release notes:
1667   * `26.0 <https://github.com/google/guava/releases/tag/v26.0>`__
1668   * `27.0 <https://github.com/google/guava/releases/tag/v27.0>`__
1669   * `27.0.1 <https://github.com/google/guava/releases/tag/v27.0.1>`__
1670   * `27.1 <https://github.com/google/guava/releases/tag/v27.1>`__
1671
1672 * Google Truth `0.42 → 0.43 <https://github.com/google/truth/releases/tag/release_0_43>`__
1673
1674 * h2 database `1.4.196 → 1.4.199 <http://www.h2database.com/html/changelog.html>`__
1675
1676 * Immutables `2.7.3 → 2.7.5 <https://github.com/immutables/immutables/#changelog>`__
1677
1678 * Javassist `3.24.0-GA → 3.24.1-GA <https://github.com/jboss-javassist/javassist/releases/tag/rel_3_24_1_ga>`__
1679
1680 * log4j2 `2.11.1 → 2.11.2 <https://github.com/apache/logging-log4j2/blob/log4j-2.11.2/RELEASE-NOTES.md>`__
1681
1682 * Mockito 2.23.4 → 2.25.0, release notes:
1683   * `2.24.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2240>`__
1684   * `2.25.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2250>`__
1685
1686 * Netty 4.1.32 → 4.1.34, release notes:
1687   * `4.1.32 <https://netty.io/news/2018/11/29/4-1-32-Final.html>`__
1688   * `4.1.33 <https://netty.io/news/2019/01/21/4-1-33-Final.html>`__
1689   * `4.1.34 <https://netty.io/news/2019/03/08/4-1-34-Final.html>`__
1690
1691 * OSGi 5.0.0 → 6.0.0
1692
1693 * Powermockito 1.7.4 → 2.0.0, release notes:
1694   * `2.0.0-beta.5 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-beta.5>`__
1695   * `2.0.0-RC.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-RC.1>`__
1696   * `2.0.0 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0>`__
1697
1698 * SpotBugs `3.1.9 → 3.1.12 <https://github.com/spotbugs/spotbugs/blob/3.1.12/CHANGELOG.md>`__
1699
1700 * ThreeTen `1.4.0 → 1.5.0 <https://www.threeten.org/threeten-extra/changes-report.html#a1.5.0>`__
1701
1702 * Xtend `2.16.0 → 2.17.0 <http://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/03/05/version-2-17-0>`__
1703
1704 Plugin removals
1705 ~~~~~~~~~~~~~~~
1706
1707 * gmaven-plugin
1708
1709 * maven-findbugs-plugin
1710
1711 Plugin upgrades
1712 ~~~~~~~~~~~~~~~
1713
1714 * jacoco-maven-plugin `0.8.2 → 0.8.3 <https://github.com/jacoco/jacoco/releases/tag/v0.8.3>`__
1715
1716 * maven-invoker-plugin `3.1.0 → 3.2.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201901.mbox/%3Cop.zvzdg9tbkdkhrr@desktop-2khsk44%3E>`__
1717
1718 * maven-javadoc-plugin `3.0.1 → 3.1.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201903.mbox/%3C6064d830-474c-4b43-afef-99502c3a305a%40getmailbird.com%3E>`__
1719
1720 * spotbugs-maven-plugin 3.1.8 → 3.1.11
1721
1722 Version 4.0.9
1723 -------------
1724
1725 This is a bug-fix upgrade from version 4.0.8.
1726
1727 Bug fixes
1728 ~~~~~~~~~
1729
1730 * ``karaf-plugin`` invocation in ``karaf4-parent`` caused previously
1731   patched features to be overwritten with their stock versions, referencing
1732   bundles which were not populated in the local repository. (See
1733   `ODLPARENT-194 <https://jira.opendaylight.org/browse/ODLPARENT-194>`__.)
1734
1735 * ``karaf-plugin`` version in ``karaf4-parent`` is now provided through
1736   plugin management so downstreams can override it without needing
1737   to repeat its configuration.
1738
1739 * ``karaf-plugin`` no longer reads features twice when running discovery,
1740   speeding up the process a bit.
1741
1742 * Recent versions of the SpotBugs Maven plugin use SLF4J 1.8 beta 2, which
1743   can’t use the 1.7.25 implementation we provide; we therefore provide an
1744   implementation of 1.8 beta 2 when SpotBugs is used. (See
1745   `ODLPARENT-184 <https://jira.opendaylight.org/browse/ODLPARENT-184>`__.)
1746
1747 New features
1748 ~~~~~~~~~~~~
1749
1750 * ``odl-woodstox`` wraps the Woodstox StAX implementation which is imposed on
1751   us by Karaf.
1752
1753 Version 4.0.8
1754 -------------
1755
1756 This is a bug-fix and minor upstream bump upgrade from version 4.0.7.
1757
1758 Bug fixes
1759 ~~~~~~~~~
1760
1761 * ``bcprov-ext-jdk15on`` is a superset of ``bcprov-jdk15on``, so there’s no
1762   need to ship both; we now only ship the former. In addition, we install the
1763   Bouncy Castle JARs in ``lib/boot`` so that they continue to be available on
1764   the boot classpath (JDK 9 removes the extension mechanism which was used
1765   previously), and provide the corresponding bundles from the boot classpath
1766   instead of using separate JARs in the system repository. (See
1767   `ODLPARENT-183 <https://jira.opendaylight.org/browse/ODLPARENT-183>`__ and
1768   `ODLPARENT-185 <https://jira.opendaylight.org/browse/ODLPARENT-185>`__.)
1769
1770 * A dependency check has been added to ensure that we don’t run into the
1771   TrieMap dependency bug in 4.0.6 again.
1772
1773 * Dependencies pulled in by features are now checked for convergence, and
1774   ``karaf-plugin`` warns when it finds diverging dependencies (the same
1775   artifact with two different versions). Upstream-provided features are
1776   patched to avoid the following divergences (and upgrade some dependencies in
1777   the process):
1778
1779   * Aries utilities 1.1.0/1.1.3 (upgraded to 1.1.3).
1780   * Commons Beanutils 1.8.3/1.9.3 (upgraded to 1.9.3).
1781   * Commons Codec 1.8/1.10 (upgraded to 1.11).
1782   * ``javax.mail`` 1.4.4/1.4.7 (upgraded to 1.4.7).
1783
1784   (See `ODLPARENT-189 <https://jira.opendaylight.org/browse/ODLPARENT-189>`__.)
1785
1786 New features
1787 ~~~~~~~~~~~~
1788
1789 * ``odl-dropwizard-metrics`` provides Dropwizard Metrics (which are also
1790   available in dependency management).
1791
1792 * ``enunciate-maven-plugin`` is added as the replacement for
1793   ``maven-enunciate-plugin``.
1794
1795 Third-party dependencies
1796 ~~~~~~~~~~~~~~~~~~~~~~~~
1797
1798 The following dependencies are no longer provided by the JVM, starting with
1799 version 11, but we make them available via dependency management for projects
1800 which need them:
1801
1802 * ``javax.annotation-api``.
1803
1804 * JAXB (``jaxb-core``, ``jaxb-impl``).
1805
1806 The following dependencies have been upgraded:
1807
1808 * Checkstyle `8.15 → 8.16 <https://checkstyle.org/releasenotes.html#Release_8.16>`__.
1809
1810 * Dependency Check `4.0.0 → 4.0.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
1811
1812 * ``git-commit-id`` `2.2.5 → 2.2.6 <https://github.com/ktoso/maven-git-commit-id-plugin/releases>`__.
1813
1814 * Immutables 2.7.1 → 2.7.3:
1815
1816   * `2.7.2 <https://github.com/immutables/immutables#272-2018-11-05>`__.
1817   * `2.7.3 <https://github.com/immutables/immutables#273-2018-11-10>`__.
1818
1819   (2.7.4 breaks our Javadocs.)
1820
1821 * Jackson `2.9.7 → 2.9.8 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.8>`__.
1822
1823 Version 4.0.7
1824 -------------
1825
1826 This is a bug-fix release, correcting the ``triemap`` import declaration.
1827
1828 Version 4.0.6
1829 -------------
1830
1831 This is a bug-fix and minor upstream packaging upgrade from version 4.0.5.
1832
1833 Bug fixes
1834 ~~~~~~~~~
1835
1836 Single-feature-test was broken with JDK 9 and later and Karaf 4.2.2; this
1837 release adds the additional JVM configuration needed.
1838
1839 Third-party dependencies
1840 ~~~~~~~~~~~~~~~~~~~~~~~~
1841
1842 This release adds the ``triemap`` BOM to dependency management.
1843
1844 Version 4.0.5
1845 -------------
1846
1847 This is a bug-fix release: the Karaf Maven plugin, in version 4.2.2, is
1848 `broken <https://issues.apache.org/jira/browse/KARAF-6057>`__ in some cases we
1849 need in OpenDaylight; we revert to 4.2.1 in ``karaf4-parent`` to avoid this.
1850
1851 Version 4.0.4
1852 -------------
1853
1854 This is a bug-fix release, reverting the change made in 4.0.3 to handle
1855 building with either ``zip`` or ``tar.gz`` Karaf archives (which breaks
1856 builds in our infrastructure, without the empty Karaf archive).
1857
1858 Version 4.0.3
1859 -------------
1860
1861 This is a bug-fix and minor upstream bump upgrade from version 4.0.2.
1862
1863 Bug fixes
1864 ~~~~~~~~~
1865
1866 * Our FindBugs configuration for JDK 9 and later caused the plugin to run
1867   everywhere; instead, this version defines the ``findbugs.skip`` property to
1868   disable the plugin in modules where it would be used otherwise.
1869
1870 * The PowerMock declarations in dependency management missed
1871   ``powermock-api-mockito2``, which is necessary for modules using PowerMock
1872   with Mockito 2.
1873
1874 * The “quick” profile (``-Pq``) now skips SpotBugs.
1875
1876 * JSR-305 annotations are now optional, which fixes a number of issues when
1877   building with newer JDKs.
1878
1879 * We provide JAXB with JDK 11 and later (where it is no longer provided by the
1880   base platform).
1881
1882 * ``odlparent-artifacts`` has been updated to accurately represent the
1883   artifacts provided.
1884
1885 * ``javax.activation`` is now excluded from generated features (it’s provided
1886   on Karaf’s boot classpath).
1887
1888 * When the build is configured to build Karaf distributions in ``tar.gz``
1889   archives, but not ``zip`` archives, ``features-test`` used to fail; it will
1890   now used whichever is available
1891   (`ODLPARENT-174 <https://jira.opendaylight.org/browse/ODLPARENT-174>`__).
1892
1893 * Explicit GCs are disabled by default, so that calls to ``System.gc()`` are
1894   ignored
1895   (`ODLPARENT-175 <https://jira.opendaylight.org/browse/ODLPARENT-175>`__).
1896
1897 * Null checks are disabled in SpotBugs because of bad interactions with newer
1898   annotations and the bytecode produces by JDK 11 and later for
1899   ``try``-with-resources.
1900
1901 * Akka Persistence expects LevelDB 0.10, so we now pull in that version
1902   instead of 0.7.
1903
1904 Dependency convergence
1905 ~~~~~~~~~~~~~~~~~~~~~~
1906
1907 A number of dependencies have been added or constrained so that projects using
1908 this parent can enforce dependency convergence:
1909
1910 * Karaf’s ``framework`` feature is used as an import POM, so that we converge
1911   by default on the versions used in Karaf.
1912
1913 * The following dependencies have been added to dependency management:
1914
1915   * ``commons-beanutils``
1916   * the Checker Framework
1917   * Error Prone annotations
1918   * ``javax.activation``
1919   * ``xml-apis``
1920
1921 New features
1922 ~~~~~~~~~~~~
1923
1924 The following Karaf features have been added:
1925
1926 * ``odl-antlr4`` (providing ``antlr4-runtime``);
1927
1928 * ``odl-gson`` (providing ``gson``);
1929
1930 * ``odl-jersey-2`` (providing Jersey client, server, and container servlet,
1931   along with the necessary feature dependencies);
1932
1933 * ``odl-servlet-api`` (providing ``javax.servlet-api``);
1934
1935 * ``odl-stax2-api`` (providing ``stax2-api``);
1936
1937 * ``odl-ws-rs-api`` (providing ``javax.ws.rs-api``);
1938
1939 A new ``sonar-jacoco-aggregate`` profile can be used to produce Sonar reports
1940 with aggregated JaCoCo reports. Additionally, Sonar builds (run with
1941 ``-Dsonar``) are detected and run with a number of irrelevant plugins disabled.
1942
1943 Upstream version upgrades
1944 ~~~~~~~~~~~~~~~~~~~~~~~~~
1945
1946 * Akka 2.5.14 → 2.5.19 (and related ``ssl-config``, Aeron and Agrona upgrades):
1947
1948   * `2.5.15 <https://akka.io/blog/news/2018/08/24/akka-2.5.15-released>`__.
1949   * `2.5.16 <https://akka.io/blog/news/2018/08/29/akka-2.5.16-security-fix-released>`__.
1950   * `2.5.17 <https://akka.io/blog/news/2018/09/27/akka-2.5.17-released>`__.
1951   * `2.5.18 <https://akka.io/blog/news/2018/10/07/akka-2.5.18-released>`__.
1952   * `2.5.19 <https://akka.io/blog/news/2018/12/07/akka-2.5.19-released>`__.
1953
1954 * Commons Text `1.4 → 1.6 <http://www.apache.org/dist/commons/text/RELEASE-NOTES.txt>`__.
1955
1956 * Eclipse JDT annotations 2.2.0 → 2.2.100.
1957
1958 * Javassist 3.23.1 → 3.24.0.
1959
1960 * Karaf 4.2.1 → 4.2.2, with related upgrades.
1961
1962 * LMAX Disruptor `3.4.1 → 3.4.2 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.2>`__.
1963
1964 * Mockito `2.20.1 → 2.23.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md>`__.
1965
1966 * Netty 4.1.29 → 4.1.31:
1967
1968   * `4.1.30 <https://netty.io/news/2018/09/28/4-1-30-Final.html>`__.
1969   * `4.1.31 <https://netty.io/news/2018/10/30/4-1-31-Final.html>`__.
1970
1971 * Pax Exam 4.12.0 → 4.13.1.
1972
1973 * Scala 2.12.6 → 2.12.8:
1974
1975   * `2.12.7 <https://github.com/scala/scala/releases/tag/v2.12.7>`__.
1976   * `2.12.8 <https://github.com/scala/scala/releases/tag/v2.12.8>`__.
1977
1978 * Wagon HTTP 3.1.0 → 3.2.0.
1979
1980 * Xtend `2.14.0 → 2.16.0 <https://www.eclipse.org/xtend/releasenotes.html>`__.
1981
1982 Plugin version upgrades
1983 ~~~~~~~~~~~~~~~~~~~~~~~
1984
1985 * Asciidoctor `1.5.6 → 1.5.7.1 <https://github.com/asciidoctor/asciidoctor-maven-plugin/releases>`__
1986   (with related AsciidoctorJ upgrades).
1987
1988 * Bundle 4.0.0 → 4.1.0.
1989
1990 * Checkstyle `8.12 → 8.15 <https://checkstyle.org/releasenotes.html#Release_8.13>`__.
1991
1992 * DependencyCheck `3.3.2 → 4.0.0 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
1993
1994 * Failsafe / Surefire `2.22.0 → 2.22.1 <https://blogs.apache.org/maven/entry/apache-maven-surefire-plugin-version1>`__.
1995
1996 * Help 3.1.0 → 3.1.1.
1997
1998 * JAR 3.1.0 → 3.1.1.
1999
2000 * PMD `3.10.0 → 3.11.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-3>`__.
2001
2002 * Remote Resources `1.5 → 1.6.0 <https://blogs.apache.org/maven/entry/apache-maven-remote-resources-plugin>`__.
2003
2004 * Shade
2005   `3.2.0 → 3.2.1 <https://blog.soebes.de/blog/2018/11/12/apache-maven-shade-plugin-version-3-dot-2-1-released/>`__.
2006
2007 * SpotBugs `3.1.6 → 3.1.9 <https://github.com/spotbugs/spotbugs/blob/release-3.1/CHANGELOG.md>`__.
2008
2009 * XBean finder 4.9 → 4.12.
2010
2011 * XTend 2.14.0 → 2.16.0.
2012
2013 Version 4.0.2
2014 -------------
2015
2016 This is a bug-fix and minor upstream bump upgrade from version 4.0.1.
2017
2018 Bug fixes
2019 ~~~~~~~~~
2020
2021 Previous releases overrode Karaf’s ``jre.properties``; this is no longer
2022 necessary, and was causing failures with Java 9 and later (our version of
2023 ``jre.properties`` didn’t have the appropriate settings for anything after
2024 Java 8). This release drops that override. See
2025 `ODLPARENT-168 <https://jira.opendaylight.org/browse/ODLPARENT-168>`__ for
2026 details.
2027
2028 Upstream version upgrades
2029 ~~~~~~~~~~~~~~~~~~~~~~~~~
2030
2031 * Commons Lang `3.8 → 3.8.1 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__.
2032
2033 * Jackson `2.9.6 → 2.9.7 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.7>`__.
2034
2035 * Netty `4.1.28 → 4.1.29 <http://netty.io/news/2018/08/24/4-1-29-Final.html>`__.
2036
2037 Plugin version upgrades
2038 ~~~~~~~~~~~~~~~~~~~~~~~
2039
2040 * JAR `3.0.2 → 3.1.0 <https://blog.soebes.de/blog/2018/04/10/apache-maven-jar-plugin-version-3-dot-1-dot-0-released>`__.
2041
2042 * Javadoc `3.0.0 → 3.0.1 <https://blogs.apache.org/maven/entry/apache-maven-javadoc-plugin-version>`__.
2043
2044 * Jersey `2.22.2 → 2.25.1 <https://jersey.github.io/release-notes/2.25.html>`__,
2045   along with Glassfish JSON 1.0.4 → 1.1.2.
2046
2047 * Plugin 3.5 → 3.5.2:
2048
2049   * `3.5.1 <https://blog.soebes.de/blog/2018/01/22/apache-maven-plugin-tools-version-3-dot-5-1-released/>`__.
2050   * `3.5.2 <https://blog.soebes.de/blog/2018/05/26/apache-mave-plugin-tools-version-3-dot-5-2-released/>`__.
2051
2052 * Resources `3.0.1 → 3.1.0 <https://blogs.apache.org/maven/entry/apache-maven-resources-plugin-version>`__.
2053
2054 Version 4.0.1
2055 -------------
2056
2057 This is a bug-fix and minor upstream bump upgrade from version 4.0.0.
2058
2059 Bug fixes
2060 ~~~~~~~~~
2061
2062 The JaCoCo execution profile was incorrect, breaking Sonar; the report is now
2063 written correctly, so that Sonar can find it.
2064
2065 The Blueprint Maven plugin fails when it encounters Java 9 classes; this is
2066 fixed by forcefully upgrading its dependency on xbean-finder. See
2067 `ODLPARENT-167 <https://jira.opendaylight.org/browse/ODLPARENT-167>`__ for
2068 details.
2069
2070 Upstream version upgrades
2071 ~~~~~~~~~~~~~~~~~~~~~~~~~
2072
2073 * SpotBugs `3.1.6 → 3.1.7 <https://github.com/spotbugs/spotbugs/blob/release-3.1/CHANGELOG.md>`__.
2074
2075 Upstream version additions
2076 ~~~~~~~~~~~~~~~~~~~~~~~~~~
2077
2078 * Mockito Inline is added alongside Mockito Core, to ensure that the versions
2079   are kept in sync.
2080
2081 Plugin version upgrades
2082 ~~~~~~~~~~~~~~~~~~~~~~~
2083
2084 * Clean `3.0.0 → 3.1.0 <https://blog.soebes.de/blog/2018/04/14/apache-maven-clean-plugin-version-3-dot-1-0-released/>`__.
2085
2086 * Compiler `3.7.0 → 3.8.0 <https://blog.soebes.de/blog/2018/07/30/apache-maven-compiler-plugin-version-3-dot-8-0-released/>`__.
2087
2088 * Dependency 3.0.2 → 3.1.1:
2089
2090   * `3.1.0 <https://blog.soebes.de/blog/2018/04/06/apache-maven-dependency-plugin-version-3-dot-1-0-released/>`__.
2091   * `3.1.1 <https://blog.soebes.de/blog/2018/05/24/apache-maven-dependency-plugin-version-3-dot-1-1-released/>`__.
2092
2093 * Dependency Check `3.3.1 → 3.3.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
2094
2095 * Enforcer `3.0.0-M1 → 3.0.0-M2 <https://mail-archives.apache.org/mod_mbox/maven-announce/201806.mbox/%3Cop.zko9b2vhkdkhrr%40desktop-2khsk44.dynamic.ziggo.nl%3E>`__.
2096
2097 * Failsafe 2.20.1 → 2.22:
2098
2099   * `2.21 <https://blog.soebes.de/blog/2018/03/06/apache-maven-surefire-plugin-version-2-dot-21-released/>`__.
2100   * `2.22 <https://blog.soebes.de/blog/2018/06/16/apache-maven-surefire-plugin-version-2-dot-22-released/>`__.
2101
2102 * Help 2.2 → 3.1.0:
2103
2104   * `3.0.0 <https://blog.soebes.de/blog/2018/03/18/apache-maven-help-plugin-version-3-dot-0-0-released/>`__.
2105   * `3.0.1 <https://blog.soebes.de/blog/2018/03/28/apache-maven-help-plugin-version-3-dot-0-1-released/>`__.
2106   * `3.1.0 <https://blog.soebes.de/blog/2018/06/09/apache-maven-help-plugin-version-3-dot-1-0-released/>`__.
2107
2108 * Invoker 2.0.0 → 3.1.0:
2109
2110   * `3.0.0 <https://blog.soebes.de/blog/2017/05/24/apache-maven-invoker-plugin-version-3-dot-0-0-released/>`__.
2111   * `3.1.0 <https://blog.soebes.de/blog/2018/05/31/apache-maven-invoker-plugin-version-3-dot-1-0-released/>`__.
2112
2113 * JAR `3.0.2 → 3.1.0 <https://blog.soebes.de/blog/2018/04/10/apache-maven-jar-plugin-version-3-dot-1-dot-0-released/>`__.
2114
2115 * Project Info Reports `2.9 → 3.0.0 <https://blog.soebes.de/blog/2018/06/27/apache-maven-project-info-reports-plugin-3-dot-0-0-released/>`__.
2116
2117 * Resources `3.0.1 → 3.1.0 <https://blog.soebes.de/blog/2018/05/01/apache-maven-resources-plugin-version-3-dot-1-0-released/>`__.
2118
2119 * Shade `3.1.0 → 3.2.0 <https://blog.soebes.de/blog/2018/09/13/apache-maven-shade-plugin-version-3-dot-2-0-released/>`__.
2120
2121 * Site `3.7 → 3.7.1 <https://blog.soebes.de/blog/2018/04/29/apache-maven-site-plugin-version-3-dot-7-1-released/>`__.
2122
2123 * Surefire 2.18.1 → 2.22.0:
2124
2125   * `2.19 <https://blog.soebes.de/blog/2015/10/19/apache-maven-surefire-plugin-version-2-dot-19-released/>`__.
2126   * `2.19.1 <https://blog.soebes.de/blog/2016/01/03/apache-maven-surefire-plugin-version-2-dot-19-dot-1-released/>`__.
2127   * `2.20 <https://blog.soebes.de/blog/2017/04/12/apache-maven-surefire-plugin-version-2-dot-20-released/>`__.
2128   * `2.21 <https://blog.soebes.de/blog/2018/03/06/apache-maven-surefire-plugin-version-2-dot-21-released/>`__.
2129   * `2.22 <https://blog.soebes.de/blog/2018/06/16/apache-maven-surefire-plugin-version-2-dot-22-released/>`__.
2130
2131
2132 Version 4.0.0
2133 -------------
2134
2135 This is a major upgrade from version 3, with breaking changes; projects will
2136 need to make changes to upgrade to this version.
2137
2138 `This Wiki page <https://wiki.opendaylight.org/view/Neon_platform_upgrade>`__
2139 has detailed step-by-step migration instructions.
2140
2141 ODL Parent 4 requires Maven 3.5.3 or later; this is needed in particular to
2142 enable SpotBugs support with current versions of the SpotBugs plugin.
2143
2144 Known issues
2145 ~~~~~~~~~~~~
2146
2147 This release’s SpotBugs support doesn’t handle Guava 25.1 correctly, resulting
2148 in false-positives regarding null handling; see
2149 `ODLPARENT-161 <https://jira.opendaylight.org/browse/ODLPARENT-161>`__ for
2150 details. Until this is fixed, the corresponding warnings are disabled, which
2151 matches our existing FindBugs configuration (which suffers from the a variant
2152 of this, with the same consequences).
2153
2154 We are planning on upgrading Akka during the 4.x cycle, even if it results in
2155 a technically breaking upgrade. This is currently blocked on an OSGi bug in
2156 Akka; see `Akka issue 25579 <https://github.com/akka/akka/issues/25579>`__ for
2157 details.
2158
2159 Blueprint and OSGi service handling
2160 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2161
2162 Previous releases used an OpenDaylight-specific directory for Blueprint XML
2163 files, ``org/opendaylight/blueprint``. It turned out this wasn’t useful, so
2164 version 4 uses the default directory, ``OSGI-INF/blueprint``.
2165
2166 The Maven bundle plugin is now configured to omit the ``Import-Service`` and
2167 ``Export-Service`` headers, since they are deprecated, unnecessary in
2168 OpenDaylight, and liable to cause issues.
2169
2170 With previous releases of OpenDaylight, projects were encouraged to use Pax
2171 CDI API annotations to describe their Blueprint beans, services and injections;
2172 with version 4, Blueprint annotations should be used instead:
2173
2174 * modules should depend on
2175   ``org.apache.aries.blueprint:blueprint-maven-plugin-annotation``, with the
2176   ``<optional>true</optional>`` flag, instead of
2177   ``org.ops4j.pax.cdi:pax-cdi-api``;
2178
2179 * ``@OsgiServiceProvider`` on bean definitions is replaced by ``@Service``;
2180
2181 * ``@OsgiService`` at injection points is replaced by ``@Reference``;
2182
2183 * ``@OsgiService`` on bean definitions, while technically wrong, can be seen in
2184   the OpenDaylight codebase; this is replaced by ``@Service``;
2185
2186 * service lists can be injected using ``@ReferenceList``.
2187
2188 See `this Gerrit patch <https://git.opendaylight.org/gerrit/75699>`__ for an
2189 example.
2190
2191 Compiler settings
2192 ~~~~~~~~~~~~~~~~~
2193
2194 Builds now warn about unchecked type uses (such as raw types where generics
2195 are available).
2196
2197 JUnit and Mockito are always available as test dependencies and no longer need
2198 to be declared in POMs.
2199
2200 New build profiles
2201 ~~~~~~~~~~~~~~~~~~
2202
2203 An OWASP profile is now available to run OWASP’s dependency checker; this will
2204 check all third-party dependencies against the NVD vulnerability database. To
2205 enable this, run Maven with ``-Powasp``.
2206
2207 Build profile changes
2208 ~~~~~~~~~~~~~~~~~~~~~
2209
2210 ``-Pq`` now skips Modernizer.
2211
2212 New features
2213 ~~~~~~~~~~~~
2214
2215 ``odl-akka-leveldb-0.10`` wraps LevelDB 0.10 for Akka.
2216
2217 ``odl-apache-commons-codec`` wraps Apache Commons Codec.
2218
2219 ``odl-apache-commons-lang3`` wraps Apache Commons Lang 3.
2220
2221 ``odl-apache-commons-net`` wraps Apache Commons Net.
2222
2223 ``odl-apache-commons-text`` wraps Apache Commons Text.
2224
2225 ``odl-apache-sshd`` wraps Apache SSHD.
2226
2227 ``odl-guava`` provides the default ODL version of Guava; it should be used
2228 instead of ``odl-guava-23`` or the new ``odl-guava-25``.
2229
2230 ``odl-jackson-2.9`` wraps Jackson 2.9.
2231
2232 New FindBugs and SpotBugs settings
2233 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
2234
2235 FindBugs and SpotBugs are configured with
2236 `the SLF4J extension <http://kengotoda.github.io/findbugs-slf4j/>`__ (version
2237 1.4.0 for FindBugs, 1.4.1 for SpotBugs). This will flag misused SLF4J calls, in
2238 particular message templates which don’t match the arguments, and invalid
2239 placeholders (*e.g.* ``%s`` instead of ``{}``).
2240
2241 Deleted artifacts
2242 ~~~~~~~~~~~~~~~~~
2243
2244 ``aggregator-parent`` was unusable outside ``odlparent`` and has been removed.
2245 Instead, the ``maven.deploy.skip`` and ``maven.install.skip`` properties are
2246 available to disable deploying and installing artifacts.
2247
2248 Upstream version upgrades
2249 ~~~~~~~~~~~~~~~~~~~~~~~~~
2250
2251 This version upgrades the following third-party dependencies:
2252
2253 * Aeron 1.7.0 → 1.9.3:
2254
2255   * `1.8.0 <https://github.com/real-logic/aeron/releases/tag/1.8.0>`__.
2256   * `1.8.1 <https://github.com/real-logic/aeron/releases/tag/1.8.1>`__.
2257   * `1.8.2 <https://github.com/real-logic/aeron/releases/tag/1.8.2>`__.
2258   * `1.9.0 <https://github.com/real-logic/aeron/releases/tag/1.9.0>`__.
2259   * `1.9.1 <https://github.com/real-logic/aeron/releases/tag/1.9.1>`__.
2260   * `1.9.2 <https://github.com/real-logic/aeron/releases/tag/1.9.2>`__.
2261   * `1.9.3 <https://github.com/real-logic/aeron/releases/tag/1.9.3>`__.
2262
2263 * Agrona 0.9.12 → 0.9.21:
2264
2265   * `0.9.13 <https://github.com/real-logic/agrona/releases/tag/0.9.13>`__.
2266   * `0.9.14 <https://github.com/real-logic/agrona/releases/tag/0.9.14>`__.
2267   * `0.9.15 <https://github.com/real-logic/agrona/releases/tag/0.9.15>`__.
2268   * `0.9.16 <https://github.com/real-logic/agrona/releases/tag/0.9.16>`__.
2269   * `0.9.17 <https://github.com/real-logic/agrona/releases/tag/0.9.17>`__.
2270   * `0.9.18 <https://github.com/real-logic/agrona/releases/tag/0.9.18>`__.
2271   * `0.9.19 <https://github.com/real-logic/agrona/releases/tag/0.9.19>`__.
2272   * `0.9.20 <https://github.com/real-logic/agrona/releases/tag/0.9.20>`__.
2273   * `0.9.21 <https://github.com/real-logic/agrona/releases/tag/0.9.21>`__.
2274
2275 * Akka 2.5.11 → 2.5.14:
2276
2277   * `2.5.12 <https://akka.io/blog/news/2018/04/13/akka-2.5.12-released>`__.
2278   * `2.5.13 <https://akka.io/blog/news/2018/06/08/akka-2.5.13-released>`__.
2279   * `2.5.14 <https://akka.io/blog/news/2018/07/13/akka-2.5.14-released>`__.
2280
2281 * ASM 5.1 → 6.2.1 (synchronised with Karaf).
2282
2283 * Bouncy Castle `1.59 → 1.60 <https://www.bouncycastle.org/releasenotes.html>`__.
2284
2285 * Checkstyle `8.4 → 8.12 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.12>`__.
2286
2287 * Commons Lang `3.7 → 3.8 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__.
2288
2289 * Commons Text 1.1 → 1.4:
2290
2291   * `1.2 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.2.txt>`__.
2292   * `1.3 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.3.txt>`__.
2293   * `1.4 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.4.txt>`__.
2294
2295 * Eclipse JDT annotations 2.1.150 → 2.2.0.
2296
2297 * EclipseLink Moxy JAXB `2.7.1 → 2.7.3 <https://www.eclipse.org/eclipselink/releases/2.7.php>`__.
2298
2299 * Enunciate core annotations
2300   `2.10.1 → 2.11.1 <https://github.com/stoicflame/enunciate/releases>`__.
2301
2302 * Felix Metatype 1.1.6 → 1.2.0 (synchronised with Karaf).
2303
2304 * Google Truth `0.40 → 0.42 <https://github.com/google/truth/releases>`__.
2305
2306 * Guava 23.6.1 → 25.1:
2307
2308   * `23.4 <https://github.com/google/guava/releases/tag/v23.4>`__.
2309   * `23.5 <https://github.com/google/guava/releases/tag/v23.5>`__.
2310   * `23.6 <https://github.com/google/guava/releases/tag/v23.6>`__.
2311   * `24.0 <https://github.com/google/guava/releases/tag/v24.0>`__.
2312   * `24.1 <https://github.com/google/guava/releases/tag/v24.1>`__.
2313   * `25.0 <https://github.com/google/guava/releases/tag/v25.0>`__.
2314   * `25.1 <https://github.com/google/guava/releases/tag/v25.1>`__.
2315
2316 * Immutables `2.5.6 → 2.7.1 <https://github.com/immutables/immutables/blob/master/README.md#changelog>`__.
2317
2318 * Jackson 2.8.9 → 2.9.6:
2319
2320   * `2.9 feature overview <https://medium.com/@cowtowncoder/jackson-2-9-features-b2a19029e9ff>`__.
2321   * `2.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9>`__.
2322   * `2.9.1 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.1>`__.
2323   * `2.9.2 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.2>`__.
2324   * `2.9.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.3>`__.
2325   * `2.9.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.4>`__.
2326   * `2.9.5 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.5>`__.
2327   * `2.9.6 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.6>`__.
2328
2329 * JaCoCo `0.8.1 → 0.8.2 <https://github.com/jacoco/jacoco/releases/tag/v0.8.2>`__.
2330
2331 * Javassist 3.22.0 → 3.23.1. This provides compatibility with Java 9 and later,
2332   and `fixes a file handle leak <https://github.com/jboss-javassist/javassist/issues/165>`__.
2333
2334 * Jettison 1.3.8 → 1.4.0.
2335
2336 * Jetty 9.3.21 → 9.4.11 (synchronised with Karaf):
2337
2338   * `9.4.0 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00097.html>`__.
2339   * `9.4.1 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00100.html>`__.
2340   * `9.4.2 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00101.html>`__.
2341   * `9.4.3 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00102.html>`__.
2342   * `9.4.4 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00105.html>`__.
2343   * `9.4.5 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00107.html>`__.
2344   * `9.4.6 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00109.html>`__.
2345   * `9.4.7 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00111.html>`__.
2346   * `9.4.8 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00114.html>`__.
2347   * `9.4.9 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00117.html>`__.
2348   * `9.4.10 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00119.html>`__.
2349   * `9.4.11 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00122.html>`__.
2350
2351 * Jolokia OSGi `1.5.0 → 1.6.0 <https://jolokia.org/changes-report.html#a1.6.0>`__.
2352
2353 * Karaf 4.1.5 → 4.2.1:
2354
2355   * `4.1.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342748>`__.
2356   * `4.2.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342945>`__.
2357
2358 * LMAX Disruptor 3.3.10 → 3.4.1:
2359
2360   * `3.4.0 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.0>`__.
2361   * `3.4.1 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.1>`__.
2362
2363 * META-INF services 1.7 → 1.8.
2364
2365 * Mockito 1.10.19 → 2.20.1; see
2366   `What’s new in Mockito 2 <https://github.com/mockito/mockito/wiki/What%27s-new-in-Mockito-2>`__
2367   for upgrade instructions and
2368   `the list of issues you might run into <https://asolntsev.github.io/en/2016/10/11/mockito-2.1/>`__.
2369
2370 * Netty 4.1.22 → 4.1.28:
2371
2372   * `4.1.17 <http://netty.io/news/2017/11/08/4-0-53-Final-4-1-17-Final.html>`__.
2373   * `4.1.18 <http://netty.io/news/2017/12/11/4-0-54-Final-4-1-18-Final.html>`__.
2374   * `4.1.19 <http://netty.io/news/2017/12/18/4-1-19-Final.html>`__.
2375   * `4.1.20 <http://netty.io/news/2018/01/22/4-0-55-Final-4-1-20-Final.html>`__.
2376   * `4.1.21 <http://netty.io/news/2018/02/05/4-0-56-Final-4-1-21-Final.html>`__.
2377   * `4.1.22 <http://netty.io/news/2018/02/21/4-1-22-Final.html>`__.
2378   * `4.1.23 <http://netty.io/news/2018/04/04/4-1-23-Final.html>`__.
2379   * `4.1.24 <http://netty.io/news/2018/04/19/4-1-24-Final.html>`__.
2380   * `4.1.25 <http://netty.io/news/2018/05/14/4-1-25-Final.html>`__.
2381   * `4.1.26 <http://netty.io/news/2018/07/10/4-1-26-Final.html>`__.
2382   * `4.1.27 <http://netty.io/news/2018/07/11/4-1-27-Final.html>`__.
2383   * `4.1.28 <http://netty.io/news/2018/07/27/4-1-28-Final.html>`__.
2384
2385 * Pax Exam 4.11.0 → 4.12.0.
2386
2387 * Pax URL 2.5.3 → 2.5.4, which only fixes
2388   `a potential NullPointerException <https://ops4j1.jira.com/browse/PAXURL-346>`__.
2389
2390 * PowerMock 1.6.4 → 1.7.4:
2391
2392   * `1.6.5 <https://github.com/powermock/powermock/releases/tag/powermock-1.6.5>`__.
2393   * `1.6.6 <https://github.com/powermock/powermock/releases/tag/powermock-1.6.6>`__.
2394   * `1.7.0 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.0>`__.
2395   * `1.7.1 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.1>`__.
2396   * `1.7.2 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.2>`__.
2397   * `1.7.3 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.3>`__.
2398   * `1.7.4 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.4>`__.
2399
2400 * Scala parser combinators 1.0.7 → 1.1.1:
2401
2402   * `1.1.0 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.0>`__.
2403   * `1.1.1 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.1>`__.
2404
2405 * SpotBugs `3.1.0 → 3.1.6 <https://github.com/spotbugs/spotbugs/blob/3.1.6/CHANGELOG.md>`__.
2406
2407 * Threeten Extra `1.3.2 → 1.4 <https://github.com/ThreeTen/threeten-extra/releases>`__.
2408
2409 * Typesafe SSL config 0.2.2 → 0.2.4:
2410
2411   * `0.2.3 <https://github.com/lightbend/ssl-config/releases/tag/v0.2.3>`__.
2412   * `0.2.4 <https://github.com/lightbend/ssl-config/releases/tag/v0.2.4>`__.
2413
2414 * Wagon HTTP
2415   `2.10 → 3.1.0 <https://lists.apache.org/thread.html/96024c54db7680697cb066e22a37b0ed5b4498386714a8a9ae1ec9cd@%3Cannounce.maven.apache.org%3E>`__.
2416
2417 * XMLUnit `1.6 → 2.6.2 <https://github.com/xmlunit/xmlunit/blob/master/RELEASE_NOTES.md>`__.
2418
2419 Upstream version additions
2420 ~~~~~~~~~~~~~~~~~~~~~~~~~~
2421
2422 The following upstream dependencies have been added to dependency management:
2423
2424 * Apache SSHD 2.0.0, with EdDSA and Netty support (EdDSA is provided by ``net.i2p.crypto:eddsa``).
2425
2426 * Blueprint annotations (``org.apache.aries.blueprint:blueprint-maven-plugin-annotation``).
2427
2428 * Log4J2.
2429
2430 * Pax Web 7.2.3 (synchronised with Karaf).
2431
2432 Upstream version removals
2433 ~~~~~~~~~~~~~~~~~~~~~~~~~
2434
2435 The following upstream dependencies have been removed from dependency management:
2436
2437 * Google Protobuf.
2438
2439 * Our repackaging of Jersey Servlet.
2440
2441 * JUnit’s ``junit-dep``, which has long been obsolete.
2442
2443 * LevelDB (which is still available as features).
2444
2445 * Pax CDI API — Blueprint annotations should be used instead.
2446
2447 Plugin version upgrades
2448 ~~~~~~~~~~~~~~~~~~~~~~~
2449
2450 The following plugins have been upgraded:
2451
2452 * Blueprint 1.4.0 → 1.10.0.
2453
2454 * Build helper 1.12 → 3.0.0.
2455
2456 * Bundle plugin 3.5.0 → 4.0.0.
2457
2458 * Checkstyle
2459   `2.17 → 3.0.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201801.mbox/%3Cop.zchs68akkdkhrr%40desktop-2khsk44.mshome.net%3E>`__.
2460
2461 * Duplicate finder
2462   `1.2.1 → 1.3.0 <https://github.com/basepom/duplicate-finder-maven-plugin/blob/master/CHANGES.md>`__.
2463
2464 * Git commit id `2.2.4 → 2.2.5 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.5>`__.
2465
2466 * Jacoco Maven plugin `0.8.1 → 0.8.2 <https://github.com/jacoco/jacoco/releases/tag/v0.8.2>`__.
2467
2468 * Javadoc `3.0.0 → 3.0.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12342283>`__.
2469
2470 * PMD 3.8 → 3.10.0:
2471
2472   * `3.10.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12342689&styleName=Text&projectId=12317621>`__.
2473
2474 * Sevntu `1.29.0 → 1.32.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.32.0>`__.
2475
2476 * SpotBugs 3.1.0-RC6 → 3.1.6 (see the SpotBugs changes above).
2477
2478 Version 3.1.3
2479 -------------
2480
2481 This version fixes the following issues:
2482
2483 * `ODLPARENT-156 <https://jira.opendaylight.org/browse/ODLPARENT-156>`_:
2484   ``xtend-maven-plugin``’s dependencies end up pulling in conflicting
2485   dependencies. ODL Parent now constrains part of its dependency tree to avoid
2486   this.
2487
2488 This version adds ``odl-jackson-2.8`` to ``odlparent-artifacts``.
2489
2490 Version 3.1.2
2491 -------------
2492
2493 This version fixes the following issues:
2494
2495 * `INFRAUTILS-41 <https://jira.opendaylight.org/browse/INFRAUTILS-41>`_:
2496   ``jre.properties`` includes ``com.sun.management`` so that it can be
2497   enabled if necessary. (This doesn’t add a dependency on
2498   ``com.sun.management``, it allows bundles to use it if it is present.)
2499
2500 * `ODLPARENT-136 <https://jira.opendaylight.org/browse/ODLPARENT-136>`_:
2501   ``SingleFeatureTest`` pulls in ``org.osgi.compendium``.
2502
2503 * `ODLPARENT-144 <https://jira.opendaylight.org/browse/ODLPARENT-144>`_:
2504   ``org.apache.karaf.scr.management`` is whitelisted so that it no longer
2505   affects ``SingleFeatureTest``.
2506
2507 * `ODLPARENT-146 <https://jira.opendaylight.org/browse/ODLPARENT-146>`_:
2508   null-related FindBugs checks which produce false-positives with Guava 23.6
2509   and later are disabled, so that this really is fully backwards-compatible
2510   with 3.0 and later.
2511
2512 * `ODLPARENT-148 <https://jira.opendaylight.org/browse/ODLPARENT-148>`_:
2513   ``SingleFeatureTest`` preserves ``target/SFT/karaf.log``.
2514
2515 This version includes the following improvements:
2516
2517 * ``custom.properties`` no longer includes OVSDB-specific configuration.
2518
2519 * The ``odl-jersey-1`` feature includes the Jersey client.
2520
2521 * Redundant bundle dependency declarations in ``SingleFeatureTest`` have been
2522   removed (these are declarations which are also present in our base Karaf
2523   distribution).
2524
2525 * Build errors involving invalid feature or bundle URLs now indicate which
2526   feature is at fault.
2527
2528 * Obsolete Log4J overrides have been removed from ``SingleFeatureTest``.
2529
2530 When building using JDK 9 or 10, the default settings have been changed as
2531 follows to avoid errors or extraneous warnings:
2532
2533 * SFT is disabled (it needs Karaf 4.2 or later);
2534
2535 * Javadocs are generated as HTML 4;
2536
2537 * SpotBugs is disabled on JDK 10 or later;
2538
2539 * FindBugs is disabled on JDK 9 or later.
2540
2541 The following third-party dependencies have been upgraded:
2542
2543 * `EclipseLink Moxy JAXB 2.6.2 → 2.7.1 <https://www.eclipse.org/eclipselink/releases/2.7.php>`_.
2544
2545 * `Google Truth 0.36 → 0.40 <https://github.com/google/truth/releases>`_.
2546
2547 * `Gson 2.8.2 → 2.8.5 <https://github.com/google/gson/blob/master/CHANGELOG.md>`_.
2548
2549 * `Guava 23.6 → 23.6.1 <https://github.com/google/guava/compare/v23.6...v23.6.1>`_.
2550   This addresses CVE-2018-10237 (that’s the only change in this release).
2551
2552 * `Jacoco Maven plugin 0.8.0 → 0.8.1 <https://github.com/jacoco/jacoco/releases/tag/v0.8.1>`_.
2553
2554 * JDT annotations 2.1.0 → 2.1.150.
2555
2556 * `Scala 2.12.5 → 2.12.6 <https://github.com/scala/scala/releases/tag/v2.12.6>`_.
2557
2558 * `Scala Parser Combinators 1.0.6 → 1.0.7 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.0.7>`_.
2559
2560 * `Sevntu 1.24.2 → 1.29.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.29.0>`_.
2561
2562 * `Xtext and Xtend 2.13.0 → 2.14.0 <https://github.com/eclipse/xtext/blob/website-master/xtend-website/_posts/releasenotes/2018-05-23-version-2-14-0.md>`_.
2563
2564 The following Maven plugin has been upgraded:
2565
2566 * `Javadoc 3.0.0 → 3.0.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12342283>`_.
2567
2568 Version 3.1.1
2569 -------------
2570
2571 This version fixes the following issues:
2572
2573 * `ODLPARENT-137 <https://jira.opendaylight.org/browse/ODLPARENT-137>`_:
2574   restore the OpenDaylight prompt.
2575
2576 * `ODLPARENT-146 <https://jira.opendaylight.org/browse/ODLPARENT-146>`_:
2577   Guava 23.6 switched from @Nullable to @NullableDecl, which causes false
2578   positives in FindBugs’ ``NP_NONNULL_PARAM_VIOLATION`` rule; we’re
2579   disabling the rule for now.
2580
2581 Version 3.1.0
2582 -------------
2583
2584 This version fixes the following issues:
2585
2586 * Mycila dependencies are now “compile” scoped rather than “test”; this allows
2587   child projects to use Guice with Mycila more easily.
2588
2589 * The duplicate finder now ignores ``web.xml`` and BluePrint XML files.
2590
2591 This version includes the following improvements:
2592
2593 * The ``-Pq`` profile skips Maven Modernizer, in preparation for its future
2594   integration (and its use in child projects).
2595
2596 * An OWASP profile, ``-Powasp`` is available for vulnerability checking.
2597
2598 * A new ``odl-jackson-2.8`` feature provides Jackson 2.8 to child projects.
2599
2600 The following third-party dependencies have been added to dependency management:
2601
2602 * `ThreeTen-Extra <http://www.threeten.org/threeten-extra/>`_
2603
2604 The following third-party dependencies have been upgraded:
2605
2606 * Aeron 1.2.5 → 1.7.0; release notes:
2607
2608   * `1.3.0 <https://github.com/real-logic/aeron/releases/tag/1.3.0>`_
2609   * `1.4.0 <https://github.com/real-logic/aeron/releases/tag/1.4.0>`_
2610   * `1.5.0 <https://github.com/real-logic/aeron/releases/tag/1.5.0>`_
2611   * `1.5.1 <https://github.com/real-logic/aeron/releases/tag/1.5.1>`_
2612   * `1.5.2 <https://github.com/real-logic/aeron/releases/tag/1.5.2>`_
2613   * `1.6.0 <https://github.com/real-logic/aeron/releases/tag/1.6.0>`_
2614   * `1.7.0 <https://github.com/real-logic/aeron/releases/tag/1.7.0>`_
2615
2616 * Agrona 0.9.5 → 0.9.12; release notes:
2617
2618   * `0.9.6 <https://github.com/real-logic/Agrona/releases/tag/0.9.6>`_
2619   * `0.9.7 <https://github.com/real-logic/Agrona/releases/tag/0.9.7>`_
2620   * `0.9.8 <https://github.com/real-logic/Agrona/releases/tag/0.9.8>`_
2621   * `0.9.9 <https://github.com/real-logic/Agrona/releases/tag/0.9.9>`_
2622   * `0.9.10 <https://github.com/real-logic/Agrona/releases/tag/0.9.10>`_
2623   * `0.9.11 <https://github.com/real-logic/Agrona/releases/tag/0.9.11>`_
2624   * `0.9.12 <https://github.com/real-logic/Agrona/releases/tag/0.9.12>`_
2625
2626 * Akka 2.5.5 → 2.5.11; release notes:
2627
2628   * `2.5.6 <https://akka.io/blog/news/2017/09/28/akka-2.5.6-released>`_
2629   * `2.5.7 <https://akka.io/blog/news/2017/11/17/akka-2.5.7-released>`_
2630   * `2.5.8 <https://akka.io/blog/news/2017/12/08/akka-2.5.8-released>`_
2631   * `2.5.9 <https://akka.io/blog/news/2018/01/11/akka-2.5.9-released-2.4.x-end-of-life>`_
2632   * `2.5.10 <https://akka.io/blog/news/2018/02/23/akka-2.5.10-released>`_
2633   * `2.5.11 <https://akka.io/blog/news/2018/02/28/akka-2.5.11-released>`_
2634
2635 * Commons Lang 3 `3.6 → 3.7 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`_
2636
2637 * Guava 23.3 → 23.6; release notes:
2638
2639   * `23.4 <https://github.com/google/guava/releases/tag/v23.4>`_
2640   * `23.5 <https://github.com/google/guava/releases/tag/v23.5>`_
2641   * `23.6 <https://github.com/google/guava/releases/tag/v23.6>`_
2642
2643 * H2 database `1.4.193 → 1.4.196 <http://www.h2database.com/html/changelog.html>`_
2644
2645 * Jacoco `0.7.9 → 0.8.0 <https://github.com/jacoco/jacoco/releases/tag/v0.8.0>`_
2646
2647 * Javassist `3.21.0 → 3.22.0 <https://github.com/jboss-javassist/javassist/compare/rel_3_21_0_ga...rel_3_22_0_ga>`_
2648
2649 * lmax-disruptor 3.3.7 → 3.3.10; release notes:
2650
2651   * `3.3.8 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.8>`_
2652   * `3.3.9 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.9>`_
2653   * `3.3.10 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.10>`_
2654
2655 * Netty 4.1.16 → 4.1.22; release notes:
2656
2657   * `4.1.17 <http://netty.io/news/2017/11/08/4-0-53-Final-4-1-17-Final.html>`_
2658   * `4.1.18 <http://netty.io/news/2017/12/11/4-0-54-Final-4-1-18-Final.html>`_
2659   * `4.1.19 <http://netty.io/news/2017/12/18/4-1-19-Final.html>`_
2660   * `4.1.20 <http://netty.io/news/2018/01/22/4-0-55-Final-4-1-20-Final.html>`_
2661   * `4.1.21 <http://netty.io/news/2018/02/05/4-0-56-Final-4-1-21-Final.html>`_
2662   * `4.1.22 <http://netty.io/news/2018/02/21/4-1-22-Final.html>`_
2663
2664 * Scala `2.12.4 → 2.12.5 <http://www.scala-lang.org/news/2.12.5>`_
2665
2666 * Typesafe Config `0.2.1 → 0.2.2 <https://github.com/typesafehub/config/blob/master/NEWS.md>`_
2667
2668 The following Maven plugins have been upgraded:
2669
2670 * FindBugs 3.0.4 → 3.0.5
2671
2672 * Git commit id 2.2.2 → 2.2.4; release notes:
2673
2674   * `2.2.3 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.3>`_
2675   * `2.2.4 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.4>`_
2676
2677 Version 3.0.3
2678 -------------
2679
2680 This version fixes the following issues:
2681
2682 * `ODLPARENT-136`_: ``features-test`` needs ``org.osgi.compendium``.
2683
2684 * Jackson dependencies are declared using ``jackson-bom`` to ensure all they
2685   remain consistent.
2686
2687 * ``find-duplicate-classpath-entries`` is run in the “verify” phase rather than
2688   the “validate” phase, which is too early.
2689
2690 * The version of Jetty we pull in is now aligned with that declared in Karaf,
2691   resolving a number of restart and dependency issues.
2692
2693 * Pulling in the ``wrap`` feature unconditionally is no longer necessary, so
2694   ``karaf4-parent`` no longer does so.
2695
2696 * ``metainf-services`` are declared with scope “provided” to avoid their being
2697   included in downstream features (it’s a build-time dependency only).
2698
2699 * ``leveldb-api`` is excluded from ``odl-akka-leveldb-0.7``, and ``jsr250-api``
2700   from ``enunciate-core-annotations``, to avoid duplicate having classes on the
2701   classpath.
2702
2703 * Since the ``ssh`` feature is excluded from generated features, our Karaf
2704   need to enable it at boot in all cases.
2705
2706 * ``bundle-test-lib`` is now a bundle.
2707
2708 * Since we use static SLF4J loggers, the ``SLF4J_LOGGER_SHOULD_BE_NON_STATIC``
2709   rule needs to be disabled in our FindBugs configuration (this allows
2710   downstream projects to enable ``findbugs-slf4j`` without having to deal with
2711   all the resulting false-positives).
2712
2713 * ``org.apache.karaf.scr.management`` is white-listed in SFT to avoid failures
2714   apparently related to that component (which we don’t care about).
2715
2716 .. _ODLPARENT-136: https://jira.opendaylight.org/browse/ODLPARENT-136
2717
2718 This version upgrades the following third-party dependencies:
2719
2720 * `Antlr 4.7 → 4.7.1`_
2721
2722 * `BouncyCastle 1.58 → 1.59`_
2723
2724 * Jersey 1.17 → 1.19.4 (additionally available as the ``odl-jersey-1`` feature)
2725
2726 * Jolokia 1.3.7 → 1.5.0
2727
2728 * Karaf 4.1.3 → 4.1.5; release notes:
2729
2730   * `Karaf 4.1.4`_
2731   * `Karaf 4.1.5`_
2732
2733 .. _Antlr 4.7 → 4.7.1: https://github.com/antlr/antlr4/releases/tag/4.7.1
2734 .. _BouncyCastle 1.58 → 1.59: https://www.bouncycastle.org/releasenotes.html
2735 .. _Karaf 4.1.4: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12341702
2736 .. _Karaf 4.1.5: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342294
2737
2738 Version 3.0.2
2739 -------------
2740
2741 This version fixes the following issues:
2742
2743 * SingleFeatureTest uses the configured local Maven repository for Pax Exam.
2744
2745 * JavaDoc links are disabled for now to `speed up builds`_. A new
2746   ``javadoc-links`` profile enables the links.
2747
2748 * Conditional feature dependencies are processed, ensuring our
2749   `distribution is complete`_.
2750
2751 * Startup features are `adjusted for Karaf 4.1`_, avoiding unnecessary
2752   refreshes.
2753
2754 * The ``hiddenField`` Checkstyle check is disabled for abstract methods.
2755
2756 * The default logging configuration uses Log4J2, which is the new default in
2757   Karaf 4.1.
2758
2759 .. _speed up builds: https://jira.opendaylight.org/browse/ODLPARENT-121
2760 .. _distribution is complete: https://jira.opendaylight.org/browse/ODLPARENT-133
2761 .. _adjusted for Karaf 4.1: https://jira.opendaylight.org/browse/ODLPARENT-134
2762
2763 This version upgrades the following dependencies or plugins:
2764
2765 * ``maven-enforcer-plugin`` 1.4.1 → 3.0.0-M1
2766
2767 * ``maven-javadoc-plugin`` 3.0.0-M1 → 3.0.0
2768
2769 Version 3.0.1
2770 -------------
2771
2772 This version fixes the following issues:
2773
2774 * Karaf pulls in an invalid Hibernate feature repository, breaking downstream
2775   dependencies pulling in the “war” feature. ``populate-local-repo`` corrects
2776   the repository dependency.
2777
2778
2779 Version 3.0.0
2780 -------------
2781
2782 Compiler settings
2783 ~~~~~~~~~~~~~~~~~
2784
2785 Build now show compiler warnings and deprecation warnings. This doesn't affect
2786 the result or require any changes currently, it just makes the issues more
2787 visible.
2788
2789 New Checkstyle rules
2790 ~~~~~~~~~~~~~~~~~~~~
2791
2792 Checkstyle has been upgraded from 7.6 to 8.4 (see the
2793 `Checkstyle release notes`_ for details), and Sevntu from 1.21.0 to 1.24.2
2794 (note that the latter's group identifier changed from
2795 ``com.github.sevntu.checkstyle`` to ``com.github.sevntu-checkstyle``; you
2796 might need to update your IDE's configuration).
2797
2798 The following Checkstyle rules are enabled; this might require changes in
2799 projects which enforce Checkstyle validation:
2800
2801 * `AvoidHidingCauseExceptionCheck`_
2802 * `FinalClass`_: utility classes must be declared ``final``
2803 * `HiddenField`_: fields must not be shadowed
2804 * `HideUtilityClassConstructor`_: utility classes must hide their constructor
2805
2806 .. _Checkstyle release notes: http://checkstyle.sourceforge.net/releasenotes.html
2807
2808 .. _AvoidHidingCauseExceptionCheck: http://sevntu-checkstyle.github.io/sevntu.checkstyle/apidocs/com/github/sevntu/checkstyle/checks/coding/AvoidHidingCauseExceptionCheck.html
2809 .. _FinalClass: http://checkstyle.sourceforge.net/config_design.html#FinalClass
2810 .. _HiddenField: http://checkstyle.sourceforge.net/config_coding.html#HiddenField
2811 .. _HideUtilityClassConstructor: http://checkstyle.sourceforge.net/config_design.html#HideUtilityClassConstructor
2812
2813 Karaf
2814 ~~~~~
2815
2816 Karaf has been upgraded to 4.1.3. This should be transparent for dependent
2817 projects.
2818
2819 Karaf distributions
2820 ~~~~~~~~~~~~~~~~~~~
2821
2822 * When building a Karaf distribution using ``karaf4-parent``, projects can
2823   specify which archives to build: the ``karaf.archiveZip`` property will
2824   enable ZIP files if true, and ``karaf.archiveTarGz`` will enable
2825   gzip-compressed tarballs if true. By default both are enabled.
2826
2827 * Our Karaf distribution provides Bouncy Castle at startup. Auto-generated
2828   feature descriptors take this into account (they won't embed a Bouncy
2829   Castle dependency).
2830
2831 Feature removals
2832 ~~~~~~~~~~~~~~~~
2833
2834 * The ``odl-triemap-0.2`` feature wrapping
2835   ``com.github.romix:java-concurrent-hash-trie-map`` was rendered obsolete by
2836   YANG Tools' implementation and has been removed.
2837
2838 Feature additions
2839 ~~~~~~~~~~~~~~~~~
2840
2841 * ``odl-javassist-3`` provides Javassist in a feature.
2842
2843 * ``odl-jung-2.1`` provides `JUNG`_ in a feature.
2844
2845 .. _JUNG: http://jung.sourceforge.net/
2846
2847 Upstream version upgrades
2848 ~~~~~~~~~~~~~~~~~~~~~~~~~
2849
2850 The following upstream dependencies have been upgraded:
2851
2852 * Akka 2.4.18 → 2.5.4; release notes:
2853
2854   * `Akka 2.5.0`_
2855   * `Akka 2.5.1`_
2856   * `Akka 2.5.2`_
2857   * `Akka 2.5.3`_
2858   * `Akka 2.5.4`_
2859
2860 * `Awaitility 2 → 3`_
2861
2862 * `Bouncy Castle 1.57 → 1.58`_
2863
2864 * `Commons Codec 1.10 → 1.11`_
2865
2866 * `Commons File Upload 1.3.2 → 1.3.3`_
2867
2868 * `Commons IO 2.5 → 2.6`_
2869
2870 * Eclipse JDT annotations 2.0.0 → 2.1.0
2871
2872 * Felix Dependency Manager 4.3.0 → 4.4.1
2873 * Felix Dependency Manager Shell 4.0.4 → 4.0.6
2874 * Felix Metatype 1.1.2 → 1.1.6
2875
2876 * `Google Truth 0.28 → 0.36`_ (with the Java 8 extensions)
2877
2878 * `Gson 2.7 → 2.8.2`_
2879
2880 * Guava 22 → 23.3 along with the associated feature name change from
2881   ``odl-guava-22`` to ``odl-guava-23`` (dependent packages *must* change their
2882   dependency); release notes:
2883
2884   * `Guava 23`_
2885   * `Guava 23.1`_
2886   * `Guava 23.2`_
2887   * `Guava 23.3`_
2888
2889 * Immutables 2.4.2 → 2.5.6
2890
2891 * Jackson 2.3.2 → 2.8.9
2892
2893 * Jacoco 0.7.7 → 0.7.9; release notes:
2894
2895   * `Jacoco 0.7.8`_
2896   * `Jacoco 0.7.9`_
2897
2898 * Jacoco Listeners 2.4 → 3.8
2899
2900 * `Javassist 3.20.0 → 3.21.0`_
2901
2902 * `Jettison 1.3.7 → 1.3.8`_
2903
2904 * `Jolokia 1.3.6 → 1.3.7`_
2905
2906 * `JSONassert 1.3.0 → 1.5.0`_
2907
2908 * `logback 1.2.2 → 1.2.3`_
2909
2910 * `LMAX Disruptor 3.3.6 → 3.3.7`_
2911
2912 * Netty 4.1.8 → 4.1.16; release notes:
2913
2914   * `Netty 4.1.9`_
2915   * `Netty 4.1.10`_
2916   * `Netty 4.1.11`_
2917   * `Netty 4.1.12`_
2918   * `Netty 4.1.13`_
2919   * `Netty 4.1.14`_
2920   * `Netty 4.1.15`_
2921   * `Netty 4.1.16`_
2922
2923 * `Pax URL 2.5.2 → 2.5.3`_
2924
2925 * Scala 2.11.11 → 2.12.4; release notes:
2926
2927   * `Scala 2.12.0`_
2928   * `Scala 2.12.1`_
2929   * `Scala 2.12.2`_
2930   * `Scala 2.12.3`_
2931   * `Scala 2.12.4`_
2932
2933 * Servlet API 3.0.1 → 3.1.0
2934
2935 * `SLF4J 1.7.21 → 1.7.25`_
2936
2937 * `webcohesion enunciate 2.6.0 → 2.10.1`_
2938
2939 * `Xtend 2.12 → 2.13`_
2940
2941 .. _Akka 2.5.0: http://akka.io/blog/news/2017/04/13/akka-2.5.0-released
2942 .. _Akka 2.5.1: http://akka.io/blog/news/2017/05/02/akka-2.5.1-released
2943 .. _Akka 2.5.2: http://akka.io/blog/news/2017/05/24/akka-2.5.2-released
2944 .. _Akka 2.5.3: http://akka.io/blog/news/2017/06/19/akka-2.5.3-released
2945 .. _Akka 2.5.4: http://akka.io/blog/news/2017/08/10/akka-2.5.4-released
2946
2947 .. _Awaitility 2 → 3: https://github.com/awaitility/awaitility/wiki/ReleaseNotes30
2948
2949 .. _Bouncy Castle 1.57 → 1.58: https://www.bouncycastle.org/releasenotes.html
2950
2951 .. _Commons Codec 1.10 → 1.11: http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt
2952
2953 .. _Commons File Upload 1.3.2 → 1.3.3: http://www.apache.org/dist/commons/fileupload/RELEASE-NOTES.txt
2954
2955 .. _Commons IO 2.5 → 2.6: http://www.apache.org/dist/commons/io/RELEASE-NOTES.txt
2956
2957 .. _Google Truth 0.28 → 0.36: https://github.com/google/truth/releases
2958
2959 .. _Gson 2.7 → 2.8.2: https://github.com/google/gson/blob/master/CHANGELOG.md
2960
2961 .. _Guava 23: https://github.com/google/guava/wiki/Release23
2962 .. _Guava 23.1: https://github.com/google/guava/releases/tag/v23.1
2963 .. _Guava 23.2: https://github.com/google/guava/releases/tag/v23.2
2964 .. _Guava 23.3: https://github.com/google/guava/releases/tag/v23.3
2965
2966 .. _Jacoco 0.7.8: https://github.com/jacoco/jacoco/releases/tag/v0.7.8
2967 .. _Jacoco 0.7.9: https://github.com/jacoco/jacoco/releases/tag/v0.7.9
2968
2969 .. _Javassist 3.20.0 → 3.21.0: https://github.com/jboss-javassist/javassist/compare/rel_3_20_0_ga...rel_3_21_0_ga
2970
2971 .. _Jettison 1.3.7 → 1.3.8: https://github.com/jettison-json/jettison/compare/jettison-1.3.7...jettison-1.3.8
2972
2973 .. _Jolokia 1.3.6 → 1.3.7: https://github.com/rhuss/jolokia/releases/tag/v1.3.7
2974
2975 .. _JSONassert 1.3.0 → 1.5.0: https://github.com/skyscreamer/JSONassert/releases
2976
2977 .. _logback 1.2.2 → 1.2.3: https://logback.qos.ch/news.html
2978
2979 .. _LMAX Disruptor 3.3.6 → 3.3.7: https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.7
2980
2981 .. _Netty 4.1.9: http://netty.io/news/2017/03/10/4-0-45-Final-4-1-9-Final.html
2982 .. _Netty 4.1.10: http://netty.io/news/2017/04/30/4-0-46-Final-4-1-10-Final.html
2983 .. _Netty 4.1.11: http://netty.io/news/2017/05/12/4-0-47-Final-4-1-11-Final.html
2984 .. _Netty 4.1.12: http://netty.io/news/2017/06/09/4-0-48-Final-4-1-12-Final.html
2985 .. _Netty 4.1.13: http://netty.io/news/2017/07/06/4-0-49-Final-4-1-13-Final.html
2986 .. _Netty 4.1.14: http://netty.io/news/2017/08/03/4-0-50-Final-4-1-14-Final.html
2987 .. _Netty 4.1.15: http://netty.io/news/2017/08/25/4-0-51-Final-4-1-15-Final.html
2988 .. _Netty 4.1.16: http://netty.io/news/2017/09/25/4-0-52-Final-4-1-16-Final.html
2989
2990 .. _Pax URL 2.5.2 → 2.5.3: https://ops4j1.jira.com/browse/PAXURL-345?jql=project%20%3D%20PAXURL%20AND%20fixVersion%20%3D%202.5.3
2991
2992 .. _Scala 2.12.0: https://github.com/scala/scala/releases/tag/v2.12.0
2993 .. _Scala 2.12.1: https://github.com/scala/scala/releases/tag/v2.12.1
2994 .. _Scala 2.12.2: https://github.com/scala/scala/releases/tag/v2.12.2
2995 .. _Scala 2.12.3: https://github.com/scala/scala/releases/tag/v2.12.3
2996 .. _Scala 2.12.4: https://github.com/scala/scala/releases/tag/v2.12.4
2997
2998 .. _SLF4J 1.7.21 → 1.7.25: https://www.slf4j.org/news.html
2999
3000 .. _webcohesion enunciate 2.6.0 → 2.10.1: https://github.com/stoicflame/enunciate/releases
3001
3002 .. _Xtend 2.12 → 2.13: https://www.eclipse.org/xtend/releasenotes.html
3003
3004 Upstream version additions
3005 ~~~~~~~~~~~~~~~~~~~~~~~~~~
3006
3007 The following upstream dependencies have been added to dependency management:
3008
3009 * Commons Text, ``org.apache.commons:commons-text`` (this will allow downstreams
3010   to migrate from ``commons-lang3``\’s ``WordUtils``, which is deprecated)
3011
3012 Upstream version removals
3013 ~~~~~~~~~~~~~~~~~~~~~~~~~
3014
3015 The following upstream dependencies have been removed from dependency
3016 management (they are obsolete and unused):
3017
3018 * Chameleon MBeans
3019 * Eclipse Link
3020 * Equinox HTTP service bridge
3021 * ``equinoxSDK381`` artifacts
3022 * Coda Hale Metrics, which are mostly unused and should eventually be wrapped
3023   by InfraUtils
3024 * ``com.google.code.findbugs:jsr305`` (which *must not* be used; this is
3025   enforced — ``annotations`` should be used instead)
3026 * Felix File Install and Web Console
3027 * Gemini Web
3028 * Orbit
3029 * ``org.mockito:mockito-all`` (which *must not* be used; this is enforced —
3030   ``mockito-core`` should be used instead)
3031 * Spring Framework
3032 * ``txw2``
3033 * Xerces
3034 * ``xml-apis``
3035
3036 Plugin version upgrades
3037 ~~~~~~~~~~~~~~~~~~~~~~~
3038
3039 The following plugins have been upgraded:
3040
3041 * ``org.apache.servicemix.tooling:depends-maven-plugin`` 1.3.1 → 1.4.0
3042 * ``org.apache.felix:maven-bundle-plugin`` 2.4.0 → 3.3.0
3043 * ``maven-compiler-plugin`` 3.6.1 → 3.7.0
3044 * ``maven-dependency-plugin`` 3.0.1 → 3.0.2
3045 * ``maven-enforcer-plugin`` 1.4.1 → 3.0.0-M1
3046 * ``maven-failsafe-plugin`` 2.18.1 → 2.20.1
3047 * ``maven-javadoc-plugin`` 2.10.4 → 3.0.0-M1
3048 * ``maven-shade-plugin`` 2.4.3 → 3.1.0
3049
3050 New plugins
3051 ~~~~~~~~~~~
3052
3053 * The `Maven Find Duplicates`_ plugin can be enabled by setting the
3054   ``duplicate-finder.skip`` property to ``false``.
3055
3056 * The SpotBugs_ Maven plugin can now be used instead of the FindBugs plugin
3057   (both are available, so no change is required). To use SpotBugs, replace
3058   ``org.codehaus.mojo:findbugs-maven-plugin`` with
3059   ``com.github.spotbugs:spotbugs-maven-plugin``.
3060
3061 .. _Maven Find Duplicates: https://github.com/basepom/duplicate-finder-maven-plugin/
3062
3063 .. _SpotBugs: https://spotbugs.github.io/