Skip to content
This repository has been archived by the owner on Feb 20, 2019. It is now read-only.

stable9.1: Document requirement for prefork MPM when using mod_php #3443

Merged
merged 1 commit into from
Oct 10, 2017
Merged

stable9.1: Document requirement for prefork MPM when using mod_php #3443

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions admin_manual/installation/source_installation.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -281,6 +281,14 @@ Additional Apache Configurations
CardDAV clients make sure you have configured the correct
:ref:`service-discovery-label` URLs.

.. _apache-mpm-label:

Multi-Processing Module (MPM)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

`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`_.

.. _enabling_ssl_label:

Enabling SSL
Expand Down Expand Up @@ -448,3 +456,8 @@ Other Web Servers

`Univention Corporate Server installation
<https://github.com/owncloud/documentation/wiki/UCS-Installation>`_

.. Links

.. _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
2 changes: 1 addition & 1 deletion admin_manual/installation/system_requirements.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Platform Options
================= =============================================================
Operating System Ubuntu 16.04
Database MySQL or MariaDB 5.5+
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.4, 5.5, 5.6, and 7.0)
================= =============================================================

Expand Down
10 changes: 6 additions & 4 deletions admin_manual/issues/general_troubleshooting.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down