Merge pull request #683 from owncloud/selinux

added SELinux howto

admin_manual/installation/index.rst

@@ -14,6 +14,7 @@ Installation
    macos_installation
    nginx_configuration
    others_installation
+   selinux_configuration
    source_installation
    ucs_installation
    windows_installation

admin_manual/installation/linux_installation.rst

@@ -1,8 +1,9 @@
+===================
 Linux Distributions
--------------------
+===================
 
 Supported Distribution Packages
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------------
 
 Ready-to-use packages are available at `openSUSE Build Service`_ for a variety of Linux distributions.
 
@@ -11,12 +12,10 @@ If your distribution is not listed please follow :doc:`source_installation`.
 .. _openSUSE Build Service: http://software.opensuse.org/download.html?project=isv:ownCloud:community&package=owncloud
 
 
-Additional installation guides and notes
-****************************************
-
-**Fedora:** Make sure `SELinux is disabled <https://fedoraproject.org/wiki/SELinux_FAQ#How_do_I_enable_or_disable_SELinux_.3F>`_
-or else the installation process might fail.
+Additional Installation Guides and Notes
+----------------------------------------
 
+See :doc:`selinux_configuration` for a suggested configuration for SELinux-enabled distributions such as Fedora and CentOS.
 
 **Archlinux:** The are two packages for ownCloud: `stable version`_ in the official community repository and `development version`_ in AUR.
 
@@ -28,8 +27,8 @@ or else the installation process might fail.
 
 .. _ownCloud, installation and setup: http://pclinuxoshelp.com/index.php/Owncloud,_installation_and_setup
 
-Follow the wizard to complete your installation
-***********************************************
+Installation Wizard
+-------------------
 
 For setting up your ownCloud instance after installation, please refer to the
 :doc:`installation_wizard` section.

admin_manual/installation/selinux_configuration.rst

@@ -0,0 +1,36 @@
+=====================
+SELinux Configuration
+=====================
+
+When you have SELinux enabled on your Linux distribution, you may run into 
+permissions problems after a new ownCloud installation, and see ``permission 
+denied`` errors in your ownCloud logs. 
+
+The following settings should work for most SELinux systems that use the 
+default distro profiles. Run these commands as root, and remember to adjust the filepaths 
+in these examples for your installation::
+
+ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/owncloud/data'
+ restorecon '/var/www/html/owncloud/data'
+ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/owncloud/config'
+ restorecon '/var/www/html/owncloud/config'
+ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/owncloud/apps'
+ restorecon '/var/www/html/owncloud/apps'
+ 
+If you uninstall ownCloud you need to remove the ownCloud directory labels. To do 
+this execute the following commands as root after uninstalling ownCloud::
+
+ semanage fcontext -d -t httpd_sys_rw_content_t '/var/www/html/owncloud/data'
+ restorecon '/var/www/html/owncloud/data'
+ semanage fcontext -d -t httpd_sys_rw_content_t '/var/www/html/owncloud/config'
+ restorecon '/var/www/html/owncloud/config'
+ semanage fcontext -d -t httpd_sys_rw_content_t '/var/www/html/owncloud/apps'
+ restorecon '/var/www/html/owncloud/apps'
+
+If you have customized SELinux policies and these examples do not work, you must give the 
+HTTP server write access to these directories::
+
+ /var/www/html/owncloud/data
+ /var/www/html/owncloud/config
+ /var/www/html/owncloud/apps
+