Document requirement for prefork MPM when using mod_php

owncloud-archive · Oct 6, 2017 · 8506629 · 8506629
1 parent 1505bec
commit 8506629
Show file tree

Hide file tree

Showing 3 changed files with 12 additions and 7 deletions.
diff --git a/admin_manual/configuration/server/oc_server_tuning.rst b/admin_manual/configuration/server/oc_server_tuning.rst
@@ -123,11 +123,13 @@ In combination with the periodic checks of the sync client the following setting
 	KeepAliveTimeout 100
 	MaxKeepAliveRequests 200
 
+.. _apache-mpm-label:
+
 MPM
 ~~~
 
-`Apache prefork`_ has to be used. 
-Don’t use threaded ``mpm`` with ``mod_php``, because PHP is currently not thread safe.
+`Apache prefork`_ has to be used. Don’t use a threaded ``MPM`` like ``event`` or ``worker`` with ``mod_php``,
+because PHP is currently `not thread safe`_.
 
 Hostname Lookups
 ~~~~~~~~~~~~~~~~
@@ -152,3 +154,4 @@ However, keep `ErrorLog`_ set, so errors can be tracked down.
 .. _KeepAlive: https://en.wikipedia.org/wiki/HTTP_persistent_connection
 .. _enable HTTP/2 support for Apache: https://httpd.apache.org/docs/2.4/howto/http2.html
 .. _Apache prefork: https://httpd.apache.org/docs/2.4/mod/prefork.html
+.. _not thread safe: https://secure.php.net/manual/en/install.unix.apache2.php
diff --git a/admin_manual/installation/system_requirements.rst b/admin_manual/installation/system_requirements.rst
@@ -16,7 +16,7 @@ Platform          Options
 Operating System  Ubuntu 16.04, Debian 7 and 8, SUSE Linux Enterprise Server 12 
                   and 12 SP1, Red Hat Enterprise Linux/Centos 6.5 and 7 
 Database          MySQL or MariaDB 5.5+, Oracle 11g, PostgreSQL, & SQLite
-Web server        Apache 2.4 with mod_php
+Web server        Apache 2.4 with ``prefork`` :ref:`apache-mpm-label` and ``mod_php``
 PHP Runtime       PHP (5.6+, 7.0, & 7.1)
 ================= =============================================================
 

diff --git a/admin_manual/issues/general_troubleshooting.rst b/admin_manual/issues/general_troubleshooting.rst
@@ -142,10 +142,12 @@ Some common problems / error messages found in your logfiles as described above:
   accessing your SQLite database file in your data directory 
   (``data/owncloud.db``). Please check the permissions of this folder/file or 
   if it exists at all. If you're using MySQL please start your database.
-* ``Connection closed / Operation cancelled`` -> This could be caused by wrong 
-  ``KeepAlive`` settings within your Apache config. Make sure that 
-  ``KeepAlive`` is set to ``On`` and  also try to raise the limits of 
-  ``KeepAliveTimeout`` and  ``MaxKeepAliveRequests``.
+* ``Connection closed / Operation cancelled`` or ``expected filesize 4734206 got 458752``
+  -> This could be caused by wrong ``KeepAlive`` settings within your Apache config.
+  Make sure that ``KeepAlive`` is set to ``On`` and  also try to raise the limits of 
+  ``KeepAliveTimeout`` and  ``MaxKeepAliveRequests``. On Apache with ``mod_php`` using
+  a different :ref:`apache-mpm-label` then ``prefork`` could be another reason. Further
+  information is available at the `forums <https://central.owncloud.org/t/expected-filesize-xxx-got-yyy-0/816>`_.
 * ``No basic authentication headers were found`` -> This error is shown in your
   ``data/owncloud.log`` file. Some Apache modules like ``mod_fastcgi``, ``mod_fcgid``
   or ``mod_proxy_fcgi`` are not passing the needed authentication headers to