[Pkg-owncloud-commits] [owncloud-doc] 15/33: added SELinux howto

[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 34a608359f6329461930dfd45cdd15994ff24e3c
Author: Carla Schroder <carla at owncloud.com>
Date:   Tue Dec 2 16:35:00 2014 -0800

    added SELinux howto
---
 admin_manual/installation/index.rst                |  1 +
 admin_manual/installation/linux_installation.rst   | 17 +++++-----
 .../installation/selinux_configuration.rst         | 36 ++++++++++++++++++++++
 3 files changed, 45 insertions(+), 9 deletions(-)

diff --git a/admin_manual/installation/index.rst b/admin_manual/installation/index.rst
index b7f8fe3..9baa3d7 100644
--- a/admin_manual/installation/index.rst
+++ b/admin_manual/installation/index.rst
@@ -14,6 +14,7 @@ Installation
    macos_installation
    nginx_configuration
    others_installation
+   selinux_configuration
    source_installation
    ucs_installation
    windows_installation
diff --git a/admin_manual/installation/linux_installation.rst b/admin_manual/installation/linux_installation.rst
index a48e657..07b2d34 100644
--- a/admin_manual/installation/linux_installation.rst
+++ b/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.
diff --git a/admin_manual/installation/selinux_configuration.rst b/admin_manual/installation/selinux_configuration.rst
new file mode 100644
index 0000000..c43516b
--- /dev/null
+++ b/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
+

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