Commit 19ae0993 authored by Etienne Allovon's avatar Etienne Allovon

Enhance database page

parent 4ede1b8b
......@@ -17,29 +17,36 @@ On first startup the database will be initialized and the required structure and
Custom database configuration
=============================
The database image contains a default postgres configuration and some specific defaults required by our application. The postgres default configuration is located in ``/var/lib/postgresql/11/main/postgresql.conf`` and our custom defaults are in ``/var/lib/postgresql/11/main/conf.d/00-xivo-default.conf``. Do not change these files! If you need to change some parameters, create another file in ``/var/lib/postgresql/11/main/conf.d/`` prefixed with a number like ``01`` or upper and with a ``.conf`` extension. This file will be loaded after all defaults and can override any parameter.
The database image contains a default postgres configuration and some specific defaults required by our application:
* the postgres default configuration is located in :file:`/var/lib/postgresql/11/main/postgresql.conf`
* and our custom defaults are in :file:`/var/lib/postgresql/11/main/conf.d/00-xivo-default.conf`.
.. warning:: Do not change these files!
If you need to change some parameters, create another file in :file:`/var/lib/postgresql/11/main/conf.d/` prefixed with a number like ``01`` or upper and with a ``.conf`` extension. This file will be loaded after all defaults and can override any parameter.
Sample configuration
********************
--------------------
Here is an example to increase the default number of concurrent connection to the database:
``/var/lib/postgresql/11/main/conf.d/10-custom-max-connection.conf``::
:file:`/var/lib/postgresql/11/main/conf.d/10-custom-max-connection.conf`::
max_connections = 300
Files path summary table
========================
+------------------------+-------------------------------------+-------------------------------------------------------------------------------------------------------+
| File | Path | Comment |
+========================+=====================================+=======================================================================================================+
| pg_hba.conf | /var/lib/postgresql/11/main/ | |
+------------------------+-------------------------------------+-------------------------------------------------------------------------------------------------------+
| postgresql.conf | /var/lib/postgresql/11/main/ | Please, do not edit this file but use overriding mechanism explain in :ref:`database_configuration` |
| postgresql.conf | /var/lib/postgresql/11/main/ | Please, do not edit this file but use overriding mechanism explained in :ref:`database_configuration` |
+------------------------+-------------------------------------+-------------------------------------------------------------------------------------------------------+
| conf.d files | /var/lib/postgresql/11/main/conf.d/ | Files are handled in Lexicographical order |
+------------------------+-------------------------------------+-------------------------------------------------------------------------------------------------------+
| pg_hba.conf | /var/lib/postgresql/11/main/ | Configure connection authorization in this file |
+------------------------+-------------------------------------+-------------------------------------------------------------------------------------------------------+
| postgresql-11-main.log | /var/log/postgresql/ | Database log file. |
+------------------------+-------------------------------------+-------------------------------------------------------------------------------------------------------+
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment