Update MySQL / MariaDB database requirements.

This commit is contained in:
RealRancor 2016-07-11 10:44:28 +02:00 committed by Joas Schilling
parent 0ded4b905b
commit 5641f8f4e9
No known key found for this signature in database
GPG Key ID: E166FD8976B3BAC8
3 changed files with 30 additions and 1 deletions

View File

@ -51,6 +51,18 @@ Log <https://mariadb.com/kb/en/mariadb/overview-of-the-binary-log/>`_ and `The
Binary Log <https://dev.mysql.com/doc/refman/5.6/en/binary-log.html>`_ for
detailed information.
.. _db-transaction-label:
Database "READ COMMITED" transaction isolation level
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
As discussed above Nextcloud is using the ``TRANSACTION_READ_COMMITTED`` transaction isolation
level. Some database configurations are enforcing other transaction isolation levels. To avoid
data loss under high load scenarios (e.g. by using the sync client with many clients/users and
many parallel operations) you need to configure the transaction isolation level accordingly.
Please refer to the `MySQL manual <https://dev.mysql.com/doc/refman/5.7/en/set-transaction.html>`_
for detailed information.
Parameters
----------
For setting up ownCloud to use any database, use the instructions in :doc:`../installation/installation_wizard`. You should not have to edit the respective values in the :file:`config/config.php`. However, in special cases (for example, if you want to connect your ownCloud instance to a database created by a previous installation of ownCloud), some modification might be required.

View File

@ -119,3 +119,11 @@ Some files have not passed the integrity check
----------------------------------------------
Please refer to the :ref:`code_signing_fix_warning_label` documentation how to debug this issue.
Your database does not run with "READ COMMITED" transaction isolation level
---------------------------------------------------------------------------
"Your database does not run with "READ COMMITED" transaction isolation level.
This can cause problems when multiple actions are executed in parallel."
Please refer to :ref:`db-transaction-label` how to configure your database for this requirement.

View File

@ -10,7 +10,7 @@ depending on the numbers of users and files, and volume of server activity.
Nextcloud needs a minimum of 128MB RAM, and we recommend a minimum of 512MB.
Recommended Setup for Running Nextcloud
--------------------------------------
---------------------------------------
For best performance, stability, support, and full functionality we recommend:
@ -39,3 +39,12 @@ Supported Platforms
See :doc:`source_installation` for minimum software versions for installing
Nextcloud.
Database Requirements for MySQL / MariaDB
-----------------------------------------
The following is currently required if you're running Nextcloud together with a MySQL / MariaDB database:
* Disabled or BINLOG_FORMAT = MIXED configured Binary Logging (See: :ref:`db-binlog-label`)
* InnoDB storage engine (MyISAM is not supported)
* "READ COMMITED" transaction isolation level (See: :ref:`db-transaction-label`)