Ready for review

Last modified by Eleni Cojocariu on 2026/11/16 18:40

Show last authors
1 Converts [[Installation using Debian/Ubuntu (.DEB) packages>>Documentation.AdminGuide.Installation.InstallationViaAPT.WebHome]] into ##documentation.xs.admin.installation.methods.install-xwiki-debian##, a new subtree beside ##install-xwiki-war## and ##install-xwiki-docker##. The new tree had no Debian page at all, while three of its pages already linked the legacy one. [[Deploy XWiki as the Root Web Application>>documentation.xs.admin.configuration.short-urls.deploy-root-webapp.WebHome]] even has an FAQ entry deferring the Debian procedure to a page that did not exist.
2
3 **Eight new pages**: the hub How-to with the installation procedure, a Reference for the repository channels and the packages, a Reference for the files the packages install, and How-tos for the root web application, a standalone Solr server, the systemd file-access restriction and uninstalling, plus an Explanation for troubleshooting.
4
5 **Five facts on the legacy page were measured wrong or stale and are corrected, not carried over:**
6
7 * The ##lts-latest## repository it advertises, ##https:~~/~~/maven.xwiki.org/lts/xwiki-lts-latest.list##, answers **404**. The live one is ##https:~~/~~/maven.xwiki.org/recommended/xwiki-lts-latest.list##: only the link's href was right, its visible label was not.
8 * The warning that the database password must contain no special character is obsolete: XWIKI-14406 is Closed/Fixed in 18.5.0, 18.4.2 and 17.10.10, so it is false for every supported version.
9 * ##xwiki-solr9-extension_index## was renamed ##xwiki-solr9-extension-index##; the underscore package stopped at 16.8.0.
10 * The Solr 8 ##xwiki-solr-*## packages stopped at 16.1.0 and the ##xwiki-tomcat7/8/9-*## ones at 17.0.0, so only Tomcat 10 and 11 and Solr 9 are documented.
11 * The Java requirement was understated; the pages now defer to the [[Java Support Strategy>>dev:Community.SupportStrategy.JavaSupportStrategy.WebHome]] instead of freezing a pair of numbers.
12
13 The package list was checked against ##http:~~/~~/maven.xwiki.org/stable/Packages##, and the systemd sandbox, the Solr core names and the office-server properties against the sources in ##xwiki-platform##.
14
15 **Also fixed while converting**: the Jetty root-webapp instruction, which the legacy page stated four times (twice inside {{code language="none"}}{{version}}{{/code}} macros, once bare and once as leftover ##data-xwikiorg-versions## paragraphs) plus a stray verbatim block, now appears once; the five How-tos each end on a result step, which no legacy procedure had.
16
17 **Dropped as already covered**: the LibreOffice section. [[Connect to an Internal Office Server>>documentation.xs.admin.exports.office-server-properties.connect-internal-office-server.WebHome]] owns the procedure, [[Office Server Properties>>documentation.xs.admin.exports.office-server-properties.WebHome]] already gives ##/usr/lib/libreoffice## for Linux, and the new Files page carries the rule that a Debian installation configures XWiki through ##/etc/xwiki/xwiki.properties##. The hub links that page instead.
18
19 **Legacy pages**: the original keeps all 35 of its headings, verbatim and in order, each with a pointer, so bookmarked anchors still resolve; it has no attachments. ##Documentation.AdminGuide.InstallationViaAPT##, which is a redirect object rather than a page, is re-aimed at the new hub. Five backlinks are repointed ([[Prerequisites>>documentation.xs.admin.installation.prerequisites.WebHome]], [[Deploy XWiki as the Root Web Application>>documentation.xs.admin.configuration.short-urls.deploy-root-webapp.WebHome]], [[Java Memory for Tomcat>>documentation.xs.admin.installation.methods.install-xwiki-war.configure-servlet-container.configure-tomcat.java-memory.WebHome]], [[Upgrade XWiki Installed from the Debian Packages>>documentation.xs.admin.upgrade.distribution.upgrade-debian-package.WebHome]], [[Installation Methods>>documentation.xs.admin.installation.methods.WebHome]]) along with three old-tree pages; the dated release note, the proposals, the IRC archives and the feedback archive are left alone as historical records, and the extensions-wiki backlink needs its own Change Request since one cannot span two wikis.{{code language="none"}}{{/version}}{{/code}}
20
21 ## macros, once bare and once as leftover ##data-xwikiorg-versions## paragraphs) plus a stray verbatim block, now appears once; the five How-tos each end on a result step, which no legacy procedure had.##
22
23 **Dropped as already covered**: the LibreOffice section. [[Connect to an Internal Office Server>>documentation.xs.admin.exports.office-server-properties.connect-internal-office-server.WebHome]] owns the procedure, [[Office Server Properties>>documentation.xs.admin.exports.office-server-properties.WebHome]] already gives ##/usr/lib/libreoffice## for Linux, and the new Files page carries the rule that a Debian installation configures XWiki through ##/etc/xwiki/xwiki.properties##. The hub links that page instead.
24
25 **Legacy pages**: the original keeps all 35 of its headings, verbatim and in order, each with a pointer, so bookmarked anchors still resolve; it has no attachments. ##Documentation.AdminGuide.InstallationViaAPT##, which is a redirect object rather than a page, is re-aimed at the new hub. Five backlinks are repointed ([[Prerequisites>>documentation.xs.admin.installation.prerequisites.WebHome]], [[Deploy XWiki as the Root Web Application>>documentation.xs.admin.configuration.short-urls.deploy-root-webapp.WebHome]], [[Java Memory for Tomcat>>documentation.xs.admin.installation.methods.install-xwiki-war.configure-servlet-container.configure-tomcat.java-memory.WebHome]], [[Upgrade XWiki Installed from the Debian Packages>>documentation.xs.admin.upgrade.distribution.upgrade-debian-package.WebHome]], [[Installation Methods>>documentation.xs.admin.installation.methods.WebHome]]) along with three old-tree pages; the dated release note, the proposals, the IRC archives and the feedback archive are left alone as historical records, and the extensions-wiki backlink needs its own Change Request since one cannot span two wikis.
26
27

Get Connected