From 5641f8f4e98cd5d6036a3db0cc325750f21f394a Mon Sep 17 00:00:00 2001 From: RealRancor Date: Mon, 11 Jul 2016 10:44:28 +0200 Subject: [PATCH] Update MySQL / MariaDB database requirements. --- .../linux_database_configuration.rst | 12 ++++++++++++ .../configuration_server/security_setup_warnings.rst | 8 ++++++++ admin_manual/installation/system_requirements.rst | 11 ++++++++++- 3 files changed, 30 insertions(+), 1 deletion(-) diff --git a/admin_manual/configuration_database/linux_database_configuration.rst b/admin_manual/configuration_database/linux_database_configuration.rst index 8f3c1db69..085f99d2b 100644 --- a/admin_manual/configuration_database/linux_database_configuration.rst +++ b/admin_manual/configuration_database/linux_database_configuration.rst @@ -51,6 +51,18 @@ Log `_ and `The Binary Log `_ 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 `_ +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. diff --git a/admin_manual/configuration_server/security_setup_warnings.rst b/admin_manual/configuration_server/security_setup_warnings.rst index 8becf93b6..07b24169b 100644 --- a/admin_manual/configuration_server/security_setup_warnings.rst +++ b/admin_manual/configuration_server/security_setup_warnings.rst @@ -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. \ No newline at end of file diff --git a/admin_manual/installation/system_requirements.rst b/admin_manual/installation/system_requirements.rst index fe167cd84..c7dd66b5f 100644 --- a/admin_manual/installation/system_requirements.rst +++ b/admin_manual/installation/system_requirements.rst @@ -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`)