khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-04 02:36:49 +07:00
Code Issues Packages Projects Releases Wiki Activity

correct all caching references to point to caching page

Browse Source
This commit is contained in:
Carla Schroder
2015-10-01 13:38:16 -07:00
parent 4434bd8e32
commit 4c88547394
6 changed files with 33 additions and 90 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
admin_manual/configuration_files/files_locking_transactional.rst
View File

@@ -20,29 +20,22 @@ The new file locking mechanism has these capabilities:
* Manages locks correctly on external storage mounts
* Manages encrypted files correctly
You must install the Redis server and ``php-redis`` module for the new file
locking to work. On Debian/Ubuntu/Mint this is ``redis-server`` and
``php5-redis``, and on Red Hat/CentOS/Fedora is it ``redis``
and ``php-pecl-redis`` from the EPEL repository. After installing Redis and its
corresponding PHP module, restart your HTTP server.
You must install the Redis server and corresponding PHP module for the new file
locking to work. (See :doc:`../configuration_server/caching_configuration`.)
After installing Redis you must enter a simple configuration in your
``config.php`` file, like this example::
After installing Redis you must enter a configuration in your ``config.php``
file like this example::
'filelocking.enabled' => 'true',
'memcache.locking' => '\OC\Memcache\Redis',
'redis' => array(
'host' => 'localhost',
// can also be a unix domain socket:
'/tmp/redis.sock',
'port' => 6379,
'timeout' => 0.0,
// Optional, if undefined SELECT will not run and will use Redis
// Server's default DB Index.
//'dbindex' => 0,
),
),
The **Server status** section on your ownCloud Admin page indicates whether experimental file locking is enabled or disabled.
The **Server status** section on your ownCloud Admin page indicates whether
experimental file locking is enabled or disabled.
.. figure:: ../images/transactional-locking-1.png

56
admin_manual/configuration_server/performance_tuning.rst
View File

