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