1 ========================
2 ODL Parent release notes
3 ========================
7 This is a bug-fix upgrade from version 6.0.3.
11 * ``single-feature-test`` was using outdated repositories, including Maven Central,
12 which `broke on Jan 15, 2020 <https://support.sonatype.com/hc/en-us/articles/360041287334-Central-501-HTTPS-Required>`__.
13 This has been corrected.
15 Third-party dependencies
16 ~~~~~~~~~~~~~~~~~~~~~~~~
18 * JUnit 4.11 → 4.13, release notes:
19 * `4.12 <https://github.com/junit-team/junit4/blob/master/doc/ReleaseNotes4.12.md>`__
20 * `4.13 <https://github.com/junit-team/junit4/blob/master/doc/ReleaseNotes4.13.md>`__
22 * log4j2 2.11.2 → 2.13.0, release notes:
23 * `2.12.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.0>`__
24 * `2.12.1 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.12.1>`__
25 * `2.13.0 <https://logging.apache.org/log4j/2.x/changes-report.html#a2.13.0>`__
27 * netty 4.1.42 → 4.1.45, release notes:
28 * `4.1.43 <https://netty.io/news/2019/10/24/4-1-43-Final.html>`__
29 * `4.1.44 <https://netty.io/news/2019/12/18/4-1-44-Final.html>`__
30 * `4.1.45 <https://netty.io/news/2020/01/13/4-1-45-Final.html>`__
34 * maven-assembly-plugin 2.2-beta5 → 3.2.0
36 * maven-archetype-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12345957>`__
40 This is a bug-fix upgrade from version 6.0.2.
44 * The fix for `ODLPARENT-216 <https://jira.opendaylight.org/browse/ODLPARENT-216>`__ ended up
45 breaking ``org.kohsuke.metainf-services`` integration. While this could be fixed in downstreams
46 by adding proper </annotationProcessorPaths> entry, it is a regression from 6.0.1.
50 This is a security/bug-fix upgrade from version 6.0.1.
54 * ``single-feature-parent`` was setting up Karaf repositories incorrectly, leading to
55 the test using unpatched Karaf resources. This has now been fixed and the test run
56 is using environment equivalent to the contents of the distribution. See
57 `ODLPARENT-209 <https://jira.opendaylight.org/browse/ODLPARENT-209>`__ for details.
59 * ``immutables.org`` integration relied on pre-JDK9 way of integration, where the annotation processor
60 was just dropped as a dependency. This does not work with JDK9+ artifacts which are also explicit
61 JMPS modules. Note that users are advised to switch to depending on the ``annotations``-classified
62 artifact. See `ODLPARENT-216 <https://jira.opendaylight.org/browse/ODLPARENT-216>`__ for details.
64 * Assembled Karaf distribution did not perform proper JDK checks and allowed launching with JDK8,
65 leading to a failure to install OpenDaylight components with an error stack, which confuses users
66 not familiar with OSGi. The distribution now refuses to start with anything other than JDK11. See
67 `ODLPARENT-218 <https://jira.opendaylight.org/browse/ODLPARENT-218>`__ for details.
69 Third-party dependencies
70 ~~~~~~~~~~~~~~~~~~~~~~~~
72 * Akka `2.5.25 → 2.5.26 <https://akka.io/blog/news/2019/10/17/akka-2.5.26-released>`__
74 * Checkstyle 8.20 → 8.26, release notes:
75 * `8.21 <https://checkstyle.org/releasenotes.html#Release_8.21>`__
76 * `8.22 <https://checkstyle.org/releasenotes.html#Release_8.22>`__
77 * `8.23 <https://checkstyle.org/releasenotes.html#Release_8.23>`__
78 * `8.24 <https://checkstyle.org/releasenotes.html#Release_8.24>`__
79 * `8.25 <https://checkstyle.org/releasenotes.html#Release_8.25>`__
80 * `8.26 <https://checkstyle.org/releasenotes.html#Release_8.26>`__
82 * H2 database `1.4.199 → 1.4.200 <http://www.h2database.com/html/changelog.html>`__
84 * Hamcrest `2.1 → 2.2 <https://github.com/hamcrest/JavaHamcrest/releases/tag/v2.2>`__
86 * JaCoCo `0.8.4 → 0.8.5 <https://github.com/jacoco/jacoco/releases/tag/v0.8.5>`__
88 * Karaf 4.2.2 → 4.2.6, release notes:
89 * `4.2.3 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12344587>`__
90 * `4.2.4 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12344856>`__
91 * `4.2.5 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345153>`__
92 * `4.2.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12345365>`__
94 * Powermock `2.0.2 → 2.0.4 <https://github.com/powermock/powermock/blob/release/2.x/docs/release-notes/official.md#204>`__
96 * Sevntu `1.35.0 → 1.36.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.36.0>`__
101 * maven-bundle-plugin `4.1.0 → 4.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12345491>`__
103 * maven-jar-plugin `3.1.2 → 3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12345503>`__
105 * maven-source-plugin `3.1.0 → 3.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12345522>`__
107 * modernizer-maven-plugin `1.9.0 → 2.0.0 <https://github.com/gaul/modernizer-maven-plugin/releases/tag/modernizer-maven-plugin-2.0.0>`__
111 This is a security/bug-fix upgrade from version 6.0.0.
115 * ``karaf-plugin`` ignored exceptions coming from its failure to resolve ${karaf.etc} variable. This
116 has now been fixed and the URL handling has been revised to fix build on Windows. See
117 `ODLPARENT-214 <https://jira.opendaylight.org/browse/ODLPARENT-214>`__ for details.
119 * ``leveldb-jni`` jar, which has been seeded to nexus.opendaylight.org long time ago is not published
120 in Maven Central. This has been resolved by repackaging this jar and publishing it from odlparent.
121 See `ODLPARENT-210 <https://jira.opendaylight.org/browse/ODLPARENT-210>`__ for details.
123 Third-party dependencies
124 ~~~~~~~~~~~~~~~~~~~~~~~~
126 * Bouncy Castle `1.63 → 1.64 <http://www.bouncycastle.org/releasenotes.html>`__
128 * Jackson `2.9.9 → 2.9.10 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.10>`__
130 * Javassist 3.24.1-GA → 3.26.0-GA
132 * Guice 4.1.0 → 4.2.2, release notes:
133 * `4.2.0 <https://github.com/google/guice/wiki/Guice42>`__
134 * `4.2.1 <https://github.com/google/guice/wiki/Guice421>`__
135 * `4.2.2 <https://github.com/google/guice/wiki/Guice422>`__
137 * Mockito 2.25.1 → 2.28.2, release notes:
138 * `2.25.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2252>`__
139 * `2.25.3 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2253>`__
140 * `2.25.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2254>`__
141 * `2.25.5 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2255>`__
142 * `2.25.6 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2256>`__
143 * `2.25.7 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2257>`__
144 * `2.26.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2261>`__
145 * `2.26.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2262>`__
146 * `2.27.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2271>`__
147 * `2.27.2 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2272>`__
148 * `2.27.3 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2273>`__
149 * `2.27.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2274>`__
150 * `2.27.5 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2275>`__
151 * `2.28.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2280>`__
153 * Netty 4.1.39 → 4.1.42, release notes:
154 * `4.1.41 <https://netty.io/news/2019/09/12/4-1-41-Final.html>`__
155 * `4.1.42 <https://netty.io/news/2019/09/25/4-1-42-Final.html>`__
157 * pt-triemap `1.0.6 → 1.1.0 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.1.0>`__
159 * reactive-streams `1.0.2 → 1.0.3 <http://www.reactive-streams.org/announce-1.0.3>`__
161 * stax2-api `3.1.4 → 4.2 <https://github.com/FasterXML/stax2-api/blob/master/release-notes/VERSION>`__
163 * woodstox-core 5.0.3 → 5.3.0, release notes:
164 * `5.1.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.1>`__
165 * `5.2.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.2>`__
166 * `5.3.0 <https://github.com/FasterXML/woodstox/wiki/Woodstox-Release-5.3>`__
170 This is a major upgrade from version 5, with breaking changes; projects will
171 need to make changes to upgrade to this version.
175 This release sets ``maven.compiler.release=11`` and enforces that the JDK used to build
176 is Java 11+. As there may be issues with various maven plugins when faced with JDK9+
177 constructs and JDK11+ classes, target release can be controlled on a per-artifact
178 basis (i.e. target Java 10 with ``maven.compiler.release=10`` property).
180 This release has been validated with ``openjdk-11.0.4`` and is not supported on any lower
181 version. As usual, we recommend using latest available JDK/JRE for Java 11 during development
184 Checkstyle/SpotBugs/Modernizer run by default
185 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
186 With this release code artifacts always run ``maven-checkstyle-plugin``, ``spotbugs-maven-plugin``
187 and ``modernizer-maven-plugin``. Checkstyle and SpotBugs run in enforcing mode, i.e. will fail
188 build if any violations are found. Modernizer is configured to report Java 8-compatible constructs
189 and will not fail the build unless instructed to do so.
191 Behavior of each of these is controlled via a maven property on a per-artifact basis:
193 * ``odlparent.checkstyle.enforce`` controls checkstyle enforcement: defaults to ``true``, but can be set to ``false``
194 * ``odlparent.checkstyle.skip`` controls checkstyle invocation: defaults to ``false``, but can be set to ``true``
195 * ``odlparent.spotbugs.enforce`` controls SpotBugs enforcement: defaults to ``true``, but can be set to ``false``
196 * ``odlparent.spotbugs.skip`` controls SpotBugs invocation: defaults to ``false``, but can be set to ``true``
197 * ``odlparent.modernizer.enforce`` controls modernizer enforcement: defaults to ``false``, but can be set to ``true``
198 * ``odlparent.modernizer.skip`` controls modernizer invocation: defaults to ``false``, but can be set to ``true``
199 * ``odlparent.modernizer.target`` controls modernizer Java version: defaults to ``1.8``, but can be set to ``1.11`` or similar
204 * ``blueprint container`` had ``org.apache.aries.blueprint.preemptiveShutdown`` set to false
205 to enable it to work with Config Subsystem. As that component is long gone, this property has
206 been removed as part of `ODLPARENT-34 <https://jira.opendaylight.org/browse/ODLPARENT-34>`__.
207 Furthermore, system properties related to Config Subsystem/NETCONF integration have been removed
210 Upstream version removals
211 ~~~~~~~~~~~~~~~~~~~~~~~~~
213 The following upstream dependencies have been removed from dependency management:
215 * com.google.code.findbugs/jsr305
217 Third-party dependencies
218 ~~~~~~~~~~~~~~~~~~~~~~~~
220 The dependency on `xmlunit-assertj` and `modernizer-maven-annotations` has been added and the following
221 dependencies have been upgraded:
223 * Akka 2.5.23 → 2.5.25, release notes:
224 * `2.5.24 <https://akka.io/blog/news/2019/08/09/akka-2.5.24-released>`__
225 * `2.5.25 <https://akka.io/blog/news/2019/08/20/akka-2.5.25-released>`__
227 * apache-sshd `2.2.0 → 2.3.0 <https://github.com/apache/mina-sshd/blob/master/docs/changes/2.3.0.md>`__
229 * Bouncy Castle `1.62 → 1.63 <https://www.bouncycastle.org/releasenotes.html>`__
231 * commons-beanutils `1.9.3 → 1.9.4 <https://www.apache.org/dist/commons/beanutils/RELEASE-NOTES.txt>`__
233 * commons-codec `1.12 → 1.13 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
235 * commons-text 1.6 → 1.8, release notes:
236 * `1.7 <https://commons.apache.org/proper/commons-text/changes-report.html#a1.7>`__
237 * `1.8 <https://commons.apache.org/proper/commons-text/changes-report.html#a1.8>`__
239 * Checkstyle 8.18 → 8.20, release notes:
240 * `8.19 <https://checkstyle.org/releasenotes.html#Release_8.19>`__
241 * `8.20 <https://checkstyle.org/releasenotes.html#Release_8.20>`__
243 * jackson-databind `2.9.9 → 2.9.9.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9#micro-patches>`__
245 * jaxb-api 2.2.8 → 2.3.0, aligning it with Karaf-provided version
247 * Netty 4.1.36 → 4.1.39, release notes:
248 * `4.1.37 <https://netty.io/news/2019/06/28/4-1-37-Final.html>`__
249 * `4.1.38 <https://netty.io/news/2019/07/24/4-1-38-Final.html>`__
250 * `4.1.39 <https://netty.io/news/2019/08/13/4-1-39-Final.html>`__
252 * Sevntu 1.32.0 → 1.35.0, release notes:
253 * `1.33.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
254 * `1.34.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.34.0>`__
255 * `1.34.1 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.34.1>`__
256 * `1.35.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.35.0>`__
258 * Scala 2.12.8 → 2.12.9, release notes:
259 * `2.12.9 <https://github.com/scala/scala/releases/tag/v2.12.9>`__
260 * `2.12.10 <https://github.com/scala/scala/releases/tag/v2.12.10>`__
262 * slf4j `1.7.25 → 1.7.28 <https://www.slf4j.org/news.html>`__
264 * triemap `1.0.5 → 1.0.6 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.0.6>`__
266 * typesafe/ssl-config `0.3.7 → 0.3.8 <https://github.com/lightbend/ssl-config/compare/v0.3.7...v0.3.8>`__
268 * Xtend 1.17.1 → 1.19.0, release notes:
269 * `1.18.0 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/06/04/version-2-18-0>`__
270 * `1.19.0 <https://www.eclipse.org/Xtext/releasenotes.html#/releasenotes/2019/09/03/version-2-19-0>`__
275 * git-commit-id-plugin 2.2.6 → 3.0.1, release notes:
276 * `3.0.0 <https://github.com/git-commit-id/maven-git-commit-id-plugin/releases/tag/v3.0.0>`__
277 * `3.0.1 <https://github.com/git-commit-id/maven-git-commit-id-plugin/releases/tag/v3.0.1>`__
279 * maven-javadoc-plugin `3.1.0 → 3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12345060>`__
281 * pmd-maven-plugin `3.11.0 → 3.12.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-version1>`__
283 * spotbugs-maven-plugin 3.1.11 → 3.1.12.2, release notes:
284 * `3.1.12 <https://github.com/spotbugs/spotbugs-maven-plugin/compare/spotbugs-maven-plugin-3.1.11...spotbugs-maven-plugin-3.1.12>`__
285 * `3.1.12.1 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-3.1.12.1>`__
286 * `3.1.12.2 <https://github.com/spotbugs/spotbugs-maven-plugin/releases/tag/spotbugs-maven-plugin-3.1.12.2>`__
291 This is a bug-fix upgrade from version 5.0.0.
293 Third-party dependencies
294 ~~~~~~~~~~~~~~~~~~~~~~~~
296 The following dependencies have been upgraded:
298 * Akka 2.5.21 → 2.5.23, release notes:
299 * `2.5.22 <https://akka.io/blog/news/2019/04/03/akka-2.5.22-released>`__
300 * `2.5.23 <https://akka.io/blog/news/2019/05/21/akka-2.5.23-released>`__
302 * asciidoctorj-diagram 1.5.12 → 1.5.16
304 * Bouncy Castle `1.61 → 1.62 <http://www.bouncycastle.org/releasenotes.html>`__
306 * commons-lang3 `3.8.1 → 3.9 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__
308 * JaCoCo `0.8.3 → 0.8.4 <https://github.com/jacoco/jacoco/releases/tag/v0.8.4>`__
310 * Jackson `2.9.8 → 2.9.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.9>`__
312 * Jolokia 1.6.0 → 1.6.2, release notes:
313 * `1.6.1 <https://jolokia.org/changes-report.html#a1.6.1>`__
314 * `1.6.2 <https://jolokia.org/changes-report.html#a1.6.2>`__
316 * Mockito `2.25.0 → 2.25.1 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2251>`__
318 * Netty 4.1.34 → 4.1.36, release notes:
319 * `4.1.35 <https://netty.io/news/2019/04/17/4-1-35-Final.html>`__
320 * `4.1.36 <https://netty.io/news/2019/04/30/4-1-36-Final.html>`__
322 * PowerMock 2.0.0 → 2.0.2, release notes:
323 * `2.0.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.1>`__
324 * `2.0.2 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.2>`__
326 * Reactive Streams `1.0.1 → 1.0.2 <https://www.lightbend.com/blog/update-reactive-streams-102-released>`__
328 * scala-parser-combinators `1.1.1 → 1.1.2 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.2>`__
330 * Sevntu `1.32.0 → 1.33.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.33.0>`__
332 * Typesafe Config `1.3.2 → 1.3.3 <https://github.com/lightbend/config/releases/tag/v1.3.3>`__
334 * triemap `1.0.4 → 1.0.5 <https://github.com/PantheonTechnologies/triemap/releases/tag/triemap-1.0.5>`__
336 * XBean finder 4.12 → 4.14, release notes:
337 * `4.13 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12344253&projectId=12310312>`__
338 * `4.14 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310312&version=12345220>`__
340 * xmlunit `2.6.2 → 2.6.3 <https://github.com/xmlunit/xmlunit/releases/tag/v2.6.3>`__
342 * Xtend `2.17.0 → 2.17.1 <https://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/04/03/version-2-17-1>`__
347 * maven-archetype-plugin 3.0.1 → 3.1.1, release notes:
348 * `3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12340346>`__
349 * `3.1.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317122&version=12345450>`__
351 * maven-bundle-plugin `4.1.0 → 4.2.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310100&version=12345047>`__
353 * maven-checkstyle-plugin `3.1.0 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317223&version=12342397>`__
355 * maven-compiler-plugin `3.8.0 → 3.8.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317225&version=12343484>`__
357 * 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/>`__
359 * maven-jar-plugin `3.1.1 → 3.1.2 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317526&version=12344629>`__
361 * maven-plugin-plugin `3.5.2 → 3.6.0 <https://blogs.apache.org/maven/entry/apache-maven-plugin-tools-version1>`__
363 * maven-source-plugin `3.0.1 → 3.1.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317924&version=12336941>`__
365 * maven-surefire-plugin 2.22.1 → 2.22.2
370 * ``modernizer-maven-plugin`` declared, allowing downstreams to more easily activate it,
371 and so detect code which should be updated to more modern equivalent.
376 * ``odl-caffeine-2`` provides a pre-packaged feature for the Caffeine caching framework,
377 along with the Guava compabitility layer.
382 This is a major upgrade from version 4, with breaking changes; projects will
383 need to make changes to upgrade to this version.
385 The most significant change is `ODLPARENT-198 <https://jira.opendaylight.org/browse/ODLPARENT-198>`__,
386 which removes JSR305 from default dependencies and does not present it at class path by default.
391 ``findbugs`` has been removed, as its only purpose was to provide FindBugs
392 rule definitions. Equivalent definitions are available in ``spotbugs``.
397 * ``blueprint-maven-plugin`` used to scan the entire classpath, resulting in potential conflicts
398 across projects. Scanning is now limited to ``${project.groupId}``, limiting conflict domain
399 to single project. See `ODLPARENT-109 <https://jira.opendaylight.org/browse/ODLPARENT-109>`__.
401 * ``bundle-maven-plugin`` configuration ignored generated ServiceLoader service entries,
402 which has now been fixed. See `ODLPARENT-197 <https://jira.opendaylight.org/browse/ODLPARENT-197>`__.
404 * Bundle tests are now enabled by default. See `ODLPARENT-158 <https://jira.opendaylight.org/browse/ODLPARENT-158>`__
405 and `ODLPARENT-80 <https://jira.opendaylight.org/browse/ODLPARENT-80>`__ for details.
407 * Karaf log file rollover was not explictly set up, leading to inability to easily override
408 the defaults. See `ODLPARENT-153 <https://jira.opendaylight.org/browse/ODLPARENT-153>`__ for details.
410 * Karaf log file used to use default maximum 16MiB file size, this has now been increased to 64MiB.
411 See `ODLPARENT-154 <https://jira.opendaylight.org/browse/ODLPARENT-154>`__.
413 * ``features-test`` excluded opendaylight-karaf-empty's transitive dependencies, leading
414 to the need to re-declare them in single-feature-parent. This re-declaration was forgotten
415 in for ``bcpkix-framework-ext`` and ``bcprov-framework-ext`` bundles, which lead to them
416 not being present in the local repository. See `ODLPARENT-130 <https://jira.opendaylight.org/browse/ODLPARENT-130>`__.
418 Upstream version removals
419 ~~~~~~~~~~~~~~~~~~~~~~~~~
421 The following upstream dependencies have been removed from dependency management:
423 * cassandra-driver-core
425 * org.codehaus.enunciate/enunciate-core-annotations
427 * org.jboss.resteasy/jaxrs-api
431 * org.osgi/org.osgi.compendium
438 * ``features-akka`` feature repository has been integrated into ``features-odlparent``
440 Third-party dependencies
441 ~~~~~~~~~~~~~~~~~~~~~~~~
443 The following dependencies have been upgraded:
445 * apache-sshd `2.0.0 → 2.2.0 <https://github.com/apache/mina-sshd/compare/sshd-2.0.0...sshd-2.2.0>`__
447 * Aeron 1.12.0 → 1.15.3, release notes:
448 * `1.13.0 <https://github.com/real-logic/aeron/releases/tag/1.13.0>`__
449 * `1.14.0 <https://github.com/real-logic/aeron/releases/tag/1.14.0>`__
450 * `1.15.0 <https://github.com/real-logic/aeron/releases/tag/1.15.0>`__
451 * `1.15.1 <https://github.com/real-logic/aeron/releases/tag/1.15.1>`__
452 * `1.15.2 <https://github.com/real-logic/aeron/releases/tag/1.15.2>`__
453 * `1.15.3 <https://github.com/real-logic/aeron/releases/tag/1.15.3>`__
455 * Agrona 0.9.27 → 0.9.33, release notes:
456 * `0.9.28 <https://github.com/real-logic/agrona/releases/tag/0.9.28>`__
457 * `0.9.29 <https://github.com/real-logic/agrona/releases/tag/0.9.29>`__
458 * `0.9.30 <https://github.com/real-logic/agrona/releases/tag/0.9.30>`__
459 * `0.9.31 <https://github.com/real-logic/agrona/releases/tag/0.9.31>`__
460 * `0.9.32 <https://github.com/real-logic/agrona/releases/tag/0.9.32>`__
461 * `0.9.33 <https://github.com/real-logic/agrona/releases/tag/0.9.33>`__
463 * Akka 2.5.19 → 2.5.21, release notes:
464 * `2.5.20 <https://akka.io/blog/news/2019/01/29/akka-2.5.20-released>`__
465 * `2.5.21 <https://akka.io/blog/news/2019/02/13/akka-2.5.21-released>`__
467 * antl4r `4.7.1 → 4.7.2 <https://github.com/antlr/antlr4/releases/tag/4.7.2>`__
469 * asciidoctorj-diagram 1.5.11 → 1.5.12
471 * Bouncy Castle `1.60 → 1.61 <http://www.bouncycastle.org/releasenotes.html>`__
473 * checkstyle 8.16 → 8.18, release notes:
474 * `8.17 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.17>`__
475 * `8.18 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.18>`__
477 * commons-codec `1.11 → 1.12 <http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt>`__
479 * Google Error Prone 2.3.2 → 2.3.3
481 * Google Guava 25.1 → 27.1, release notes:
482 * `26.0 <https://github.com/google/guava/releases/tag/v26.0>`__
483 * `27.0 <https://github.com/google/guava/releases/tag/v27.0>`__
484 * `27.0.1 <https://github.com/google/guava/releases/tag/v27.0.1>`__
485 * `27.1 <https://github.com/google/guava/releases/tag/v27.1>`__
487 * Google Truth `0.42 → 0.43 <https://github.com/google/truth/releases/tag/release_0_43>`__
489 * h2 database `1.4.196 → 1.4.199 <http://www.h2database.com/html/changelog.html>`__
491 * Immutables `2.7.3 → 2.7.5 <https://github.com/immutables/immutables/#changelog>`__
493 * Javassist `3.24.0-GA → 3.24.1-GA <https://github.com/jboss-javassist/javassist/releases/tag/rel_3_24_1_ga>`__
495 * log4j2 `2.11.1 → 2.11.2 <https://github.com/apache/logging-log4j2/blob/log4j-2.11.2/RELEASE-NOTES.md>`__
497 * Mockito 2.23.4 → 2.25.0, release notes:
498 * `2.24.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2240>`__
499 * `2.25.0 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md#2250>`__
501 * Netty 4.1.32 → 4.1.34, release notes:
502 * `4.1.32 <https://netty.io/news/2018/11/29/4-1-32-Final.html>`__
503 * `4.1.33 <https://netty.io/news/2019/01/21/4-1-33-Final.html>`__
504 * `4.1.34 <https://netty.io/news/2019/03/08/4-1-34-Final.html>`__
508 * Powermockito 1.7.4 → 2.0.0, release notes:
509 * `2.0.0-beta.5 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-beta.5>`__
510 * `2.0.0-RC.1 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0-RC.1>`__
511 * `2.0.0 <https://github.com/powermock/powermock/releases/tag/powermock-2.0.0>`__
513 * SpotBugs `3.1.9 → 3.1.12 <https://github.com/spotbugs/spotbugs/blob/3.1.12/CHANGELOG.md>`__
515 * ThreeTen `1.4.0 → 1.5.0 <https://www.threeten.org/threeten-extra/changes-report.html#a1.5.0>`__
517 * Xtend `2.16.0 → 2.17.0 <http://www.eclipse.org/xtend/releasenotes.html#/releasenotes/2019/03/05/version-2-17-0>`__
524 * maven-findbugs-plugin
529 * jacoco-maven-plugin `0.8.2 → 0.8.3 <https://github.com/jacoco/jacoco/releases/tag/v0.8.3>`__
531 * 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>`__
533 * 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>`__
535 * spotbugs-maven-plugin 3.1.8 → 3.1.11
540 This is a bug-fix upgrade from version 4.0.8.
545 * ``karaf-plugin`` invocation in ``karaf4-parent`` caused previously
546 patched features to be overwritten with their stock versions, referencing
547 bundles which were not populated in the local repository. (See
548 `ODLPARENT-194 <https://jira.opendaylight.org/browse/ODLPARENT-194>`__.)
550 * ``karaf-plugin`` version in ``karaf4-parent`` is now provided through
551 plugin management so downstreams can override it without needing
552 to repeat its configuration.
554 * ``karaf-plugin`` no longer reads features twice when running discovery,
555 speeding up the process a bit.
557 * Recent versions of the SpotBugs Maven plugin use SLF4J 1.8 beta 2, which
558 can’t use the 1.7.25 implementation we provide; we therefore provide an
559 implementation of 1.8 beta 2 when SpotBugs is used. (See
560 `ODLPARENT-184 <https://jira.opendaylight.org/browse/ODLPARENT-184>`__.)
565 * ``odl-woodstox`` wraps the Woodstox StAX implementation which is imposed on
571 This is a bug-fix and minor upstream bump upgrade from version 4.0.7.
576 * ``bcprov-ext-jdk15on`` is a superset of ``bcprov-jdk15on``, so there’s no
577 need to ship both; we now only ship the former. In addition, we install the
578 Bouncy Castle JARs in ``lib/boot`` so that they continue to be available on
579 the boot classpath (JDK 9 removes the extension mechanism which was used
580 previously), and provide the corresponding bundles from the boot classpath
581 instead of using separate JARs in the system repository. (See
582 `ODLPARENT-183 <https://jira.opendaylight.org/browse/ODLPARENT-183>`__ and
583 `ODLPARENT-185 <https://jira.opendaylight.org/browse/ODLPARENT-185>`__.)
585 * A dependency check has been added to ensure that we don’t run into the
586 TrieMap dependency bug in 4.0.6 again.
588 * Dependencies pulled in by features are now checked for convergence, and
589 ``karaf-plugin`` warns when it finds diverging dependencies (the same
590 artifact with two different versions). Upstream-provided features are
591 patched to avoid the following divergences (and upgrade some dependencies in
594 * Aries utilities 1.1.0/1.1.3 (upgraded to 1.1.3).
595 * Commons Beanutils 1.8.3/1.9.3 (upgraded to 1.9.3).
596 * Commons Codec 1.8/1.10 (upgraded to 1.11).
597 * ``javax.mail`` 1.4.4/1.4.7 (upgraded to 1.4.7).
599 (See `ODLPARENT-189 <https://jira.opendaylight.org/browse/ODLPARENT-189>`__.)
604 * ``odl-dropwizard-metrics`` provides Dropwizard Metrics (which are also
605 available in dependency management).
607 * ``enunciate-maven-plugin`` is added as the replacement for
608 ``maven-enunciate-plugin``.
610 Third-party dependencies
611 ~~~~~~~~~~~~~~~~~~~~~~~~
613 The following dependencies are no longer provided by the JVM, starting with
614 version 11, but we make them available via dependency management for projects
617 * ``javax.annotation-api``.
619 * JAXB (``jaxb-core``, ``jaxb-impl``).
621 The following dependencies have been upgraded:
623 * Checkstyle `8.15 → 8.16 <https://checkstyle.org/releasenotes.html#Release_8.16>`__.
625 * Dependency Check `4.0.0 → 4.0.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
627 * ``git-commit-id`` `2.2.5 → 2.2.6 <https://github.com/ktoso/maven-git-commit-id-plugin/releases>`__.
629 * Immutables 2.7.1 → 2.7.3:
631 * `2.7.2 <https://github.com/immutables/immutables#272-2018-11-05>`__.
632 * `2.7.3 <https://github.com/immutables/immutables#273-2018-11-10>`__.
634 (2.7.4 breaks our Javadocs.)
636 * Jackson `2.9.7 → 2.9.8 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.8>`__.
641 This is a bug-fix release, correcting the ``triemap`` import declaration.
646 This is a bug-fix and minor upstream packaging upgrade from version 4.0.5.
651 Single-feature-test was broken with JDK 9 and later and Karaf 4.2.2; this
652 release adds the additional JVM configuration needed.
654 Third-party dependencies
655 ~~~~~~~~~~~~~~~~~~~~~~~~
657 This release adds the ``triemap`` BOM to dependency management.
662 This is a bug-fix release: the Karaf Maven plugin, in version 4.2.2, is
663 `broken <https://issues.apache.org/jira/browse/KARAF-6057>`__ in some cases we
664 need in OpenDaylight; we revert to 4.2.1 in ``karaf4-parent`` to avoid this.
669 This is a bug-fix release, reverting the change made in 4.0.3 to handle
670 building with either ``zip`` or ``tar.gz`` Karaf archives (which breaks
671 builds in our infrastructure, without the empty Karaf archive).
676 This is a bug-fix and minor upstream bump upgrade from version 4.0.2.
681 * Our FindBugs configuration for JDK 9 and later caused the plugin to run
682 everywhere; instead, this version defines the ``findbugs.skip`` property to
683 disable the plugin in modules where it would be used otherwise.
685 * The PowerMock declarations in dependency management missed
686 ``powermock-api-mockito2``, which is necessary for modules using PowerMock
689 * The “quick” profile (``-Pq``) now skips SpotBugs.
691 * JSR-305 annotations are now optional, which fixes a number of issues when
692 building with newer JDKs.
694 * We provide JAXB with JDK 11 and later (where it is no longer provided by the
697 * ``odlparent-artifacts`` has been updated to accurately represent the
700 * ``javax.activation`` is now excluded from generated features (it’s provided
701 on Karaf’s boot classpath).
703 * When the build is configured to build Karaf distributions in ``tar.gz``
704 archives, but not ``zip`` archives, ``features-test`` used to fail; it will
705 now used whichever is available
706 (`ODLPARENT-174 <https://jira.opendaylight.org/browse/ODLPARENT-174>`__).
708 * Explicit GCs are disabled by default, so that calls to ``System.gc()`` are
710 (`ODLPARENT-175 <https://jira.opendaylight.org/browse/ODLPARENT-175>`__).
712 * Null checks are disabled in SpotBugs because of bad interactions with newer
713 annotations and the bytecode produces by JDK 11 and later for
714 ``try``-with-resources.
716 * Akka Persistence expects LevelDB 0.10, so we now pull in that version
719 Dependency convergence
720 ~~~~~~~~~~~~~~~~~~~~~~
722 A number of dependencies have been added or constrained so that projects using
723 this parent can enforce dependency convergence:
725 * Karaf’s ``framework`` feature is used as an import POM, so that we converge
726 by default on the versions used in Karaf.
728 * The following dependencies have been added to dependency management:
730 * ``commons-beanutils``
731 * the Checker Framework
732 * Error Prone annotations
733 * ``javax.activation``
739 The following Karaf features have been added:
741 * ``odl-antlr4`` (providing ``antlr4-runtime``);
743 * ``odl-gson`` (providing ``gson``);
745 * ``odl-jersey-2`` (providing Jersey client, server, and container servlet,
746 along with the necessary feature dependencies);
748 * ``odl-servlet-api`` (providing ``javax.servlet-api``);
750 * ``odl-stax2-api`` (providing ``stax2-api``);
752 * ``odl-ws-rs-api`` (providing ``javax.ws.rs-api``);
754 A new ``sonar-jacoco-aggregate`` profile can be used to produce Sonar reports
755 with aggregated JaCoCo reports. Additionally, Sonar builds (run with
756 ``-Dsonar``) are detected and run with a number of irrelevant plugins disabled.
758 Upstream version upgrades
759 ~~~~~~~~~~~~~~~~~~~~~~~~~
761 * Akka 2.5.14 → 2.5.19 (and related ``ssl-config``, Aeron and Agrona upgrades):
763 * `2.5.15 <https://akka.io/blog/news/2018/08/24/akka-2.5.15-released>`__.
764 * `2.5.16 <https://akka.io/blog/news/2018/08/29/akka-2.5.16-security-fix-released>`__.
765 * `2.5.17 <https://akka.io/blog/news/2018/09/27/akka-2.5.17-released>`__.
766 * `2.5.18 <https://akka.io/blog/news/2018/10/07/akka-2.5.18-released>`__.
767 * `2.5.19 <https://akka.io/blog/news/2018/12/07/akka-2.5.19-released>`__.
769 * Commons Text `1.4 → 1.6 <http://www.apache.org/dist/commons/text/RELEASE-NOTES.txt>`__.
771 * Eclipse JDT annotations 2.2.0 → 2.2.100.
773 * Javassist 3.23.1 → 3.24.0.
775 * Karaf 4.2.1 → 4.2.2, with related upgrades.
777 * LMAX Disruptor `3.4.1 → 3.4.2 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.2>`__.
779 * Mockito `2.20.1 → 2.23.4 <https://github.com/mockito/mockito/blob/release/2.x/doc/release-notes/official.md>`__.
781 * Netty 4.1.29 → 4.1.31:
783 * `4.1.30 <https://netty.io/news/2018/09/28/4-1-30-Final.html>`__.
784 * `4.1.31 <https://netty.io/news/2018/10/30/4-1-31-Final.html>`__.
786 * Pax Exam 4.12.0 → 4.13.1.
788 * Scala 2.12.6 → 2.12.8:
790 * `2.12.7 <https://github.com/scala/scala/releases/tag/v2.12.7>`__.
791 * `2.12.8 <https://github.com/scala/scala/releases/tag/v2.12.8>`__.
793 * Wagon HTTP 3.1.0 → 3.2.0.
795 * Xtend `2.14.0 → 2.16.0 <https://www.eclipse.org/xtend/releasenotes.html>`__.
797 Plugin version upgrades
798 ~~~~~~~~~~~~~~~~~~~~~~~
800 * Asciidoctor `1.5.6 → 1.5.7.1 <https://github.com/asciidoctor/asciidoctor-maven-plugin/releases>`__
801 (with related AsciidoctorJ upgrades).
803 * Bundle 4.0.0 → 4.1.0.
805 * Checkstyle `8.12 → 8.15 <https://checkstyle.org/releasenotes.html#Release_8.13>`__.
807 * DependencyCheck `3.3.2 → 4.0.0 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
809 * Failsafe / Surefire `2.22.0 → 2.22.1 <https://blogs.apache.org/maven/entry/apache-maven-surefire-plugin-version1>`__.
811 * Help 3.1.0 → 3.1.1.
815 * PMD `3.10.0 → 3.11.0 <https://blogs.apache.org/maven/entry/apache-maven-pmd-plugin-3>`__.
817 * Remote Resources `1.5 → 1.6.0 <https://blogs.apache.org/maven/entry/apache-maven-remote-resources-plugin>`__.
820 `3.2.0 → 3.2.1 <https://blog.soebes.de/blog/2018/11/12/apache-maven-shade-plugin-version-3-dot-2-1-released/>`__.
822 * SpotBugs `3.1.6 → 3.1.9 <https://github.com/spotbugs/spotbugs/blob/release-3.1/CHANGELOG.md>`__.
824 * XBean finder 4.9 → 4.12.
826 * XTend 2.14.0 → 2.16.0.
831 This is a bug-fix and minor upstream bump upgrade from version 4.0.1.
836 Previous releases overrode Karaf’s ``jre.properties``; this is no longer
837 necessary, and was causing failures with Java 9 and later (our version of
838 ``jre.properties`` didn’t have the appropriate settings for anything after
839 Java 8). This release drops that override. See
840 `ODLPARENT-168 <https://jira.opendaylight.org/browse/ODLPARENT-168>`__ for
843 Upstream version upgrades
844 ~~~~~~~~~~~~~~~~~~~~~~~~~
846 * Commons Lang `3.8 → 3.8.1 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__.
848 * Jackson `2.9.6 → 2.9.7 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.7>`__.
850 * Netty `4.1.28 → 4.1.29 <http://netty.io/news/2018/08/24/4-1-29-Final.html>`__.
852 Plugin version upgrades
853 ~~~~~~~~~~~~~~~~~~~~~~~
855 * 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>`__.
857 * Javadoc `3.0.0 → 3.0.1 <https://blogs.apache.org/maven/entry/apache-maven-javadoc-plugin-version>`__.
859 * Jersey `2.22.2 → 2.25.1 <https://jersey.github.io/release-notes/2.25.html>`__,
860 along with Glassfish JSON 1.0.4 → 1.1.2.
862 * Plugin 3.5 → 3.5.2:
864 * `3.5.1 <https://blog.soebes.de/blog/2018/01/22/apache-maven-plugin-tools-version-3-dot-5-1-released/>`__.
865 * `3.5.2 <https://blog.soebes.de/blog/2018/05/26/apache-mave-plugin-tools-version-3-dot-5-2-released/>`__.
867 * Resources `3.0.1 → 3.1.0 <https://blogs.apache.org/maven/entry/apache-maven-resources-plugin-version>`__.
872 This is a bug-fix and minor upstream bump upgrade from version 4.0.0.
877 The JaCoCo execution profile was incorrect, breaking Sonar; the report is now
878 written correctly, so that Sonar can find it.
880 The Blueprint Maven plugin fails when it encounters Java 9 classes; this is
881 fixed by forcefully upgrading its dependency on xbean-finder. See
882 `ODLPARENT-167 <https://jira.opendaylight.org/browse/ODLPARENT-167>`__ for
885 Upstream version upgrades
886 ~~~~~~~~~~~~~~~~~~~~~~~~~
888 * SpotBugs `3.1.6 → 3.1.7 <https://github.com/spotbugs/spotbugs/blob/release-3.1/CHANGELOG.md>`__.
890 Upstream version additions
891 ~~~~~~~~~~~~~~~~~~~~~~~~~~
893 * Mockito Inline is added alongside Mockito Core, to ensure that the versions
896 Plugin version upgrades
897 ~~~~~~~~~~~~~~~~~~~~~~~
899 * 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/>`__.
901 * 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/>`__.
903 * Dependency 3.0.2 → 3.1.1:
905 * `3.1.0 <https://blog.soebes.de/blog/2018/04/06/apache-maven-dependency-plugin-version-3-dot-1-0-released/>`__.
906 * `3.1.1 <https://blog.soebes.de/blog/2018/05/24/apache-maven-dependency-plugin-version-3-dot-1-1-released/>`__.
908 * Dependency Check `3.3.1 → 3.3.2 <https://github.com/jeremylong/DependencyCheck/blob/master/RELEASE_NOTES.md>`__.
910 * 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>`__.
912 * Failsafe 2.20.1 → 2.22:
914 * `2.21 <https://blog.soebes.de/blog/2018/03/06/apache-maven-surefire-plugin-version-2-dot-21-released/>`__.
915 * `2.22 <https://blog.soebes.de/blog/2018/06/16/apache-maven-surefire-plugin-version-2-dot-22-released/>`__.
919 * `3.0.0 <https://blog.soebes.de/blog/2018/03/18/apache-maven-help-plugin-version-3-dot-0-0-released/>`__.
920 * `3.0.1 <https://blog.soebes.de/blog/2018/03/28/apache-maven-help-plugin-version-3-dot-0-1-released/>`__.
921 * `3.1.0 <https://blog.soebes.de/blog/2018/06/09/apache-maven-help-plugin-version-3-dot-1-0-released/>`__.
923 * Invoker 2.0.0 → 3.1.0:
925 * `3.0.0 <https://blog.soebes.de/blog/2017/05/24/apache-maven-invoker-plugin-version-3-dot-0-0-released/>`__.
926 * `3.1.0 <https://blog.soebes.de/blog/2018/05/31/apache-maven-invoker-plugin-version-3-dot-1-0-released/>`__.
928 * 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/>`__.
930 * 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/>`__.
932 * 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/>`__.
934 * 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/>`__.
936 * Site `3.7 → 3.7.1 <https://blog.soebes.de/blog/2018/04/29/apache-maven-site-plugin-version-3-dot-7-1-released/>`__.
938 * Surefire 2.18.1 → 2.22.0:
940 * `2.19 <https://blog.soebes.de/blog/2015/10/19/apache-maven-surefire-plugin-version-2-dot-19-released/>`__.
941 * `2.19.1 <https://blog.soebes.de/blog/2016/01/03/apache-maven-surefire-plugin-version-2-dot-19-dot-1-released/>`__.
942 * `2.20 <https://blog.soebes.de/blog/2017/04/12/apache-maven-surefire-plugin-version-2-dot-20-released/>`__.
943 * `2.21 <https://blog.soebes.de/blog/2018/03/06/apache-maven-surefire-plugin-version-2-dot-21-released/>`__.
944 * `2.22 <https://blog.soebes.de/blog/2018/06/16/apache-maven-surefire-plugin-version-2-dot-22-released/>`__.
950 This is a major upgrade from version 3, with breaking changes; projects will
951 need to make changes to upgrade to this version.
953 `This Wiki page <https://wiki.opendaylight.org/view/Neon_platform_upgrade>`__
954 has detailed step-by-step migration instructions.
956 ODL Parent 4 requires Maven 3.5.3 or later; this is needed in particular to
957 enable SpotBugs support with current versions of the SpotBugs plugin.
962 This release’s SpotBugs support doesn’t handle Guava 25.1 correctly, resulting
963 in false-positives regarding null handling; see
964 `ODLPARENT-161 <https://jira.opendaylight.org/browse/ODLPARENT-161>`__ for
965 details. Until this is fixed, the corresponding warnings are disabled, which
966 matches our existing FindBugs configuration (which suffers from the a variant
967 of this, with the same consequences).
969 We are planning on upgrading Akka during the 4.x cycle, even if it results in
970 a technically breaking upgrade. This is currently blocked on an OSGi bug in
971 Akka; see `Akka issue 25579 <https://github.com/akka/akka/issues/25579>`__ for
974 Blueprint and OSGi service handling
975 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
977 Previous releases used an OpenDaylight-specific directory for Blueprint XML
978 files, ``org/opendaylight/blueprint``. It turned out this wasn’t useful, so
979 version 4 uses the default directory, ``OSGI-INF/blueprint``.
981 The Maven bundle plugin is now configured to omit the ``Import-Service`` and
982 ``Export-Service`` headers, since they are deprecated, unnecessary in
983 OpenDaylight, and liable to cause issues.
985 With previous releases of OpenDaylight, projects were encouraged to use Pax
986 CDI API annotations to describe their Blueprint beans, services and injections;
987 with version 4, Blueprint annotations should be used instead:
989 * modules should depend on
990 ``org.apache.aries.blueprint:blueprint-maven-plugin-annotation``, with the
991 ``<optional>true</optional>`` flag, instead of
992 ``org.ops4j.pax.cdi:pax-cdi-api``;
994 * ``@OsgiServiceProvider`` on bean definitions is replaced by ``@Service``;
996 * ``@OsgiService`` at injection points is replaced by ``@Reference``;
998 * ``@OsgiService`` on bean definitions, while technically wrong, can be seen in
999 the OpenDaylight codebase; this is replaced by ``@Service``;
1001 * service lists can be injected using ``@ReferenceList``.
1003 See `this Gerrit patch <https://git.opendaylight.org/gerrit/75699>`__ for an
1009 Builds now warn about unchecked type uses (such as raw types where generics
1012 JUnit and Mockito are always available as test dependencies and no longer need
1013 to be declared in POMs.
1018 An OWASP profile is now available to run OWASP’s dependency checker; this will
1019 check all third-party dependencies against the NVD vulnerability database. To
1020 enable this, run Maven with ``-Powasp``.
1022 Build profile changes
1023 ~~~~~~~~~~~~~~~~~~~~~
1025 ``-Pq`` now skips Modernizer.
1030 ``odl-akka-leveldb-0.10`` wraps LevelDB 0.10 for Akka.
1032 ``odl-apache-commons-codec`` wraps Apache Commons Codec.
1034 ``odl-apache-commons-lang3`` wraps Apache Commons Lang 3.
1036 ``odl-apache-commons-net`` wraps Apache Commons Net.
1038 ``odl-apache-commons-text`` wraps Apache Commons Text.
1040 ``odl-apache-sshd`` wraps Apache SSHD.
1042 ``odl-guava`` provides the default ODL version of Guava; it should be used
1043 instead of ``odl-guava-23`` or the new ``odl-guava-25``.
1045 ``odl-jackson-2.9`` wraps Jackson 2.9.
1047 New FindBugs and SpotBugs settings
1048 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1050 FindBugs and SpotBugs are configured with
1051 `the SLF4J extension <http://kengotoda.github.io/findbugs-slf4j/>`__ (version
1052 1.4.0 for FindBugs, 1.4.1 for SpotBugs). This will flag misused SLF4J calls, in
1053 particular message templates which don’t match the arguments, and invalid
1054 placeholders (*e.g.* ``%s`` instead of ``{}``).
1059 ``aggregator-parent`` was unusable outside ``odlparent`` and has been removed.
1060 Instead, the ``maven.deploy.skip`` and ``maven.install.skip`` properties are
1061 available to disable deploying and installing artifacts.
1063 Upstream version upgrades
1064 ~~~~~~~~~~~~~~~~~~~~~~~~~
1066 This version upgrades the following third-party dependencies:
1068 * Aeron 1.7.0 → 1.9.3:
1070 * `1.8.0 <https://github.com/real-logic/aeron/releases/tag/1.8.0>`__.
1071 * `1.8.1 <https://github.com/real-logic/aeron/releases/tag/1.8.1>`__.
1072 * `1.8.2 <https://github.com/real-logic/aeron/releases/tag/1.8.2>`__.
1073 * `1.9.0 <https://github.com/real-logic/aeron/releases/tag/1.9.0>`__.
1074 * `1.9.1 <https://github.com/real-logic/aeron/releases/tag/1.9.1>`__.
1075 * `1.9.2 <https://github.com/real-logic/aeron/releases/tag/1.9.2>`__.
1076 * `1.9.3 <https://github.com/real-logic/aeron/releases/tag/1.9.3>`__.
1078 * Agrona 0.9.12 → 0.9.21:
1080 * `0.9.13 <https://github.com/real-logic/agrona/releases/tag/0.9.13>`__.
1081 * `0.9.14 <https://github.com/real-logic/agrona/releases/tag/0.9.14>`__.
1082 * `0.9.15 <https://github.com/real-logic/agrona/releases/tag/0.9.15>`__.
1083 * `0.9.16 <https://github.com/real-logic/agrona/releases/tag/0.9.16>`__.
1084 * `0.9.17 <https://github.com/real-logic/agrona/releases/tag/0.9.17>`__.
1085 * `0.9.18 <https://github.com/real-logic/agrona/releases/tag/0.9.18>`__.
1086 * `0.9.19 <https://github.com/real-logic/agrona/releases/tag/0.9.19>`__.
1087 * `0.9.20 <https://github.com/real-logic/agrona/releases/tag/0.9.20>`__.
1088 * `0.9.21 <https://github.com/real-logic/agrona/releases/tag/0.9.21>`__.
1090 * Akka 2.5.11 → 2.5.14:
1092 * `2.5.12 <https://akka.io/blog/news/2018/04/13/akka-2.5.12-released>`__.
1093 * `2.5.13 <https://akka.io/blog/news/2018/06/08/akka-2.5.13-released>`__.
1094 * `2.5.14 <https://akka.io/blog/news/2018/07/13/akka-2.5.14-released>`__.
1096 * ASM 5.1 → 6.2.1 (synchronised with Karaf).
1098 * Bouncy Castle `1.59 → 1.60 <https://www.bouncycastle.org/releasenotes.html>`__.
1100 * Checkstyle `8.4 → 8.12 <http://checkstyle.sourceforge.net/releasenotes.html#Release_8.12>`__.
1102 * Commons Lang `3.7 → 3.8 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`__.
1104 * Commons Text 1.1 → 1.4:
1106 * `1.2 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.2.txt>`__.
1107 * `1.3 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.3.txt>`__.
1108 * `1.4 <https://commons.apache.org/proper/commons-text/release-notes/RELEASE-NOTES-1.4.txt>`__.
1110 * Eclipse JDT annotations 2.1.150 → 2.2.0.
1112 * EclipseLink Moxy JAXB `2.7.1 → 2.7.3 <https://www.eclipse.org/eclipselink/releases/2.7.php>`__.
1114 * Enunciate core annotations
1115 `2.10.1 → 2.11.1 <https://github.com/stoicflame/enunciate/releases>`__.
1117 * Felix Metatype 1.1.6 → 1.2.0 (synchronised with Karaf).
1119 * Google Truth `0.40 → 0.42 <https://github.com/google/truth/releases>`__.
1121 * Guava 23.6.1 → 25.1:
1123 * `23.4 <https://github.com/google/guava/releases/tag/v23.4>`__.
1124 * `23.5 <https://github.com/google/guava/releases/tag/v23.5>`__.
1125 * `23.6 <https://github.com/google/guava/releases/tag/v23.6>`__.
1126 * `24.0 <https://github.com/google/guava/releases/tag/v24.0>`__.
1127 * `24.1 <https://github.com/google/guava/releases/tag/v24.1>`__.
1128 * `25.0 <https://github.com/google/guava/releases/tag/v25.0>`__.
1129 * `25.1 <https://github.com/google/guava/releases/tag/v25.1>`__.
1131 * Immutables `2.5.6 → 2.7.1 <https://github.com/immutables/immutables/blob/master/README.md#changelog>`__.
1133 * Jackson 2.8.9 → 2.9.6:
1135 * `2.9 feature overview <https://medium.com/@cowtowncoder/jackson-2-9-features-b2a19029e9ff>`__.
1136 * `2.9 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9>`__.
1137 * `2.9.1 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.1>`__.
1138 * `2.9.2 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.2>`__.
1139 * `2.9.3 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.3>`__.
1140 * `2.9.4 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.4>`__.
1141 * `2.9.5 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.5>`__.
1142 * `2.9.6 <https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.9.6>`__.
1144 * JaCoCo `0.8.1 → 0.8.2 <https://github.com/jacoco/jacoco/releases/tag/v0.8.2>`__.
1146 * Javassist 3.22.0 → 3.23.1. This provides compatibility with Java 9 and later,
1147 and `fixes a file handle leak <https://github.com/jboss-javassist/javassist/issues/165>`__.
1149 * Jettison 1.3.8 → 1.4.0.
1151 * Jetty 9.3.21 → 9.4.11 (synchronised with Karaf):
1153 * `9.4.0 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00097.html>`__.
1154 * `9.4.1 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00100.html>`__.
1155 * `9.4.2 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00101.html>`__.
1156 * `9.4.3 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00102.html>`__.
1157 * `9.4.4 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00105.html>`__.
1158 * `9.4.5 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00107.html>`__.
1159 * `9.4.6 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00109.html>`__.
1160 * `9.4.7 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00111.html>`__.
1161 * `9.4.8 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00114.html>`__.
1162 * `9.4.9 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00117.html>`__.
1163 * `9.4.10 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00119.html>`__.
1164 * `9.4.11 <https://dev.eclipse.org/mhonarc/lists/jetty-announce/msg00122.html>`__.
1166 * Jolokia OSGi `1.5.0 → 1.6.0 <https://jolokia.org/changes-report.html#a1.6.0>`__.
1168 * Karaf 4.1.5 → 4.2.1:
1170 * `4.1.6 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342748>`__.
1171 * `4.2.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342945>`__.
1173 * LMAX Disruptor 3.3.10 → 3.4.1:
1175 * `3.4.0 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.0>`__.
1176 * `3.4.1 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.4.1>`__.
1178 * META-INF services 1.7 → 1.8.
1180 * Mockito 1.10.19 → 2.20.1; see
1181 `What’s new in Mockito 2 <https://github.com/mockito/mockito/wiki/What%27s-new-in-Mockito-2>`__
1182 for upgrade instructions and
1183 `the list of issues you might run into <https://asolntsev.github.io/en/2016/10/11/mockito-2.1/>`__.
1185 * Netty 4.1.22 → 4.1.28:
1187 * `4.1.17 <http://netty.io/news/2017/11/08/4-0-53-Final-4-1-17-Final.html>`__.
1188 * `4.1.18 <http://netty.io/news/2017/12/11/4-0-54-Final-4-1-18-Final.html>`__.
1189 * `4.1.19 <http://netty.io/news/2017/12/18/4-1-19-Final.html>`__.
1190 * `4.1.20 <http://netty.io/news/2018/01/22/4-0-55-Final-4-1-20-Final.html>`__.
1191 * `4.1.21 <http://netty.io/news/2018/02/05/4-0-56-Final-4-1-21-Final.html>`__.
1192 * `4.1.22 <http://netty.io/news/2018/02/21/4-1-22-Final.html>`__.
1193 * `4.1.23 <http://netty.io/news/2018/04/04/4-1-23-Final.html>`__.
1194 * `4.1.24 <http://netty.io/news/2018/04/19/4-1-24-Final.html>`__.
1195 * `4.1.25 <http://netty.io/news/2018/05/14/4-1-25-Final.html>`__.
1196 * `4.1.26 <http://netty.io/news/2018/07/10/4-1-26-Final.html>`__.
1197 * `4.1.27 <http://netty.io/news/2018/07/11/4-1-27-Final.html>`__.
1198 * `4.1.28 <http://netty.io/news/2018/07/27/4-1-28-Final.html>`__.
1200 * Pax Exam 4.11.0 → 4.12.0.
1202 * Pax URL 2.5.3 → 2.5.4, which only fixes
1203 `a potential NullPointerException <https://ops4j1.jira.com/browse/PAXURL-346>`__.
1205 * PowerMock 1.6.4 → 1.7.4:
1207 * `1.6.5 <https://github.com/powermock/powermock/releases/tag/powermock-1.6.5>`__.
1208 * `1.6.6 <https://github.com/powermock/powermock/releases/tag/powermock-1.6.6>`__.
1209 * `1.7.0 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.0>`__.
1210 * `1.7.1 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.1>`__.
1211 * `1.7.2 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.2>`__.
1212 * `1.7.3 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.3>`__.
1213 * `1.7.4 <https://github.com/powermock/powermock/releases/tag/powermock-1.7.4>`__.
1215 * Scala parser combinators 1.0.7 → 1.1.1:
1217 * `1.1.0 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.0>`__.
1218 * `1.1.1 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.1.1>`__.
1220 * SpotBugs `3.1.0 → 3.1.6 <https://github.com/spotbugs/spotbugs/blob/3.1.6/CHANGELOG.md>`__.
1222 * Threeten Extra `1.3.2 → 1.4 <https://github.com/ThreeTen/threeten-extra/releases>`__.
1224 * Typesafe SSL config 0.2.2 → 0.2.4:
1226 * `0.2.3 <https://github.com/lightbend/ssl-config/releases/tag/v0.2.3>`__.
1227 * `0.2.4 <https://github.com/lightbend/ssl-config/releases/tag/v0.2.4>`__.
1230 `2.10 → 3.1.0 <https://lists.apache.org/thread.html/96024c54db7680697cb066e22a37b0ed5b4498386714a8a9ae1ec9cd@%3Cannounce.maven.apache.org%3E>`__.
1232 * XMLUnit `1.6 → 2.6.2 <https://github.com/xmlunit/xmlunit/blob/master/RELEASE_NOTES.md>`__.
1234 Upstream version additions
1235 ~~~~~~~~~~~~~~~~~~~~~~~~~~
1237 The following upstream dependencies have been added to dependency management:
1239 * Apache SSHD 2.0.0, with EdDSA and Netty support (EdDSA is provided by ``net.i2p.crypto:eddsa``).
1241 * Blueprint annotations (``org.apache.aries.blueprint:blueprint-maven-plugin-annotation``).
1245 * Pax Web 7.2.3 (synchronised with Karaf).
1247 Upstream version removals
1248 ~~~~~~~~~~~~~~~~~~~~~~~~~
1250 The following upstream dependencies have been removed from dependency management:
1254 * Our repackaging of Jersey Servlet.
1256 * JUnit’s ``junit-dep``, which has long been obsolete.
1258 * LevelDB (which is still available as features).
1260 * Pax CDI API — Blueprint annotations should be used instead.
1262 Plugin version upgrades
1263 ~~~~~~~~~~~~~~~~~~~~~~~
1265 The following plugins have been upgraded:
1267 * Blueprint 1.4.0 → 1.10.0.
1269 * Build helper 1.12 → 3.0.0.
1271 * Bundle plugin 3.5.0 → 4.0.0.
1274 `2.17 → 3.0.0 <https://mail-archives.apache.org/mod_mbox/maven-announce/201801.mbox/%3Cop.zchs68akkdkhrr%40desktop-2khsk44.mshome.net%3E>`__.
1277 `1.2.1 → 1.3.0 <https://github.com/basepom/duplicate-finder-maven-plugin/blob/master/CHANGES.md>`__.
1279 * Git commit id `2.2.4 → 2.2.5 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.5>`__.
1281 * Jacoco Maven plugin `0.8.1 → 0.8.2 <https://github.com/jacoco/jacoco/releases/tag/v0.8.2>`__.
1283 * Javadoc `3.0.0 → 3.0.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12342283>`__.
1287 * `3.10.0 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12342689&styleName=Text&projectId=12317621>`__.
1289 * Sevntu `1.29.0 → 1.32.0 <http://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.32.0>`__.
1291 * SpotBugs 3.1.0-RC6 → 3.1.6 (see the SpotBugs changes above).
1296 This version fixes the following issues:
1298 * `ODLPARENT-156 <https://jira.opendaylight.org/browse/ODLPARENT-156>`_:
1299 ``xtend-maven-plugin``’s dependencies end up pulling in conflicting
1300 dependencies. ODL Parent now constrains part of its dependency tree to avoid
1303 This version adds ``odl-jackson-2.8`` to ``odlparent-artifacts``.
1308 This version fixes the following issues:
1310 * `INFRAUTILS-41 <https://jira.opendaylight.org/browse/INFRAUTILS-41>`_:
1311 ``jre.properties`` includes ``com.sun.management`` so that it can be
1312 enabled if necessary. (This doesn’t add a dependency on
1313 ``com.sun.management``, it allows bundles to use it if it is present.)
1315 * `ODLPARENT-136 <https://jira.opendaylight.org/browse/ODLPARENT-136>`_:
1316 ``SingleFeatureTest`` pulls in ``org.osgi.compendium``.
1318 * `ODLPARENT-144 <https://jira.opendaylight.org/browse/ODLPARENT-144>`_:
1319 ``org.apache.karaf.scr.management`` is whitelisted so that it no longer
1320 affects ``SingleFeatureTest``.
1322 * `ODLPARENT-146 <https://jira.opendaylight.org/browse/ODLPARENT-146>`_:
1323 null-related FindBugs checks which produce false-positives with Guava 23.6
1324 and later are disabled, so that this really is fully backwards-compatible
1327 * `ODLPARENT-148 <https://jira.opendaylight.org/browse/ODLPARENT-148>`_:
1328 ``SingleFeatureTest`` preserves ``target/SFT/karaf.log``.
1330 This version includes the following improvements:
1332 * ``custom.properties`` no longer includes OVSDB-specific configuration.
1334 * The ``odl-jersey-1`` feature includes the Jersey client.
1336 * Redundant bundle dependency declarations in ``SingleFeatureTest`` have been
1337 removed (these are declarations which are also present in our base Karaf
1340 * Build errors involving invalid feature or bundle URLs now indicate which
1341 feature is at fault.
1343 * Obsolete Log4J overrides have been removed from ``SingleFeatureTest``.
1345 When building using JDK 9 or 10, the default settings have been changed as
1346 follows to avoid errors or extraneous warnings:
1348 * SFT is disabled (it needs Karaf 4.2 or later);
1350 * Javadocs are generated as HTML 4;
1352 * SpotBugs is disabled on JDK 10 or later;
1354 * FindBugs is disabled on JDK 9 or later.
1356 The following third-party dependencies have been upgraded:
1358 * `EclipseLink Moxy JAXB 2.6.2 → 2.7.1 <https://www.eclipse.org/eclipselink/releases/2.7.php>`_.
1360 * `Google Truth 0.36 → 0.40 <https://github.com/google/truth/releases>`_.
1362 * `Gson 2.8.2 → 2.8.5 <https://github.com/google/gson/blob/master/CHANGELOG.md>`_.
1364 * `Guava 23.6 → 23.6.1 <https://github.com/google/guava/compare/v23.6...v23.6.1>`_.
1365 This addresses CVE-2018-10237 (that’s the only change in this release).
1367 * `Jacoco Maven plugin 0.8.0 → 0.8.1 <https://github.com/jacoco/jacoco/releases/tag/v0.8.1>`_.
1369 * JDT annotations 2.1.0 → 2.1.150.
1371 * `Scala 2.12.5 → 2.12.6 <https://github.com/scala/scala/releases/tag/v2.12.6>`_.
1373 * `Scala Parser Combinators 1.0.6 → 1.0.7 <https://github.com/scala/scala-parser-combinators/releases/tag/v1.0.7>`_.
1375 * `Sevntu 1.24.2 → 1.29.0 <https://sevntu-checkstyle.github.io/sevntu.checkstyle/#1.29.0>`_.
1377 * `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>`_.
1379 The following Maven plugin has been upgraded:
1381 * `Javadoc 3.0.0 → 3.0.1 <https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12317529&version=12342283>`_.
1386 This version fixes the following issues:
1388 * `ODLPARENT-137 <https://jira.opendaylight.org/browse/ODLPARENT-137>`_:
1389 restore the OpenDaylight prompt.
1391 * `ODLPARENT-146 <https://jira.opendaylight.org/browse/ODLPARENT-146>`_:
1392 Guava 23.6 switched from @Nullable to @NullableDecl, which causes false
1393 positives in FindBugs’ ``NP_NONNULL_PARAM_VIOLATION`` rule; we’re
1394 disabling the rule for now.
1399 This version fixes the following issues:
1401 * Mycila dependencies are now “compile” scoped rather than “test”; this allows
1402 child projects to use Guice with Mycila more easily.
1404 * The duplicate finder now ignores ``web.xml`` and BluePrint XML files.
1406 This version includes the following improvements:
1408 * The ``-Pq`` profile skips Maven Modernizer, in preparation for its future
1409 integration (and its use in child projects).
1411 * An OWASP profile, ``-Powasp`` is available for vulnerability checking.
1413 * A new ``odl-jackson-2.8`` feature provides Jackson 2.8 to child projects.
1415 The following third-party dependencies have been added to dependency management:
1417 * `ThreeTen-Extra <http://www.threeten.org/threeten-extra/>`_
1419 The following third-party dependencies have been upgraded:
1421 * Aeron 1.2.5 → 1.7.0; release notes:
1423 * `1.3.0 <https://github.com/real-logic/aeron/releases/tag/1.3.0>`_
1424 * `1.4.0 <https://github.com/real-logic/aeron/releases/tag/1.4.0>`_
1425 * `1.5.0 <https://github.com/real-logic/aeron/releases/tag/1.5.0>`_
1426 * `1.5.1 <https://github.com/real-logic/aeron/releases/tag/1.5.1>`_
1427 * `1.5.2 <https://github.com/real-logic/aeron/releases/tag/1.5.2>`_
1428 * `1.6.0 <https://github.com/real-logic/aeron/releases/tag/1.6.0>`_
1429 * `1.7.0 <https://github.com/real-logic/aeron/releases/tag/1.7.0>`_
1431 * Agrona 0.9.5 → 0.9.12; release notes:
1433 * `0.9.6 <https://github.com/real-logic/Agrona/releases/tag/0.9.6>`_
1434 * `0.9.7 <https://github.com/real-logic/Agrona/releases/tag/0.9.7>`_
1435 * `0.9.8 <https://github.com/real-logic/Agrona/releases/tag/0.9.8>`_
1436 * `0.9.9 <https://github.com/real-logic/Agrona/releases/tag/0.9.9>`_
1437 * `0.9.10 <https://github.com/real-logic/Agrona/releases/tag/0.9.10>`_
1438 * `0.9.11 <https://github.com/real-logic/Agrona/releases/tag/0.9.11>`_
1439 * `0.9.12 <https://github.com/real-logic/Agrona/releases/tag/0.9.12>`_
1441 * Akka 2.5.5 → 2.5.11; release notes:
1443 * `2.5.6 <https://akka.io/blog/news/2017/09/28/akka-2.5.6-released>`_
1444 * `2.5.7 <https://akka.io/blog/news/2017/11/17/akka-2.5.7-released>`_
1445 * `2.5.8 <https://akka.io/blog/news/2017/12/08/akka-2.5.8-released>`_
1446 * `2.5.9 <https://akka.io/blog/news/2018/01/11/akka-2.5.9-released-2.4.x-end-of-life>`_
1447 * `2.5.10 <https://akka.io/blog/news/2018/02/23/akka-2.5.10-released>`_
1448 * `2.5.11 <https://akka.io/blog/news/2018/02/28/akka-2.5.11-released>`_
1450 * Commons Lang 3 `3.6 → 3.7 <http://www.apache.org/dist/commons/lang/RELEASE-NOTES.txt>`_
1452 * Guava 23.3 → 23.6; release notes:
1454 * `23.4 <https://github.com/google/guava/releases/tag/v23.4>`_
1455 * `23.5 <https://github.com/google/guava/releases/tag/v23.5>`_
1456 * `23.6 <https://github.com/google/guava/releases/tag/v23.6>`_
1458 * H2 database `1.4.193 → 1.4.196 <http://www.h2database.com/html/changelog.html>`_
1460 * Jacoco `0.7.9 → 0.8.0 <https://github.com/jacoco/jacoco/releases/tag/v0.8.0>`_
1462 * Javassist `3.21.0 → 3.22.0 <https://github.com/jboss-javassist/javassist/compare/rel_3_21_0_ga...rel_3_22_0_ga>`_
1464 * lmax-disruptor 3.3.7 → 3.3.10; release notes:
1466 * `3.3.8 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.8>`_
1467 * `3.3.9 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.9>`_
1468 * `3.3.10 <https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.10>`_
1470 * Netty 4.1.16 → 4.1.22; release notes:
1472 * `4.1.17 <http://netty.io/news/2017/11/08/4-0-53-Final-4-1-17-Final.html>`_
1473 * `4.1.18 <http://netty.io/news/2017/12/11/4-0-54-Final-4-1-18-Final.html>`_
1474 * `4.1.19 <http://netty.io/news/2017/12/18/4-1-19-Final.html>`_
1475 * `4.1.20 <http://netty.io/news/2018/01/22/4-0-55-Final-4-1-20-Final.html>`_
1476 * `4.1.21 <http://netty.io/news/2018/02/05/4-0-56-Final-4-1-21-Final.html>`_
1477 * `4.1.22 <http://netty.io/news/2018/02/21/4-1-22-Final.html>`_
1479 * Scala `2.12.4 → 2.12.5 <http://www.scala-lang.org/news/2.12.5>`_
1481 * Typesafe Config `0.2.1 → 0.2.2 <https://github.com/typesafehub/config/blob/master/NEWS.md>`_
1483 The following Maven plugins have been upgraded:
1485 * FindBugs 3.0.4 → 3.0.5
1487 * Git commit id 2.2.2 → 2.2.4; release notes:
1489 * `2.2.3 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.3>`_
1490 * `2.2.4 <https://github.com/ktoso/maven-git-commit-id-plugin/releases/tag/v2.2.4>`_
1495 This version fixes the following issues:
1497 * `ODLPARENT-136`_: ``features-test`` needs ``org.osgi.compendium``.
1499 * Jackson dependencies are declared using ``jackson-bom`` to ensure all they
1502 * ``find-duplicate-classpath-entries`` is run in the “verify” phase rather than
1503 the “validate” phase, which is too early.
1505 * The version of Jetty we pull in is now aligned with that declared in Karaf,
1506 resolving a number of restart and dependency issues.
1508 * Pulling in the ``wrap`` feature unconditionally is no longer necessary, so
1509 ``karaf4-parent`` no longer does so.
1511 * ``metainf-services`` are declared with scope “provided” to avoid their being
1512 included in downstream features (it’s a build-time dependency only).
1514 * ``leveldb-api`` is excluded from ``odl-akka-leveldb-0.7``, and ``jsr250-api``
1515 from ``enunciate-core-annotations``, to avoid duplicate having classes on the
1518 * Since the ``ssh`` feature is excluded from generated features, our Karaf
1519 need to enable it at boot in all cases.
1521 * ``bundle-test-lib`` is now a bundle.
1523 * Since we use static SLF4J loggers, the ``SLF4J_LOGGER_SHOULD_BE_NON_STATIC``
1524 rule needs to be disabled in our FindBugs configuration (this allows
1525 downstream projects to enable ``findbugs-slf4j`` without having to deal with
1526 all the resulting false-positives).
1528 * ``org.apache.karaf.scr.management`` is white-listed in SFT to avoid failures
1529 apparently related to that component (which we don’t care about).
1531 .. _ODLPARENT-136: https://jira.opendaylight.org/browse/ODLPARENT-136
1533 This version upgrades the following third-party dependencies:
1535 * `Antlr 4.7 → 4.7.1`_
1537 * `BouncyCastle 1.58 → 1.59`_
1539 * Jersey 1.17 → 1.19.4 (additionally available as the ``odl-jersey-1`` feature)
1541 * Jolokia 1.3.7 → 1.5.0
1543 * Karaf 4.1.3 → 4.1.5; release notes:
1548 .. _Antlr 4.7 → 4.7.1: https://github.com/antlr/antlr4/releases/tag/4.7.1
1549 .. _BouncyCastle 1.58 → 1.59: https://www.bouncycastle.org/releasenotes.html
1550 .. _Karaf 4.1.4: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12341702
1551 .. _Karaf 4.1.5: https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311140&version=12342294
1556 This version fixes the following issues:
1558 * SingleFeatureTest uses the configured local Maven repository for Pax Exam.
1560 * JavaDoc links are disabled for now to `speed up builds`_. A new
1561 ``javadoc-links`` profile enables the links.
1563 * Conditional feature dependencies are processed, ensuring our
1564 `distribution is complete`_.
1566 * Startup features are `adjusted for Karaf 4.1`_, avoiding unnecessary
1569 * The ``hiddenField`` Checkstyle check is disabled for abstract methods.
1571 * The default logging configuration uses Log4J2, which is the new default in
1574 .. _speed up builds: https://jira.opendaylight.org/browse/ODLPARENT-121
1575 .. _distribution is complete: https://jira.opendaylight.org/browse/ODLPARENT-133
1576 .. _adjusted for Karaf 4.1: https://jira.opendaylight.org/browse/ODLPARENT-134
1578 This version upgrades the following dependencies or plugins:
1580 * ``maven-enforcer-plugin`` 1.4.1 → 3.0.0-M1
1582 * ``maven-javadoc-plugin`` 3.0.0-M1 → 3.0.0
1587 This version fixes the following issues:
1589 * Karaf pulls in an invalid Hibernate feature repository, breaking downstream
1590 dependencies pulling in the “war” feature. ``populate-local-repo`` corrects
1591 the repository dependency.
1600 Build now show compiler warnings and deprecation warnings. This doesn't affect
1601 the result or require any changes currently, it just makes the issues more
1604 New Checkstyle rules
1605 ~~~~~~~~~~~~~~~~~~~~
1607 Checkstyle has been upgraded from 7.6 to 8.4 (see the
1608 `Checkstyle release notes`_ for details), and Sevntu from 1.21.0 to 1.24.2
1609 (note that the latter's group identifier changed from
1610 ``com.github.sevntu.checkstyle`` to ``com.github.sevntu-checkstyle``; you
1611 might need to update your IDE's configuration).
1613 The following Checkstyle rules are enabled; this might require changes in
1614 projects which enforce Checkstyle validation:
1616 * `AvoidHidingCauseExceptionCheck`_
1617 * `FinalClass`_: utility classes must be declared ``final``
1618 * `HiddenField`_: fields must not be shadowed
1619 * `HideUtilityClassConstructor`_: utility classes must hide their constructor
1621 .. _Checkstyle release notes: http://checkstyle.sourceforge.net/releasenotes.html
1623 .. _AvoidHidingCauseExceptionCheck: http://sevntu-checkstyle.github.io/sevntu.checkstyle/apidocs/com/github/sevntu/checkstyle/checks/coding/AvoidHidingCauseExceptionCheck.html
1624 .. _FinalClass: http://checkstyle.sourceforge.net/config_design.html#FinalClass
1625 .. _HiddenField: http://checkstyle.sourceforge.net/config_coding.html#HiddenField
1626 .. _HideUtilityClassConstructor: http://checkstyle.sourceforge.net/config_design.html#HideUtilityClassConstructor
1631 Karaf has been upgraded to 4.1.3. This should be transparent for dependent
1637 * When building a Karaf distribution using ``karaf4-parent``, projects can
1638 specify which archives to build: the ``karaf.archiveZip`` property will
1639 enable ZIP files if true, and ``karaf.archiveTarGz`` will enable
1640 gzip-compressed tarballs if true. By default both are enabled.
1642 * Our Karaf distribution provides Bouncy Castle at startup. Auto-generated
1643 feature descriptors take this into account (they won't embed a Bouncy
1649 * The ``odl-triemap-0.2`` feature wrapping
1650 ``com.github.romix:java-concurrent-hash-trie-map`` was rendered obsolete by
1651 YANG Tools' implementation and has been removed.
1656 * ``odl-javassist-3`` provides Javassist in a feature.
1658 * ``odl-jung-2.1`` provides `JUNG`_ in a feature.
1660 .. _JUNG: http://jung.sourceforge.net/
1662 Upstream version upgrades
1663 ~~~~~~~~~~~~~~~~~~~~~~~~~
1665 The following upstream dependencies have been upgraded:
1667 * Akka 2.4.18 → 2.5.4; release notes:
1675 * `Awaitility 2 → 3`_
1677 * `Bouncy Castle 1.57 → 1.58`_
1679 * `Commons Codec 1.10 → 1.11`_
1681 * `Commons File Upload 1.3.2 → 1.3.3`_
1683 * `Commons IO 2.5 → 2.6`_
1685 * Eclipse JDT annotations 2.0.0 → 2.1.0
1687 * Felix Dependency Manager 4.3.0 → 4.4.1
1688 * Felix Dependency Manager Shell 4.0.4 → 4.0.6
1689 * Felix Metatype 1.1.2 → 1.1.6
1691 * `Google Truth 0.28 → 0.36`_ (with the Java 8 extensions)
1693 * `Gson 2.7 → 2.8.2`_
1695 * Guava 22 → 23.3 along with the associated feature name change from
1696 ``odl-guava-22`` to ``odl-guava-23`` (dependent packages *must* change their
1697 dependency); release notes:
1704 * Immutables 2.4.2 → 2.5.6
1706 * Jackson 2.3.2 → 2.8.9
1708 * Jacoco 0.7.7 → 0.7.9; release notes:
1713 * Jacoco Listeners 2.4 → 3.8
1715 * `Javassist 3.20.0 → 3.21.0`_
1717 * `Jettison 1.3.7 → 1.3.8`_
1719 * `Jolokia 1.3.6 → 1.3.7`_
1721 * `JSONassert 1.3.0 → 1.5.0`_
1723 * `logback 1.2.2 → 1.2.3`_
1725 * `LMAX Disruptor 3.3.6 → 3.3.7`_
1727 * Netty 4.1.8 → 4.1.16; release notes:
1738 * `Pax URL 2.5.2 → 2.5.3`_
1740 * Scala 2.11.11 → 2.12.4; release notes:
1748 * Servlet API 3.0.1 → 3.1.0
1750 * `SLF4J 1.7.21 → 1.7.25`_
1752 * `webcohesion enunciate 2.6.0 → 2.10.1`_
1754 * `Xtend 2.12 → 2.13`_
1756 .. _Akka 2.5.0: http://akka.io/blog/news/2017/04/13/akka-2.5.0-released
1757 .. _Akka 2.5.1: http://akka.io/blog/news/2017/05/02/akka-2.5.1-released
1758 .. _Akka 2.5.2: http://akka.io/blog/news/2017/05/24/akka-2.5.2-released
1759 .. _Akka 2.5.3: http://akka.io/blog/news/2017/06/19/akka-2.5.3-released
1760 .. _Akka 2.5.4: http://akka.io/blog/news/2017/08/10/akka-2.5.4-released
1762 .. _Awaitility 2 → 3: https://github.com/awaitility/awaitility/wiki/ReleaseNotes30
1764 .. _Bouncy Castle 1.57 → 1.58: https://www.bouncycastle.org/releasenotes.html
1766 .. _Commons Codec 1.10 → 1.11: http://www.apache.org/dist/commons/codec/RELEASE-NOTES.txt
1768 .. _Commons File Upload 1.3.2 → 1.3.3: http://www.apache.org/dist/commons/fileupload/RELEASE-NOTES.txt
1770 .. _Commons IO 2.5 → 2.6: http://www.apache.org/dist/commons/io/RELEASE-NOTES.txt
1772 .. _Google Truth 0.28 → 0.36: https://github.com/google/truth/releases
1774 .. _Gson 2.7 → 2.8.2: https://github.com/google/gson/blob/master/CHANGELOG.md
1776 .. _Guava 23: https://github.com/google/guava/wiki/Release23
1777 .. _Guava 23.1: https://github.com/google/guava/releases/tag/v23.1
1778 .. _Guava 23.2: https://github.com/google/guava/releases/tag/v23.2
1779 .. _Guava 23.3: https://github.com/google/guava/releases/tag/v23.3
1781 .. _Jacoco 0.7.8: https://github.com/jacoco/jacoco/releases/tag/v0.7.8
1782 .. _Jacoco 0.7.9: https://github.com/jacoco/jacoco/releases/tag/v0.7.9
1784 .. _Javassist 3.20.0 → 3.21.0: https://github.com/jboss-javassist/javassist/compare/rel_3_20_0_ga...rel_3_21_0_ga
1786 .. _Jettison 1.3.7 → 1.3.8: https://github.com/jettison-json/jettison/compare/jettison-1.3.7...jettison-1.3.8
1788 .. _Jolokia 1.3.6 → 1.3.7: https://github.com/rhuss/jolokia/releases/tag/v1.3.7
1790 .. _JSONassert 1.3.0 → 1.5.0: https://github.com/skyscreamer/JSONassert/releases
1792 .. _logback 1.2.2 → 1.2.3: https://logback.qos.ch/news.html
1794 .. _LMAX Disruptor 3.3.6 → 3.3.7: https://github.com/LMAX-Exchange/disruptor/releases/tag/3.3.7
1796 .. _Netty 4.1.9: http://netty.io/news/2017/03/10/4-0-45-Final-4-1-9-Final.html
1797 .. _Netty 4.1.10: http://netty.io/news/2017/04/30/4-0-46-Final-4-1-10-Final.html
1798 .. _Netty 4.1.11: http://netty.io/news/2017/05/12/4-0-47-Final-4-1-11-Final.html
1799 .. _Netty 4.1.12: http://netty.io/news/2017/06/09/4-0-48-Final-4-1-12-Final.html
1800 .. _Netty 4.1.13: http://netty.io/news/2017/07/06/4-0-49-Final-4-1-13-Final.html
1801 .. _Netty 4.1.14: http://netty.io/news/2017/08/03/4-0-50-Final-4-1-14-Final.html
1802 .. _Netty 4.1.15: http://netty.io/news/2017/08/25/4-0-51-Final-4-1-15-Final.html
1803 .. _Netty 4.1.16: http://netty.io/news/2017/09/25/4-0-52-Final-4-1-16-Final.html
1805 .. _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
1807 .. _Scala 2.12.0: https://github.com/scala/scala/releases/tag/v2.12.0
1808 .. _Scala 2.12.1: https://github.com/scala/scala/releases/tag/v2.12.1
1809 .. _Scala 2.12.2: https://github.com/scala/scala/releases/tag/v2.12.2
1810 .. _Scala 2.12.3: https://github.com/scala/scala/releases/tag/v2.12.3
1811 .. _Scala 2.12.4: https://github.com/scala/scala/releases/tag/v2.12.4
1813 .. _SLF4J 1.7.21 → 1.7.25: https://www.slf4j.org/news.html
1815 .. _webcohesion enunciate 2.6.0 → 2.10.1: https://github.com/stoicflame/enunciate/releases
1817 .. _Xtend 2.12 → 2.13: https://www.eclipse.org/xtend/releasenotes.html
1819 Upstream version additions
1820 ~~~~~~~~~~~~~~~~~~~~~~~~~~
1822 The following upstream dependencies have been added to dependency management:
1824 * Commons Text, ``org.apache.commons:commons-text`` (this will allow downstreams
1825 to migrate from ``commons-lang3``\’s ``WordUtils``, which is deprecated)
1827 Upstream version removals
1828 ~~~~~~~~~~~~~~~~~~~~~~~~~
1830 The following upstream dependencies have been removed from dependency
1831 management (they are obsolete and unused):
1835 * Equinox HTTP service bridge
1836 * ``equinoxSDK381`` artifacts
1837 * Coda Hale Metrics, which are mostly unused and should eventually be wrapped
1839 * ``com.google.code.findbugs:jsr305`` (which *must not* be used; this is
1840 enforced — ``annotations`` should be used instead)
1841 * Felix File Install and Web Console
1844 * ``org.mockito:mockito-all`` (which *must not* be used; this is enforced —
1845 ``mockito-core`` should be used instead)
1851 Plugin version upgrades
1852 ~~~~~~~~~~~~~~~~~~~~~~~
1854 The following plugins have been upgraded:
1856 * ``org.apache.servicemix.tooling:depends-maven-plugin`` 1.3.1 → 1.4.0
1857 * ``org.apache.felix:maven-bundle-plugin`` 2.4.0 → 3.3.0
1858 * ``maven-compiler-plugin`` 3.6.1 → 3.7.0
1859 * ``maven-dependency-plugin`` 3.0.1 → 3.0.2
1860 * ``maven-enforcer-plugin`` 1.4.1 → 3.0.0-M1
1861 * ``maven-failsafe-plugin`` 2.18.1 → 2.20.1
1862 * ``maven-javadoc-plugin`` 2.10.4 → 3.0.0-M1
1863 * ``maven-shade-plugin`` 2.4.3 → 3.1.0
1868 * The `Maven Find Duplicates`_ plugin can be enabled by setting the
1869 ``duplicate-finder.skip`` property to ``false``.
1871 * The SpotBugs_ Maven plugin can now be used instead of the FindBugs plugin
1872 (both are available, so no change is required). To use SpotBugs, replace
1873 ``org.codehaus.mojo:findbugs-maven-plugin`` with
1874 ``com.github.spotbugs:spotbugs-maven-plugin``.
1876 .. _Maven Find Duplicates: https://github.com/basepom/duplicate-finder-maven-plugin/
1878 .. _SpotBugs: https://spotbugs.github.io/