khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-12-12 07:29:47 +07:00
Code Issues Packages Projects Releases Wiki Activity

fix: Add server-side setup check note to upgrade_to_28

Browse Source 
Signed-off-by: Josh <josh.t.richards@gmail.com>
This commit is contained in:
Josh
2024-07-11 14:29:40 -04:00
committed by GitHub
parent 0e85f78782
commit 9b1c20861b
1 changed files with 22 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
admin_manual/release_notes/upgrade_to_28.rst
View File

@@ -18,6 +18,27 @@ Web server configuration
* For Nginx, please refer to our recommended :ref:`Nginx configuration<nginx-config>`.
* 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``.
.. 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``.