Wiki source code of Release Notes for XWiki 17.10.1
Last modified by Ilie Andriuta on 2026/02/09 16:30
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{velocity}} | ||
| 2 | #if ($doc.getValue('released') != 1) | ||
| 3 | {{warning}}This version has not yet been released.{{/warning}} | ||
| 4 | #end | ||
| 5 | {{/velocity}} | ||
| 6 | |||
| 7 | {{velocity}} | ||
| 8 | #set ($rnObject = $doc.getObject('ReleaseNotes.Code.ReleaseNoteClass')) | ||
| 9 | #set ($product = $rnObject.product) | ||
| 10 | #set ($version = $rnObject.version) | ||
| 11 | #set ($versionPrefix = $stringtool.substringBefore($version, '-')) | ||
| 12 | #set ($versionParts = $stringtool.split($versionPrefix, '.')) | ||
| 13 | #set ($isRC = $version.contains('rc')) | ||
| 14 | #set ($isFinal = !$isRC) | ||
| 15 | #set ($isFirstFinal = $isFinal && ($versionParts.size() == 2 || $versionParts[2] == 0)) | ||
| 16 | #set ($isBugFix = $isFinal && $versionParts.size() == 3 && $versionParts[2] > 0) | ||
| 17 | {{/velocity}} | ||
| 18 | |||
| 19 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 20 | {{toc/}} | ||
| 21 | {{/box}} | ||
| 22 | |||
| 23 | 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. | ||
| 24 | |||
| 25 | This release improves the PDF export, especially when using the Chrome Docker Container, and brings experimental support for clustering to the realtime editors. It also includes a lot of bug fixes and dependency upgrades. Last but not least, this release contains security fixes, with the [[highest severity being 8.6/10>>doc:dev:Community.SecurityPolicy.WebHome||anchor="HSeverity"]]. | ||
| 26 | |||
| 27 | {{velocity}} | ||
| 28 | {{jiraBlockersFor version="$version" id="xwikiorg"/}} | ||
| 29 | {{/velocity}} | ||
| 30 | |||
| 31 | = New and Noteworthy (since {{velocity}}$product{{/velocity}} 17.10.0) = | ||
| 32 | |||
| 33 | [[Full list of issues fixed and Dashboard for 17.10.1>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=16509]]. | ||
| 34 | |||
| 35 | {{jira style="list" url="https://jira.xwiki.org" fields="type, status, key, summary" source="jql"}} | ||
| 36 | resolution in (Fixed, "Solved By") AND component != "Development Issues only" AND component != "Development Issues only - Test" AND component != "Dependency Upgrades" AND project in (XCOMMONS, XRENDERING, XWIKI) AND fixVersion in (17.10.1) | ||
| 37 | {{/jira}} | ||
| 38 | |||
| 39 | {{releasenotechanges/}} | ||
| 40 | |||
| 41 | = Upgrades = | ||
| 42 | |||
| 43 | 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]]): | ||
| 44 | |||
| 45 | {{velocity}} | ||
| 46 | #if ($isFirstFinal) | ||
| 47 | #set ($affectedVersions = "${version}-rc-1, ${version}") | ||
| 48 | #else | ||
| 49 | #set ($affectedVersions = "${version}") | ||
| 50 | #end | ||
| 51 | {{jira url="https://jira.xwiki.org" source="jql" style="list"}} | ||
| 52 | project in (XWIKI, XCOMMONS, XRENDERING) AND issuetype = Task AND fixVersion in ($affectedVersions) AND component = "Dependency Upgrades" | ||
| 53 | {{/jira}} | ||
| 54 | {{/velocity}} | ||
| 55 | |||
| 56 | = Translations = | ||
| 57 | |||
| 58 | The following translations have been updated: | ||
| 59 | |||
| 60 | {{language codes="de,fr,ko,sl,uk,zh"/}} | ||
| 61 | |||
| 62 | = Tested Browsers & Databases = | ||
| 63 | |||
| 64 | == Automated testing == | ||
| 65 | |||
| 66 | XWiki executes a lot of [[automated tests during its build>>dev:Community.Testing.WebHome||anchor="HTestingStrategy"]], testing all [[supported configurations>>dev:Community.SupportStrategy.WebHome]]. In addition, some manual QA is also executed to try to discover additional problems (see below): | ||
| 67 | |||
| 68 | {{include reference="TestReports.ManualTestReportSummaryXWiki17101.WebHome"/}} | ||
| 69 | |||
| 70 | **NOTE**: This XWki version has been [[manually tested>>dev:Community.ManualTestStrategy]] by the QA and has been validated. | ||
| 71 | |||
| 72 | {{comment}} | ||
| 73 | TODO: uncomment and update with proper links when the report is ready. | ||
| 74 | |||
| 75 | = Performances tests compared to <last super stable version> = | ||
| 76 | |||
| 77 | {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}} | ||
| 78 | |||
| 79 | More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]]. | ||
| 80 | {{/comment}} | ||
| 81 | |||
| 82 | = Security Issues = | ||
| 83 | |||
| 84 | Security issues are not listed in issue lists or dashboards to avoid disclosing ways to use them, but they will appear automatically in them once they're disclosed. See the [[XWiki Security Policy>>dev:Community.SecurityPolicy.WebHome]] for more details. | ||
| 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 {{velocity}}$product $version{{/velocity}} == | ||
| 102 | |||
| 103 | === New Headless Chrome Docker Image === | ||
| 104 | |||
| 105 | We changed the headless Chrome Docker image used for PDF export from [[##zenika/alpine-chrome##>>https://hub.docker.com/r/zenika/alpine-chrome]] to [[##femtopixel/google-chrome-headless##>>https://hub.docker.com/r/femtopixel/google-chrome-headless]] in order to be able to use a more recent version of Chrome. The PDF export code has been updated to work with this new Docker image. The previously used Docker image might not work as a result. If you have customized the "Chrome Docker Image" configuration from the PDF Export administration section, or the ##export.pdf.chromeDockerImage## configuration from ##xwiki.properties##, we highly recommend you update your configuration to use the new supported image. For reference, the default value is currently ##femtopixel/google-chrome-headless:144.0.7524.3## but you should be able to use a different version (tag) of this image if needed. | ||
| 106 | |||
| 107 | == API Breakages == | ||
| 108 | |||
| 109 | The following APIs were modified since {{velocity}}$product{{/velocity}} 17.10.0: | ||
| 110 | |||
| 111 | {{velocity}} | ||
| 112 | {{backwardCompatibilityReport134 version="$version"/}} | ||
| 113 | {{/velocity}} | ||
| 114 | |||
| 115 | = Credits = | ||
| 116 | |||
| 117 | The following people have contributed code and translations to this release (sorted alphabetically): | ||
| 118 | |||
| 119 | * 이경철 | ||
| 120 | * Anca Luca | ||
| 121 | * anonymous | ||
| 122 | * Cédric LAMBLIN | ||
| 123 | * Ilie Andriuta | ||
| 124 | * Lucas Charpentier | ||
| 125 | * Manuel Leduc | ||
| 126 | * Marius Dumitru Florea | ||
| 127 | * Michael Hamann | ||
| 128 | * Nikita Petrenko | ||
| 129 | * Rostyslav Haitkulov | ||
| 130 | * Saa Kiraly | ||
| 131 | * Simon Urli | ||
| 132 | * Simpel | ||
| 133 | * Thomas Mortagne | ||
| 134 | * Vincent Massol | ||
| 135 | * Xiaofei Cui | ||
| 136 | * xrichard |