@@ -53,58 +53,10 @@ benefits.
Caching
-------
.. note:: Memory cache configuration for the ownCloud server is no longer
automatic, requiring configuration in config.php with the keys
memcache.local and/or memcache.distributed;
see :doc:`config_sample_php_parameters`.
Before the memcache.local can be used you need to install
APC, APCu or XCache.
Caching improves performance by storing data, code, and other objects in
memory.
The APC or OPCache bytecode cache are commonly used in PHP environments. This
example installs APC on CentOS/Red Hat/Fedora systems running PHP 5.4:
.. code-block:: console
$ sudo yum install php-pecl-apc
On Ubuntu systems running PHP 5.4 this command installs APC:
.. code-block:: console
$ sudo apt-get install php-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. 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.
APC is both an opcode cache and data store. OPCache is only an opcode cache, so
for caching user data you should also install APCu.
You can test the state of APC(u) by putting the testing file from the
documentation
in your server root. It is usually called 'apc.php' and can be found in
/usr/share/doc/php5-apcu/apc.php or /usr/share/doc/packages/php5-apcu/apc.php or
a similar location, depending on your distribution.
The Redis key-value cache and store is an excellent fast and robust cache. For
configuration examples see :doc:`config_sample_php_parameters`.
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`.
.. note:: When a memory cache has been configured, but is unavailable due to a
a missing extension or server downtime, ownCloud will be
inaccessible, as a memory cache is considered to be a vital
component.
This does not however affect **occ**, which will instead just print
a warning to the logs.
Caching improves performance by storing data, code, and other objects in memory.
Memory cache configuration for the ownCloud server is no longer automatic in
ownCloud 8.1 and up, but must be installed and configured. See
:doc:`caching_configuration`.
Webserver Tips
--------------

15
admin_manual/configuration_server/security_setup_warnings.rst
View File

@@ -15,22 +15,21 @@ Cache Warnings
configure a memcache if available." ownCloud supports multiple php caching
extentions:
* APC
* APCu (minimum required php extension version: 4.0.6)
* APC (PHP 5.4 only)
* APCu (PHP 5.5+, minimum required PHP extension version 4.0.6)
* Memcached
* Redis (minimum required php extension version: 2.2.5)
* Xcache
You will see this warning if you have no caches installed or if your cache
does not have the required minimum version installed; older versions are
disabled because of performance problems.
You will see this warning if you have no caches installed and enabled, or if
your cache does not have the required minimum version installed; older versions
are disabled because of performance problems.
If you see "*{Cache}* below version *{Version}* is installed. for stability and
performance reasons we recommend to update to a newer *{Cache}* 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
:ref:`caching` for more information on installing and using caches.
You are not required to use any caches, but caches improve server performance.
See :doc:`caching_configuration`.
You are accessing this site via HTTP
------------------------------------

18
admin_manual/configuration_user/user_auth_ldap.rst
View File

@@ -582,7 +582,8 @@ Caching
-------
The LDAP cache has changed in ownCloud 8.1. There is no more file cache, but
only a memory cache, and you must install and configure the memory cache. The
only a memory cache, and you must install and configure the memory cache (see
:doc:`../configuration_server/caching_configuration`). The
simplest memory cache to use is APCu. This is supplied by the ``php5-apcu``
package on Debian/Ubuntu/Mint, and by ``php-pecl-apcu`` on Red
Hat/CentOS/Fedora.
@@ -598,26 +599,21 @@ each unique request expires. User logins are not cached, so if you need to
improve login times set up a slave LDAP server to share the load.
The Redis key-value cache and store is an excellent fast and robust cache, and
if you are using the new experimental file locking (see
:doc:`../configuration_files/files_locking_transactional`) then you must use
Redis. Redis configuration looks like this::
if you are using :doc:`Transaction File Locking
<../configuration_files/files_locking_transactional>`) then you must use Redis.
A Redis configuration looks like this::
'filelocking.enabled' => 'true',
'memcache.local' => '\OC\Memcache\Redis',
'redis' => array(
'host' => 'localhost',
// can also be a unix domain socket:
'/tmp/redis.sock'
'port' => 6379,
'timeout' => 0.0,
// Optional, if undefined SELECT will not run and will use Redis
// Server's default DB Index.
'dbindex' => 0,
),
),
Redis is supplied by the ``redis-server`` and ``php5-redis`` packages on
Debian/Ubuntu/Mint, and on Red Hat/CentOS/Fedora by ``redis`` and
``php-pecl-redis`` from the EPEL repository.
``php-pecl-redis`` from the EPEL repository.
You can adjust the **Cache Time-To-Live** value to balance performance and
freshness of LDAP data. All LDAP requests will be cached for 10 minutes by

7
admin_manual/installation/source_installation.rst
View File

@@ -71,11 +71,14 @@ Recommended for specific apps (*optional*):
* PHP module exif (for image rotation in pictures app)
* PHP module gmp (for SFTP storage)
For enhanced server performance (*optional* / select only one of the following):
For enhanced server performance (*optional*) select one of the following):
* PHP module apc
* PHP module apcu
* PHP module xcache
* PHP module memcached
* PHP module redis
See :doc:`../configuration_server/caching_configuration`.
For preview generation (*optional*):

6
admin_manual/release_notes.rst
View File

@@ -58,9 +58,9 @@ PHP or contact your vendor if you receive these errors.
The persistent file-based cache (e.g. used by LDAP integration) has been dropped and
replaced with a memory-only cache, which must be explicitly configured. See
:doc:`configuration_user/user_auth_ldap`. Memory cache configuration for the
ownCloud server is no longer automatic, requiring configuration in
``config.php`` with the keys ``memcache.local`` and/or ``memcache.distributed``;
see :ref:`caching`.
ownCloud server is no longer automatic, requiring installation of
your desired cache backend and configuration in
``config.php`` (see :doc:`configuration_server/caching_configuration`.)
The OC_User_HTTP backend has been removed. Administrators are encouraged to use
the ``user_webdavauth`` application instead.