MySQL 5.7 is currently not supported

bareos · Oct 7, 2016 · f85fbab · f85fbab
1 parent 14fe9dd
commit f85fbab
Show file tree

Hide file tree

Showing 3 changed files with 23 additions and 12 deletions.
diff --git a/manuals/en/main/catmaintenance.tex b/manuals/en/main/catmaintenance.tex
@@ -12,15 +12,11 @@ \section{Catalog Database}
 Different database backends are supported:
 \begin{itemize}
     \item PostgreSQL
-    \item MySQL/MariaDB
+    \item MariaDB/MySQL (see \nameref{sec:MysqlSupport})
     \item Sqlite (only for testing)
 \end{itemize}
 
-What database will be used, can be configured in \file{/etc/bareos/bareos-dir.conf}, see the \nameref{DirectorResourceCatalog}.
-
-As MariaDB is a fork of MySQL, we use MySQL as synonym for MariaDB.
-We test our packages against the prefered MySQL fork that a distribution provides.
-\index[general]{MariaDB|see{MySQL}}
+What database will be used, can be configured in the \bareosDir configuration, see the \nameref{DirectorResourceCatalog}.
 
 The database often runs on the same server as the Bareos Director.
 However, it is also possible to run it on a different system.
@@ -954,6 +950,19 @@ \section{MySQL/MariaDB}
 \index[general]{Database!MySQL}
 \index[general]{MySQL}
 
+\subsection{MySQL/MariaDB Support}
+\index[general]{MariaDB|see{MySQL}}
+\label{sec:MysqlSupport}
+
+As MariaDB is a fork of MySQL, we use MySQL as synonym for MariaDB and fully support it.
+We test our packages against the preferred MySQL fork that a distribution provides.
+
+\limitation{MySQL}{MySQL $\geq$ 5.7 not supported}{%
+MySQL 5.7 did change it behavior in some respects. The result is, that the Bareos database creation scripts do not work any more.
+For the time being, we advise to use MariaDB instead, which is also the default on most Linux distributions.
+See \ticket{705}.
+}
+
 \subsection{Compacting Your MySQL Database}
 \index[general]{Database!MySQL!Compacting}
 \label{CompactingMySQL}

diff --git a/manuals/en/main/install.tex b/manuals/en/main/install.tex
@@ -47,16 +47,18 @@ \section{Decide about the Database Backend}
 Bareos supports following database backends:
 \begin{itemize}
     \item PostgreSQL by package \package{bareos-database-postgresql}
-    \item MySQL by package \package{bareos-database-mysql}
+    \item MariaDB/MySQL by package \package{bareos-database-mysql}
     \item Sqlite by package \package{bareos-database-sqlite3} \\
         \warning{The Sqlite backend is only intended for testing, not for productive use.}
 \end{itemize}
 
-The PostgreSQL backend is the default.
-However, the MySQL backend is also supported,
-while the Sqlite backend is intended for testing purposes only.
+\paragraph{PostgreSQL} is the default backend. If you have no other preferences, you should use this one.
 
-The Bareos database packages have there dependencies only to the database client packages, 
+\paragraph{MariaDB/MySQL} backend is also supported. If your system offers both, you should use MariaDB, see \nameref{sec:MysqlSupport}.
+
+\paragraph{Sqlite} backend is intended for testing purposes only.
+
+The Bareos database packages have there dependencies only to the database client packages,
 therefore the database itself must be installed manually.
 
 

diff --git a/manuals/en/main/requirements.tex b/manuals/en/main/requirements.tex
@@ -11,7 +11,7 @@ \chapter{System Requirements}
    are:
    \begin{itemize}
    \item PostgreSQL 8.4 (since Bareos 13.2.3)
-   \item MySQL 4.1 or compatible fork (e.g. MariaDB)
+   \item MySQL 4.1 - 5.6 or compatible fork (e.g. MariaDB), see \nameref{sec:MysqlSupport}
    \item SQLite 3
    \end{itemize}
 \item Windows release is cross-compiled on Linux