From cf369cbd788e599ff2433fd2be58043ba4390648 Mon Sep 17 00:00:00 2001 From: Christoph Wurst Date: Mon, 5 Jul 2021 10:38:24 +0200 Subject: [PATCH] Document critical changes for devs and admins in Nextcloud 22 Signed-off-by: Christoph Wurst --- .../email_configuration.rst | 2 + .../upgrade-guide.rst | 55 +++++++++++++++++++ developer_manual/digging_deeper/debugging.rst | 2 + 3 files changed, 59 insertions(+) diff --git a/admin_manual/configuration_server/email_configuration.rst b/admin_manual/configuration_server/email_configuration.rst index f5a62937c66..b7aeca93a62 100644 --- a/admin_manual/configuration_server/email_configuration.rst +++ b/admin_manual/configuration_server/email_configuration.rst @@ -43,6 +43,8 @@ connect Nextcloud to a remote SMTP server: * Login credentials (if required) +.. note:: The ``overwrite.cli.url`` parameter from ``config.php`` will be used for the SMTP EHLO. + .. figure:: ../images/smtp-config-smtp.png Your changes are saved immediately, and you can click the Send Email button to diff --git a/developer_manual/app_publishing_maintenance/upgrade-guide.rst b/developer_manual/app_publishing_maintenance/upgrade-guide.rst index 33e6867d566..a73c5d702d4 100644 --- a/developer_manual/app_publishing_maintenance/upgrade-guide.rst +++ b/developer_manual/app_publishing_maintenance/upgrade-guide.rst @@ -9,11 +9,66 @@ This document will cover the most important changes in Nextcloud, as well as som Upgrading to Nextcloud 22 ------------------------- +.. note:: Critical changes were collected `on Github `__. See the original ticket for links to the pull requests and tickets. + +General +^^^^^^^ + +Migration commands +****************** + +The occ commands in the ``migration:*`` namespace are now only available in :ref:`debug mode`. + +See `the pull request on Github `__ for more information. If you thought you needed them, feel free to ping the author or a reviewer of the PR to solve the problem correctly. Running migrations directly mostly breaks the database status and is therefore only meant for debugging faulty migrations. + +Log format +********** + +The JSON log format no longer contains full exception in the message field, but adds a separate exception entry is added and the existing message will only contain the exception message text. This might need adjustments by administrators when logs are extracted to external sources. + +Front-end changes +^^^^^^^^^^^^^^^^^ + +Node.js upgrade +*************** + +Most Nextcloud apps and Nextcloud itself is now built with Node v14 LTS instead of v12. We recommend updating the configuration of your app accordingly. + +IE11 removal +************ + +Internet Explorer 11 was phased out over the past few releases and starting with Nextcloud 22 the front-end code isn't transpiled for IE11 any longer. You may also drop IE11 from your app as core components will possibly fail with this browser anyway. + +Back-end changes +^^^^^^^^^^^^^^^^ + Removed support for database.xml ******************************** The support for an app's ``appinfo/database.xml`` has been removed. + +LDAP factory availability +************************* + +``\OCP\LDAP\ILDAPProviderFactory`` received a new method ``isAvailable`` so apps can check if LDAP is configured and used before any attributes are fetched or similar. + +Boolean database columns +************************ + +Since Oracle can not store booleans in a non-nullable boolean column Nextcloud doesn't support non-null boolean columns anymore. Apps have to migrate their schema to nullable boolean columns. + + +HTTP 401 for invalid username/password +************************************** + +When invalid username/password is sent to a Nextcloud API, Nextcloud will now respond with a HTTP 401 status instead of 403. + + +Removed APIs +************ +* ``\OCP\User`` + Upgrading to Nextcloud 21 ------------------------- diff --git a/developer_manual/digging_deeper/debugging.rst b/developer_manual/digging_deeper/debugging.rst index c130724400c..3c541af3aa4 100644 --- a/developer_manual/digging_deeper/debugging.rst +++ b/developer_manual/digging_deeper/debugging.rst @@ -2,6 +2,8 @@ Debugging ========= +.. _debug-mode: + Debug mode ----------