Ready for review
Wiki source code of Convert the Debian/Ubuntu (.DEB) installation documentation into the new tree
Last modified by Eleni Cojocariu on 2026/11/16 18:40
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 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 |