[Pkg-owncloud-commits] [owncloud-doc] 23/71: Backport #992 to stable7

[David Prévot]

This is an automated email from the git hooks/post-receive script.

taffit pushed a commit to branch master
in repository owncloud-doc.

commit db3912bdb12f902e9fc3d388a2c9be3c0d5fc679
Author: RealRancor <Fisch.666 at gmx.de>
Date:   Mon Mar 30 11:38:06 2015 +0200

    Backport #992 to stable7
---
 admin_manual/installation/nginx_configuration.rst |  4 ++
 admin_manual/issues/index.rst                     | 58 +++++++++++++++++++++++
 2 files changed, 62 insertions(+)

diff --git a/admin_manual/installation/nginx_configuration.rst b/admin_manual/installation/nginx_configuration.rst
index 2ed7e17..0f9818c 100644
--- a/admin_manual/installation/nginx_configuration.rst
+++ b/admin_manual/installation/nginx_configuration.rst
@@ -39,6 +39,10 @@ Nginx Configuration
     # Disable gzip to avoid the removal of the ETag header
     gzip off;
 
+    # Uncomment if your server is build with the ngx_pagespeed module
+    # This module is currently not supported.
+    #pagespeed off;
+
     rewrite ^/caldav(.*)$ /remote.php/caldav$1 redirect;
     rewrite ^/carddav(.*)$ /remote.php/carddav$1 redirect;
     rewrite ^/webdav(.*)$ /remote.php/webdav$1 redirect;
diff --git a/admin_manual/issues/index.rst b/admin_manual/issues/index.rst
index 0031422..ad70792 100644
--- a/admin_manual/issues/index.rst
+++ b/admin_manual/issues/index.rst
@@ -35,6 +35,64 @@ If you can't find a solution, please use our `bugtracker`_.
 .. _Enterprise Edition: https://owncloud.com/lp/community-or-enterprise/
 .. _bugtracker: http://doc.owncloud.org/server/7.0/developer_manual/bugtracker/index.html
 
+Troubleshooting Webserver and PHP problems
+------------------------------------------
+
+Logfiles
+~~~~~~~~
+
+When having issues the first step is to check the logfiles provided by PHP and
+the Webserver.
+
+.. note:: In the following the paths to the logfiles of a default Debian installation
+   running Apache2 with mod_php is assumed. On other webservers, linux distros or
+   operating systems they can differ.
+
+* The logfile of Apache2 is located in ``/var/log/apache2/error.log``.
+* The logfile of PHP can be configured in your ``/etc/php5/apache2/php.ini``. 
+  You need to set the directive ``log_errors`` to ``On`` and choose the path
+  to store the logfile in the ``error_log`` directive. After those changes you
+  need to restart your Webserver.
+* The logfile of ownCloud is located in the datadirectory ``/var/www/owncloud/data/owncloud.log``.
+
+Webserver and PHP modules
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+There are some Webserver or PHP modules which are known to cause various problems
+like broken up-/downloads. The following shows a draft overview over this modules:
+
+1. Apache
+
+* mod_pagespeed
+* mod_evasive
+* mod_security
+* mod_reqtimeout
+* mod_deflate
+* libapache2-mod-php5filter (use libapache2-mod-php5 instead)
+* mod_spdy together with libapache2-mod-php5 / mod_php (use fcgi or php-fpm instead)
+* mod_dav
+* mod_xsendfile / X-Sendfile (causing broken downloads if not configured correctly)
+
+2. NginX
+
+* ngx_pagespeed
+* HttpDavModule
+* X-Sendfile (causing broken downloads if not configured correctly)
+
+3. Mac OS X server
+
+* mod_auth_apple
+* com.apple.webapp.webdavsharing
+
+4. LigHTTPd
+
+* ModWebDAV
+* X-Sendfile2 (causing broken downloads if not configured correctly)
+
+5. PHP
+
+* eAccelerator
+
 Troubleshooting WebDAV
 ----------------------
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-owncloud/owncloud-doc.git