From: Wlodek Wencel <wlodek@isc.org>
Date: Fri, 24 Jan 2020 10:26:11 +0000 (+0100)
Subject: [#963] added note about MySQL performance tweak
X-Git-Tag: Kea-1.7.4~98
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3338270cbd85fd81cabfdee2316320dc3ecf5733;p=thirdparty%2Fkea.git

[#963] added note about MySQL performance tweak
---

diff --git a/doc/sphinx/arm/admin.rst b/doc/sphinx/arm/admin.rst
index f584381b37..8957d69f21 100644
--- a/doc/sphinx/arm/admin.rst
+++ b/doc/sphinx/arm/admin.rst
@@ -340,6 +340,27 @@ earlier version. To perform an upgrade, issue the following command:
     According to the naming of collations when the name finishes by ``_ci``
     the collation is case-insensitive.
 
+.. _mysql-performance:
+
+Simple MySQL tweak to gain performance
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Changing MySQL internal value ``innodb_flush_log_at_trx_commit`` from default value
+``1`` to ``2`` can result with huge gain in Kea performance. It can be set per session for testing:
+
+.. code-block:: mysql
+    mysql> SET GLOBAL innodb_flush_log_at_trx_commit=2;
+    mysql> SHOW SESSION VARIABLES LIKE 'innodb_flush_log%';
+
+or permanently in ``/etc/mysql/my.cnf``:
+
+.. code-block:: mysql
+    [mysqld]
+    innodb_flush_log_at_trx_commit=2
+
+Be aware that changing this value can result with problems during data recovery
+after crash, we strongly recommend to check `MySQL documentation <https://dev.mysql.com/doc/refman/8.0/en/innodb-parameters.html#sysvar_innodb_flush_log_at_trx_commit>`__.
+
 .. _pgsql-database:
 
 PostgreSQL