new page 'Warnings on Admin Page'

admin_manual/configuration_server/index.rst

@@ -5,6 +5,7 @@ ownCloud Server Configuration
 .. toctree::
    :maxdepth: 2
 
+   security_setup_warnings
    occ_command
    activity_configuration
    antivirus_configuration

admin_manual/configuration_server/performance_tuning.rst

@@ -56,7 +56,12 @@ performance. To do so, add the following to ``/etc/fstab``::
 
 	none /tmp tmpfs,size=6g defaults
 
-Make sure the APC or Opcache bytecode cache is installed. This example is for 
+.. _caching:
+	
+Caching
+=======	
+
+Install the APC or Opcache bytecode cache. This example is for 
 CentOS/Red Hat/Fedora running PHP 5.4:
 
 .. code-block:: console
@@ -72,6 +77,22 @@ On Ubuntu systems running PHP 5.4 this command installs APC:
 PHP 5.5 replaces APC with Opcache. Opcache is bundled with PHP 5.5 so it should 
 not be necessary to install it separately.
 
+APC is both an opcode cache and data store. OPcache is only an opcode cache, so 
+for caching user data you should install APCu.
+
+Distributed PHP environments should use Memcached. Memcached servers must be 
+specified in the ``memcached_servers`` array in ownCloud's config file 
+``config.php``. For examples see :doc:`config_sample_php_parameters`
+
+OPcache Extension
+-----------------
+
+OPcache improves PHP performance by storing precompiled script bytecode in 
+shared memory, thereby removing the need for PHP to load and parse scripts on 
+each request. This extension is bundled with PHP 5.5.0 and later, and is 
+available in PECL for PHP versions 5.2, 5.3, and 5.4.
+
+
 Tuning System Parameters
 ========================
 
@@ -142,15 +163,6 @@ directory.
 ownCloud Server Tuning
 **********************
 
-Object Caching
-==============
-
-ownCloud is written to take advantage of object caching. Object caching can be 
-done locally with the APCu extension, or for distributed PHP environments using 
-Memcached. Memcached servers must be specified in the ``memcached_servers`` array 
-in ownCloud's config file ``config.php``. For examples see 
-:doc:`config_sample_php_parameters`
-
 Serving static files via web server
 ===================================
 
@@ -163,15 +175,7 @@ Using cron to perform background jobs
 
 See the section :doc:`background_jobs_configuration` for a description and the 
 benefits.
-
-OPcache Extension
-=================
-
-OPcache improves PHP performance by storing precompiled script bytecode in 
-shared memory, thereby removing the need for PHP to load and parse scripts on 
-each request. This extension is bundled with PHP 5.5.0 and later, and is 
-available in PECL for PHP versions 5.2, 5.3, and 5.4.
-          
+         
 ********************          
 SSL / Encryption App
 ********************

admin_manual/configuration_server/security_setup_warnings.rst

@@ -0,0 +1,48 @@
+======================
+Warnings on Admin Page
+======================
+
+Your ownCloud server has a built-in configuration checker, and it reports its 
+findings at the top of your Admin page. These are some of the warnings you 
+might see, and what to do about them.
+
+.. figure:: ../images/security-setup-warning-1.png
+
+Cache Warnings
+--------------
+
+"No memory cache has been configured. To enhance your performance please 
+configure a memcache if available." PHP has three caching extentions: APCu, 
+OPCache, and Xcache. You will see this warning if you have no caches installed, 
+and you may see it if you have APCu < 4.0.6 installed; older versions are 
+disabled because of performance problems. 
+
+If you see "APCu below version 4.0.6 is installed. for stability and 
+performance reasons we recommend to update to a newer APCu version" then you 
+need to upgrade, or, if you're not using it, remove it.
+
+It is not required to use any caches, but caches improve server performance. See 
+:doc:`performance_tuning` for more information on installing and using caches.
+
+You are accessing this site via HTTP
+------------------------------------
+
+"You are accessing this site via HTTP. We strongly suggest you configure your 
+server to require using HTTPS instead." Please take this warning seriously; 
+using HTTPS is a fundamental security measure. You must configure your Web 
+server to support it, and then there are some settings in the **Security** 
+section of your ownCloud Admin page to enable. The following manual pages 
+describe how to enable HTTPS on the Apache and Nginx Web servers.
+
+
+`Enabling SSL (on Apache) 
+<https://doc.owncloud.org/server/8.1/admin_manual/installation/ 
+source_installation.html#enabling-ssl>`_
+
+`Use HTTPS 
+<https://doc.owncloud.org/server/8.1/admin_manual/configuration_server/ 
+harden_server.html#use-https>`_
+
+`Nginx 
+Configuration <https://doc.owncloud.org/server/8.1/admin_manual/installation/ 
+nginx_configuration.html>`_