mirrors/nextcloud-documentation
3
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-10-26 11:18:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update linux_database_configuration.rst

Browse Source
This commit is contained in:
Marius Blüm 2016-06-12 18:00:15 +02:00 committed by GitHub
parent 8a0498ae75
commit 469de0d1fe
1 changed files with 12 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
admin_manual/configuration_database/linux_database_configuration.rst
View File

@ -2,21 +2,18 @@
Database Configuration
======================
ownCloud requires a database in which administrative data is stored. The following databases are currently supported:
Nextcloud requires a database in which administrative data is stored. The following databases are currently supported:
* `MySQL <http://www.mysql.com/>`_ / `MariaDB <https://mariadb.org/>`_
* `PostgreSQL <http://www.postgresql.org/>`_
* `Oracle <http://www.oracle.com/>`_ (ownCloud Enterprise edition only)
The MySQL or MariaDB databases are the recommended database engines.
Requirements
------------
Choosing to use MySQL / MariaDB, PostgreSQL, or Oracle (ownCloud Enterprise
edition only) as your database requires that you install and set up the server
software first.
(Oracle users, see :doc:`../enterprise_installation/oracle_db_configuration`.)
Choosing to use MySQL / MariaDB or PostgreSQL, as your database requires that
you install and set up the server software first.
.. note:: The steps for configuring a third party database are beyond the scope of this document. Please refer to the documentation for your specific database choice for instructions.
@ -25,12 +22,12 @@ software first.
MySQL / MariaDB with Binary Logging Enabled
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
ownCloud is currently using a ``TRANSACTION_READ_COMMITTED`` transaction isolation
Nextcloud is currently using a ``TRANSACTION_READ_COMMITTED`` transaction isolation
to avoid data loss under high load scenarios (e.g. by using the sync client with
many clients/users and many parallel operations). This requires a disabled or
correctly configured binary logging when using MySQL or MariaDB. Your system is
affected if you see the following in your log file during the installation or
update of ownCloud:
update of Nextcloud:
An unhandled exception has been thrown:
exception 'PDOException' with message 'SQLSTATE[HY000]: General error: 1665
@ -53,7 +50,7 @@ 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.
For setting up Nextcloud 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 Nextcloud instance to a database created by a previous installation of Nextcloud), some modification might be required.
Configuring a MySQL or MariaDB Database
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -62,7 +59,7 @@ If you decide to use a MySQL or MariaDB database, ensure the following:
* That you have installed and enabled the pdo_mysql extension in PHP
* That the **mysql.default_socket** points to the correct socket (if the database runs on the same server as ownCloud).
* That the **mysql.default_socket** points to the correct socket (if the database runs on the same server as Nextcloud).
.. note:: MariaDB is backwards compatible with MySQL. All instructions work for both. You will not need to replace mysql with anything.
@ -88,7 +85,7 @@ The PHP configuration in :file:`/etc/php5/conf.d/mysql.ini` could look like this
mysql.trace_mode=Off
Now you need to create a database user and the database itself by using the
MySQL command line interface. The database tables will be created by ownCloud
MySQL command line interface. The database tables will be created by Nextcloud
when you login for the first time.
To start the MySQL command line mode use::
@ -107,7 +104,7 @@ You can quit the prompt by entering::
quit
An ownCloud instance configured with MySQL would contain the hostname on which
An Nextcloud instance configured with MySQL would contain the hostname on which
the database is running, a valid username and password to access it, and the
name of the database. The :file:`config/config.php` as created by the
:doc:`../installation/installation_wizard` would therefore contain entries like
@ -162,7 +159,7 @@ You can quit the prompt by entering::
\q
An ownCloud instance configured with PostgreSQL would contain the path to the socket on
An Nextcloud instance configured with PostgreSQL would contain the path to the socket on
which the database is running as the hostname, the system username the php process is using,
and an empty password to access it, and the name of the database. The :file:`config/config.php` as
created by the :doc:`../installation/installation_wizard` would therefore contain entries like
@ -184,7 +181,7 @@ this:
If you use another authentication method (not peer), you'll need to use the following steps to get the database setup:
Now you need to create a database user and the database itself by using the
PostgreSQL command line interface. The database tables will be created by
ownCloud when you login for the first time.
Nextcloud when you login for the first time.
To start the postgres command line mode use::
@ -203,7 +200,7 @@ You can quit the prompt by entering::
\q
An ownCloud instance configured with PostgreSQL would contain the hostname on
An Nextcloud instance configured with PostgreSQL would contain the hostname on
which the database is running, a valid username and password to access it, and
the name of the database. The :file:`config/config.php` as created by the
:doc:`../installation/installation_wizard` would therefore contain entries like