Wiki source code of Release Notes for XWiki 12.6
Version 19.1 by Manuel Leduc on 2020/08/06
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]. They share the same release notes as they are released together and have the same version. | ||
| 6 | |||
| 7 | This release brings WYSIWYG editor integration with comments and annotations, allowing for easy insertion of mentions into comments and annotations. Talking about mentions, the mention summary is now included in the notification message. As for the notifications, they are now pre-filtered when the event occurs and stored (also) on a separate Solr core, which improves considerably the time spent to retrieve and display them. For developers we have a new "content footer" UI extension point that might be of interest. Besides that this release includes, as usual, a fair amount of bug fixes and other small improvements. | ||
| 8 | |||
| 9 | {{error}} | ||
| 10 | Some important bugs have been discovered since XWiki 12.6 has been released: | ||
| 11 | |||
| 12 | * [[Mention-related stackraces in the XWiki logs>>https://jira.xwiki.org/browse/XWIKI-17619]]. Specifially:((( | ||
| 13 | |||
| 14 | {{box}} | ||
| 15 | ##... | ||
| 16 | Caused by: jetbrains.exodus.ExodusException: Can't acquire environment lock after 0 ms. | ||
| 17 | ...## | ||
| 18 | {{/box}} | ||
| 19 | |||
| 20 | XWiki 12.6.1+ and 12.7+ will include a fix for this issue. In the meantime, restarting the server fixes the issue and allows the mentions to work properly. | ||
| 21 | ))) | ||
| 22 | |||
| 23 | If one or several of these bugs impact you, then you should use the next version once it has been released. | ||
| 24 | {{/error}} | ||
| 25 | |||
| 26 | = New and Noteworthy (since XWiki 12.5.1) = | ||
| 27 | |||
| 28 | [[Full list of issues fixed and Dashboard for 12.6>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14606]]. | ||
| 29 | |||
| 30 | {{releasenotechanges/}} | ||
| 31 | |||
| 32 | === Moved Modules === | ||
| 33 | |||
| 34 | The old activity stream and the watchlist modules have been moved to the attic: | ||
| 35 | |||
| 36 | * https://github.com/xwiki-attic/xwiki-platform-activitystream | ||
| 37 | * https://github.com/xwiki-attic/xwiki-platform-watchlist | ||
| 38 | |||
| 39 | === Upgrades === | ||
| 40 | |||
| 41 | The following runtime dependencies have been upgraded (they have a different release cycle than [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]): | ||
| 42 | |||
| 43 | * [[CSS4J 2.0.4>>https://jira.xwiki.org/browse/XWIKI-17542]] | ||
| 44 | * [[Rome 1.14.1>>https://jira.xwiki.org/browse/XWIKI-17485]] | ||
| 45 | * [[MySQL connector 8.0.21>>https://jira.xwiki.org/browse/XWIKI-17565]] | ||
| 46 | * [[Jackson 2.11.1>>https://jira.xwiki.org/browse/XCOMMONS-1976]] | ||
| 47 | * [[JSqlParser 3.2>>https://jira.xwiki.org/browse/XWIKI-17490]] | ||
| 48 | * [[JNR POSIX 3.0.58>>https://jira.xwiki.org/browse/XWIKI-17564]] | ||
| 49 | * [[JNR FFI 2.1.16>>https://jira.xwiki.org/browse/XWIKI-17566]] | ||
| 50 | * [[JNA 5.6.0>>https://jira.xwiki.org/browse/XWIKI-17567]] | ||
| 51 | * [[Hibernate 5.4.18>>https://jira.xwiki.org/browse/XWIKI-17489]] | ||
| 52 | * [[HSQLDB 2.5.1>>https://jira.xwiki.org/browse/XWIKI-17491]] | ||
| 53 | * [[Checker Qual 3.5.0>>https://jira.xwiki.org/browse/XCOMMONS-1971]] | ||
| 54 | * [[Caffeine 2.8.5>>https://jira.xwiki.org/browse/XCOMMONS-1977]] | ||
| 55 | * [[Byte Buddy 1.10.13>>https://jira.xwiki.org/browse/XCOMMONS-1973]] | ||
| 56 | * [[Bouncy Castle 1.66>>https://jira.xwiki.org/browse/XCOMMONS-1982]] | ||
| 57 | * [[Apache PDFBox 2.0.20>>https://jira.xwiki.org/browse/XWIKI-17487]] | ||
| 58 | * [[PostgresSQL connector 42.2.14>>https://jira.xwiki.org/browse/XWIKI-17486]] | ||
| 59 | * [[CKEditor Integration 1.48>>https://jira.xwiki.org/browse/XWIKI-17475]] | ||
| 60 | * [[CKEditor 4.14.1>>https://jira.xwiki.org/browse/CKEDITOR-357]] | ||
| 61 | |||
| 62 | = Translations = | ||
| 63 | |||
| 64 | The following translations have been updated: | ||
| 65 | |||
| 66 | {{language codes="es,zh"/}} | ||
| 67 | |||
| 68 | {{comment}} | ||
| 69 | TODO: uncomment and update with proper link when the report is ready. | ||
| 70 | |||
| 71 | = Tested Browsers & Databases = | ||
| 72 | |||
| 73 | {{include reference="TestReports.<test report page>"/}} | ||
| 74 | {{/comment}} | ||
| 75 | |||
| 76 | {{comment}} | ||
| 77 | TODO: uncomment and update with proper links when the report is ready. | ||
| 78 | |||
| 79 | = Performances tests compared to <last super stable version> = | ||
| 80 | |||
| 81 | {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}} | ||
| 82 | |||
| 83 | More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]]. | ||
| 84 | {{/comment}} | ||
| 85 | |||
| 86 | = Known issues = | ||
| 87 | |||
| 88 | * [[Bugs we know about>>https://jira.xwiki.org/issues/?jql=category%20%3D%2010000%20AND%20issuetype%20%3D%20Bug%20AND%20resolution%20%3D%20Unresolved%20ORDER%20BY%20updated%20DESC]] | ||
| 89 | |||
| 90 | = Backward Compatibility and Migration Notes = | ||
| 91 | |||
| 92 | == General Notes == | ||
| 93 | |||
| 94 | * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added: | ||
| 95 | ** ##xwiki.cfg## | ||
| 96 | ** ##xwiki.properties## | ||
| 97 | ** ##web.xml## | ||
| 98 | ** ##hibernate.cfg.xml## | ||
| 99 | * Add ##xwiki.store.migration=1## in ##xwiki.cfg## so that XWiki will attempt to automatically migrate your current database to any new schema. Make sure you backup your Database before doing anything. | ||
| 100 | |||
| 101 | == Issues specific to XWiki 12.6 == | ||
| 102 | |||
| 103 | === New event store and pre filtering by default === | ||
| 104 | |||
| 105 | Even if it was implemented along the course of 12.x it's still the first time that this is enabled for most users so don't hesitate to report any notification related issue to [[https://jira.xwiki.org/projects/XWIKI]]. | ||
| 106 | |||
| 107 | If you hit a blocker bug you can go back to: | ||
| 108 | |||
| 109 | * post filtering of event using the property ##notifications.eventPrefilteringEnabled## in ##xwiki.properties## | ||
| 110 | * use only the database store by disabling the new one using the property ##eventstream.store.enabled## in ##xwiki.properties## | ||
| 111 | |||
| 112 | Right now old events are not automatically migrated so when you upgrade they will appear to have vanished. To restore them you can go to the Notifications section in the wiki administration and use the migrator. It will copy all the old events to the new store by default but to speed up the migration you also have the choice to indicate a date after which you want to migrate event if you don't need the very old ones. | ||
| 113 | |||
| 114 | == API Breakages == | ||
| 115 | |||
| 116 | The following APIs were modified since XWiki 12.5.1: | ||
| 117 | |||
| 118 | {{backwardCompatiblityReportXml version="12.6"/}} | ||
| 119 | |||
| 120 | = Credits = | ||
| 121 | |||
| 122 | The following people have contributed code and translations to this release (sorted alphabetically): | ||
| 123 | |||
| 124 | * Clément Aubin | ||
| 125 | * DenisF | ||
| 126 | * Eduard Moraru | ||
| 127 | * Francisco García Moreno | ||
| 128 | * Guillaume Delhumeau | ||
| 129 | * Manuel Leduc | ||
| 130 | * Marius Dumitru Florea | ||
| 131 | * mfkvfn | ||
| 132 | * Simon Urli | ||
| 133 | * Thomas Mortagne | ||
| 134 | * Vincent Massol | ||
| 135 | * xrichard |
