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