From 9b1c20861b0a06be2f643ca2a10b5fee08e1126f Mon Sep 17 00:00:00 2001 From: Josh Date: Thu, 11 Jul 2024 14:29:40 -0400 Subject: [PATCH] fix: Add server-side setup check note to upgrade_to_28 Signed-off-by: Josh --- admin_manual/release_notes/upgrade_to_28.rst | 23 +++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/admin_manual/release_notes/upgrade_to_28.rst b/admin_manual/release_notes/upgrade_to_28.rst index 5fd9fe19b..bd2cda912 100644 --- a/admin_manual/release_notes/upgrade_to_28.rst +++ b/admin_manual/release_notes/upgrade_to_28.rst @@ -18,6 +18,27 @@ Web server configuration * For Nginx, please refer to our recommended :ref:`Nginx configuration`. * For other setups, make sure to add ``.mjs`` to the list of static file extensions in web server configs and in case define its MIME type in ``/etc/mime.types``. +Setup Checks +------------ + +The setup checks (the ones visible under *Administration settings->Overview*) that previously ran from the web browser now run server-side rather than from the browser. + +This means that some false positives may be triggered in existing installations after upgrading. This does not mean the checks are invalid or broken. It does mean that local configuration matters that may not have had obvious side effects previously may now prevent the tests from getting accurate results. + +In nearly all cases the resolution is one or more of the following: + +- verifying all entries in ``trusted_domains`` and the value of ``overwrite.cli.url`` are valid, resolvable in DNS, and reachable *from the Nextcloud Server itself* +- verifying that the Server can reach its own URL(s) +- verifying all ``overwrite*`` config values are reasonable + +In diagnosing the above, many admins have found it useful to review not only their `config.php` (for cleanup) but also: + +- their local DNS resolvers and ``/etc/hosts`` files for reasonableness +- their firewall configurations +- their container network configuration if using Docker/etc (especially for outbound connectivity) + +.. tip:: Testing of connectivity and reachability of specific URLs can usually be tested from servers or containers via ``curl`` or ``wget``. + Monitoring ---------- @@ -46,4 +67,4 @@ We expect LibreOffice to be started with the given parameters, so it's unfavorab Please reach out to us via https://github.com/nextcloud/server/pull/41395 if that's causing any trouble for you. -.. tip:: Previews for EMF files can be enabled without a local LibreOffice installation if you are already using Nextcloud Office / Collabora. Make sure you have Nextcloud Office 8.3.0 installed and add ``'OCA\Richdocuments\Preview\EMF'`` to ``enabledPreviewProviders``. \ No newline at end of file +.. tip:: Previews for EMF files can be enabled without a local LibreOffice installation if you are already using Nextcloud Office / Collabora. Make sure you have Nextcloud Office 8.3.0 installed and add ``'OCA\Richdocuments\Preview\EMF'`` to ``enabledPreviewProviders``.