Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document critical changes for devs and admins in Nextcloud 22 #6900

Merged
merged 1 commit into from
Jul 5, 2021
Merged

Document critical changes for devs and admins in Nextcloud 22 #6900

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions admin_manual/configuration_server/email_configuration.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
55 changes: 55 additions & 0 deletions developer_manual/app_publishing_maintenance/upgrade-guide.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://github.com/nextcloud/server/issues/26407>`__. 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<debug-mode>`.

See `the pull request on Github <https://github.com/nextcloud/server/pull/27113>`__ 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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor typo: "..., but adds a separate exception entry is added ..."


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
-------------------------

Expand Down
2 changes: 2 additions & 0 deletions developer_manual/digging_deeper/debugging.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
Debugging
=========

.. _debug-mode:

Debug mode
----------

Expand Down