[Pkg-owncloud-commits] [owncloud] 03/10: Imported Upstream version 8.2.2~dfsg

David Prévot taffit at moszumanska.debian.org
Tue Dec 22 16:50:40 UTC 2015


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

taffit pushed a commit to branch stable8
in repository owncloud.

commit caef0f45abb80901cddab118875d7902fef86310
Merge: 257fe88 d60d903
Author: David Prévot <taffit at debian.org>
Date:   Mon Dec 21 17:06:07 2015 -0400

    Imported Upstream version 8.2.2~dfsg

 core/doc/admin/_images/wnd-3.jpg                   | Bin 0 -> 47004 bytes
 .../files_locking_transactional.txt                |   2 +-
 .../configuration_server/caching_configuration.txt |   2 +-
 .../_sources/configuration_user/user_auth_ldap.txt |  10 ++++-
 .../windows-network-drive_configuration.txt        |  21 +++++++----
 .../_sources/installation/source_installation.txt  |  33 +++++++++++------
 core/doc/admin/_sources/release_notes.txt          |   2 +
 .../files_locking_transactional.html               |   2 +-
 .../caching_configuration.html                     |   2 +-
 .../admin/configuration_user/user_auth_ldap.html   |   8 +++-
 .../windows-network-drive_configuration.html       |  18 ++++++---
 .../admin/installation/source_installation.html    |  41 ++++++++++++---------
 core/doc/admin/release_notes.html                  |   1 +
 core/skeleton/ownCloud_User_Manual.pdf             | Bin 2544984 -> 0 bytes
 version.php                                        |   8 ++--
 15 files changed, 95 insertions(+), 55 deletions(-)

diff --cc core/doc/admin/_images/wnd-3.jpg
index 0000000,0000000..45aa4d3
new file mode 100644
Binary files differ
diff --cc core/doc/admin/_sources/configuration_files/files_locking_transactional.txt
index 5fc17db,0000000..cb5e3c5
mode 100644,000000..100644
--- a/core/doc/admin/_sources/configuration_files/files_locking_transactional.txt
+++ b/core/doc/admin/_sources/configuration_files/files_locking_transactional.txt
@@@ -1,72 -1,0 +1,72 @@@
 +==========================
 +Transactional File Locking
 +==========================
 +
 +ownCloud's Transactional File Locking mechanism locks files to avoid 
 +file corruption during normal operation. It performs these functions:
 +
 +* Operates at a higher level than the filesystem, so you don't need to use a 
 +  filesystem that supports locking
 +* Locks parent directories so they cannot be renamed during any activity on 
 +  files inside the directories
 +* Releases locks after file transactions are interrupted, for 
 +  example when a sync client loses the connection during an upload
 +* Manages locking and releasing locks correctly on shared files during changes 
 +  from multiple users
 +* Manages locks correctly on external storage mounts
 +* Manages encrypted files correctly
 +
 +.. note:: Transactional file locking is in core, and replaces the old File 
 +   Locking app. The File Locking app has been removed from ownCloud in version 
 +   8.2.1. If your ownCloud server still has the File Locking app, you must 
 +   visit your Apps page to verify that it is disabled; the File Locking app and 
 +   Transactional File Locking cannot both operate at the same time.
 +   
 +When you see the warning on your ownCloud admin page "Transactional file locking 
 +is using the database as locking backend, for best performance it's advised to 
 +configure a memcache for locking", you are not required to use a memcache. File 
 +locking is enabled by default, using the database locking backend. This 
 +places a significant load on your database. Using ``memcache.locking`` relieves 
 +the database load and improves performance. Admins of ownCloud servers with 
 +heavy workloads should install a memcache. (See 
 +:doc:`../configuration_server/caching_configuration`.)  
 +
 +To use a memcache with Transactional File Locking, you must install the Redis 
 +server and corresponding PHP module. 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',
 +       'port' => 6379,
 +       'timeout' => 0.0,
 +       'password' => '', // Optional, if not defined no password will be used.
 +        ),
 +
 +.. note:: For enhanced security it is recommended to configure Redis to require
 +   a password. See http://redis.io/topics/security for more information.
 +
 +If you want to configure Redis to listen on an Unix socket (which is
 +recommended if Redis is running on the same system as ownCloud) use this example
 +``config.php`` configuration::
 +
 +  'filelocking.enabled' => 'true',
 +  'memcache.locking' => '\OC\Memcache\Redis',
 +  'redis' => array(
 +       'host' => '/var/run/redis/redis.sock',
 +       'port' => 0,
 +       'timeout' => 0.0,
 +        ),
 +   
 +See ``config.sample.php`` to see configuration examples for Redis, and for all 
 +supported memcaches.
 +
 +If you are on Ubuntu you can follow `this guide 
- <https://www.en0ch.se/how-to-configure-redis-cache-in-ubuntu-14-04-with-owncloud/>`_ for a complete installation from scratch. 
++<https://www.techandme.se/how-to-configure-redis-cache-in-ubuntu-14-04-with-owncloud/>`_ for a complete installation from scratch. 
 +
 +Learn more about Reds at `Redis <http://redis.io/>`_. Memcached, the popular 
 +distributed memory caching system, is not suitable for the new file locking 
 +because it is not designed to store locks, and data can disappear from the cache 
 +at any time. Redis is a key-value store, and it guarantees that cached objects 
 +are available for as long as they are needed. 
diff --cc core/doc/admin/_sources/configuration_server/caching_configuration.txt
index b963fac,0000000..78f87c0
mode 100644,000000..100644
--- a/core/doc/admin/_sources/configuration_server/caching_configuration.txt
+++ b/core/doc/admin/_sources/configuration_server/caching_configuration.txt
@@@ -1,205 -1,0 +1,205 @@@
 +==========================
 +Configuring Memory Caching
 +==========================
 +
 +You can significantly improve your ownCloud server performance with memory 
 +caching, where frequently-requested objects are stored in memory for faster 
 +retrieval. There are two types of caches to use: a PHP opcode cache, which is 
 +commonly called *opcache*, and data caching for your Web server. If you do not 
 +install and enable a local memcache you will see a warning on your ownCloud 
 +admin page. A memcache is not required and you may ignore the warning if you 
 +prefer.
 +
 +.. note:: If you enable only a distributed cache in 
 +   your ``config.php`` (``memcache.distributed``) and not a 
 +   local cache (``memcache.local``) you will still see the cache warning.
 +
 +A PHP opcache stores compiled PHP scripts so they don't need to be re-compiled 
 +every time they are called. PHP bundles the Zend OPcache in core since version 
 +5.5, so you don't need to install an opcache.
 +
 +If you are using PHP 5.4, which is the oldest supported PHP version for 
 +ownCloud, you may install the Alternative PHP Cache (APC). This is both an 
 +opcache and data cache. APC has not been updated since 2012 and is essentially 
 +dead, and PHP 5.4 is old and lags behind later releases. If it is possible 
 +to upgrade to a later PHP release that is the best option.
 +
 +Data caching is supplied by the Alternative PHP Cache, user (APCu) in PHP 
 +5.5+, Memcached, or Redis.
 +
 +ownCloud supports multiple memory caching backends, so you can choose the type 
 +of memcache that best fits your needs. The supported caching backends are:
 +
 +* `APC <http://php.net/manual/en/book.apc.php>`_ 
 +   A local cache for systems running PHP 5.4.
 +* `APCu <https://pecl.php.net/package/APCu>`_, APCu 4.06 and up required.
 +   A local cache for systems running PHP 5.5 and up.
 +* `Memcached <http://www.memcached.org/>`_ 
 +   Distributed cache for multi-server ownCloud installations.
 +* `Redis <http://redis.io/>`_, PHP module 2.2.5 and up required.
 +   For distributed caching, and required for Transactional File Locking.
 +
 +These are supported but not recommended:
 +
 +* `XCache <http://xcache.lighttpd.net/>`_ 
 +* `ArrayCache <http://www.arbylon.net/projects/knowceans-tools/doc/org/knowceans/util/ArrayCache.html>`_
 +   
 +Memcaches must be explicitly configured in ownCloud 8.1 and up by installing 
 +and enabling your desired cache, and then adding the appropriate entry to 
 +``config.php`` (See :doc:`config_sample_php_parameters` for an overview of
 +all possible config parameters).
 +
 +You may use both a local and a distributed cache. Recommended caches are APCu 
 +and Redis. After installing and enabling your chosen memcache, verify that it is 
 +active by running :ref:`label-phpinfo`.
 +   
 +APC
 +---
 +
 +APC is only for systems running PHP 5.4 and older. The oldest supported PHP 
 +version in ownCloud is 5.4.
 +
 +.. note:: RHEL 6 and CentOS 6 ship with PHP 5.3 and must be upgraded to PHP 
 +   5.4 to run ownCloud. See :doc:`../installation/php_54_installation`.
 +
 +On Red Hat/CentOS/Fedora systems running PHP 5.4, install ``php-pecl-apc``. On 
 +Debian/Ubuntu/Mint systems install ``php-apc``. Then restart your Web server. 
 + 
 +After restarting your Web server, add this line to your ``config.php`` file::
 +
 + 'memcache.local' => '\OC\Memcache\APC',
 + 
 +Refresh your ownCloud admin page, and the cache warning should disappear.
 +
 +APCu
 +----
 +
 +PHP 5.5 and up includes the Zend OPcache in core, and on most Linux 
 +distributions it is enabled by default. However, it does 
 +not bundle a data cache. APCu is a data cache, and it is available in most 
 +Linux distributions. On Red Hat/CentOS/Fedora systems running PHP 5.5 and up 
 +install ``php-pecl-apcu``. On Debian/Ubuntu/Mint systems install ``php5-apcu``. 
 +Then restart your Web server.
 + 
 +The version of APCu must be 4.0.6 and up.
 +
 +After restarting your Web server, add this line to your ``config.php`` file::
 +
 + 'memcache.local' => '\OC\Memcache\APCu',
 + 
 +Refresh your ownCloud admin page, and the cache warning should disappear.
 +
 +.. finish this later. too vexing to bother with now.
 +.. Enabling PHP opcache
 +.. ^^^^^^^^^^^^^^^^^^^^
 +..
 +.. Use :ref:`label-phpinfo` to see if your PHP opcache is already enabled by 
 +.. searching for ``opcache.enable``. If it says ``on`` then it is enabled and 
 +.. you don't need to do anything. Figure 1 is from Linux Mint 17; the Zend 
 +.. OPcache is enabled by default and ``phpinfo`` displays status and statistics.
 +..
 +.. .. figure:: images/cache-1.png
 +..   :alt: The Zend OPcache section displays opcode cache status and statistics.
 +..  
 +..   *Figure 1: Zend OPcache status in phpinfo*
 +..   
 +.. If it is not enabled, then go into    
 +
 +Memcached
 +---------
 +
 +Memcached is a reliable oldtimer for shared caching on distributed servers, 
 +and performs well with ownCloud with one exception: it is not suitable to use 
 +with :doc:`Transactional File Locking <../configuration_files/files_locking_transactional>`
 +because it does not store locks, and data can disappear from the cache at any time
 +(Redis is the best for this). 
 +
 +.. note:: Be sure to install the **memcached** PHP module, and not memcache, as 
 +   in the following examples. ownCloud supports only the **memcached** PHP 
 +   module.
 +
 +Setting up Memcached is easy. On Debian/Ubuntu/Mint install ``memcached`` and 
 +``php5-memcached``. The installer will automatically start ``memcached`` and 
 +configure it to launch at startup.
 +
 +On Red Hat/CentOS/Fedora install ``memcached`` and 
 +``php-pecl-memcached``. It will not start automatically, so you must use 
 +your service manager to start ``memcached``, and to launch it at boot as a 
 +daemon.
 + 
 +You can verify that the Memcached daemon is running with ``ps ax``::
 +
 + ps ax | grep memcached
 + 19563 ? Sl 0:02 /usr/bin/memcached -m 64 -p 11211 -u memcache -l 
 + 127.0.0.1
 +
 +Restart your Web server, add the appropriate entries to your 
 +``config.php``, and refresh your ownCloud admin page. This example uses APCu 
 +for the local cache, Memcached as the distributed memcache, and lists all the 
 +servers in the shared cache pool with their port numbers::
 +
 + 'memcache.local' => '\OC\Memcache\APCu',
 + 'memcache.distributed' => '\OC\Memcache\Memcached',
 + 'memcached_servers' => array(
 +      array('localhost', 11211),
 +      array('server1.example.com', 11211),
 +      array('server2.example.com', 11211), 
 +      ), 
 +
 +Redis
 +-----
 +
 +Redis is an excellent modern memcache to use for both distributed caching, and 
 +as a local cache with :doc:`Transactional File Locking 
 +<../configuration_files/files_locking_transactional>` because it guarantees 
 +that cached objects are available for as long as they are needed.
 +
 +The Redis PHP module must be version 2.2.5 and up.
 +
 +On Debian/Ubuntu/Mint install ``redis-server`` and ``php5-redis``. The installer 
 +will automatically launch ``redis-server`` and configure it to launch at 
 +startup.
 +
 +On Red Hat/CentOS/Fedora install ``redis`` and ``php-pecl-redis``. It will not 
 +start automatically, so you must use your service manager to start 
 +``redis``, and to launch it at boot as a daemon.
 + 
 +You can verify that the Redis daemon is running with ``ps ax``::
 + 
 + ps ax | grep redis
 + 22203 ? Ssl    0:00 /usr/bin/redis-server 127.0.0.1:6379 
 + 
 +Restart your Web server, add the appropriate entries to your ``config.php``, and 
 +refresh your ownCloud admin page. This example ``config.php`` configuration uses 
 +Redis for the local server cache::
 +
 +  'memcache.local' => '\OC\Memcache\Redis',
 +  'redis' => array(
 +       'host' => 'localhost',
 +       'port' => 6379,
 +       'timeout' => 0.0,
 +        ),
 +
 +If you want to connect to Redis configured to listen on an unix socket (which is
 +recommended if Redis is running on the same system as ownCloud) use this example
 +``config.php`` configuration::
 +
 +  'memcache.local' => '\OC\Memcache\Redis',
 +  'redis' => array(
 +       'host' => '/var/run/redis/redis.sock',
 +       'port' => 0,
 +       'timeout' => 0.0,
 +        ),
 +
 +Redis is very configurable; consult `the Redis documentation 
 +<http://redis.io/documentation>`_ to learn more.
 +
 +If you are on Ubuntu you can follow `this guide 
- <https://www.en0ch.se/how-to-configure-redis-cache-in-ubuntu-14-04-with-owncloud/>`_ for a complete installation from scratch. 
++<https://www.techandme.se/how-to-configure-redis-cache-in-ubuntu-14-04-with-owncloud/>`_ for a complete installation from scratch. 
 +
 +Cache Directory Location
 +------------------------
 +
 +The cache directory defaults to ``data/$user/cache`` where ``$user`` is the 
 +current user. You may use the ``'cache_path'`` directive in ``config.php``
 +(See :doc:`config_sample_php_parameters`) to select a different location.
diff --cc core/doc/admin/_sources/configuration_user/user_auth_ldap.txt
index 93bfbf5,0000000..a35d041
mode 100644,000000..100644
--- a/core/doc/admin/_sources/configuration_user/user_auth_ldap.txt
+++ b/core/doc/admin/_sources/configuration_user/user_auth_ldap.txt
@@@ -1,632 -1,0 +1,638 @@@
 +=============================
 +User Authentication with LDAP
 +=============================
 +
 +ownCloud ships with an LDAP application to allow LDAP users (including Active 
 +Directory) to appear in your ownCloud user listings. These users will 
 +authenticate to ownCloud with their LDAP credentials, so you don't have to 
 +create separate ownCloud user accounts for them. You will manage their ownCloud 
 +group memberships, quotas, and sharing permissions just like any other ownCloud 
 +user.
 +
 +.. Note:: The PHP LDAP module is required; this is supplied by ``php5-ldap`` on 
 +   Debian/Ubuntu, and ``php-ldap`` on CentOS/Red Hat/Fedora. PHP 5.4+ is 
 +   required in ownCloud 8.1.
 +
 +The LDAP application supports:
 +
 +* LDAP group support
 +* File sharing with ownCloud users and groups
 +* Access via WebDAV and ownCloud Desktop Client
 +* Versioning, external Storage and all other ownCloud features
 +* Seamless connectivity to Active Directory, with no extra configuration 
 +  required
 +* Support for primary groups in Active Directory
 +* Auto-detection of LDAP attributes such as base DN, email, and the LDAP server 
 +  port number
 +* Read-only access to your LDAP (no edit or delete of users on your LDAP) 
 +
 +.. Note:: The LDAP app is not compatible with the ``User backend using remote HTTP servers`` app. 
 +   You cannot use both of them at the same time.
 +
 +.. note:: A non-blocking or correctly configured SELinux setup is needed
 +   for the LDAP backend to work. Please refer to the :ref:`selinux-config-label`.
 +
 +Configuration
 +-------------
 +
 +First enable the ``LDAP user and group backend`` app on the Apps page in 
 +ownCloud. Then go to your Admin page to configure it.
 +
 +The LDAP configuration panel has four tabs. A correctly completed first tab 
 +("Server") is mandatory to access the other tabs. A green indicator lights when 
 +the configuration is correct. Hover your cursor over the fields to see some 
 +pop-up tooltips. 
 +
 +Server Tab
 +^^^^^^^^^^
 +
 +Start with the Server tab. You may configure multiple servers if you have them. 
 +At a minimum you must supply the LDAP server's hostname. If your server requires 
 +authentication, enter your credentials on this tab. ownCloud will then attempt 
 +to auto-detect the server's port and base DN. The base DN and port are 
 +mandatory, so if ownCloud cannot detect them you must enter them manually.
 +
 +.. figure:: ../images/ldap-wizard-1-server.png
 +
 +Server configuration:
 +  Configure one or more LDAP servers. Click the **Delete Configuration** 
 +  button to remove the active configuration.
 +
 +Host:
 +  The host name or IP address of the LDAP server. It can also be a **ldaps://** 
 +  URI. If you enter the port number, it speeds up server detection.
 +  
 +  Examples:
 +
 +  * *directory.my-company.com*
 +  * *ldaps://directory.my-company.com*
 +  * *directory.my-company.com:9876*
 +
 +Port:
 +  The port on which to connect to the LDAP server. The field is disabled in the
 +  beginning of a new configuration. If the LDAP server is running on a standard 
 +  port, the port will be detected automatically. If you are using a 
 +  non-standard port, ownCloud will attempt to detect it. If this fails you must 
 +  enter the port number manually.
 +
 +  Example:
 +
 +  * *389*
 +
 +User DN:
 +  The name as DN of a user who has permissions to do searches in the LDAP 
 +  directory. Leave it empty for anonymous access. We recommend that you have a 
 +  special LDAP system user for this.
 +
 +  Example:
 +
 +  * *uid=owncloudsystemuser,cn=sysusers,dc=my-company,dc=com*
 +
 +Password:
 +  The password for the user given above. Empty for anonymous access.
 +
 +Base DN:
 +  The base DN of LDAP, from where all users and groups can be reached. You may 
 +  enter multiple base DNs, one per line. (Base DNs for users and groups can be 
 +  set in the Advanced tab.) This field is mandatory. ownCloud attempts to 
 +  determine the Base DN according to the provided User DN or the provided 
 +  Host, and you must enter it manually if ownCloud does not detect it.
 +
 +  Example:
 +
 +  * *dc=my-company,dc=com*
 +
 +User Filter
 +^^^^^^^^^^^
 +
 +Use this to control which LDAP users are listed as ownCloud users on your 
 +ownCloud server. In order to control which LDAP users can login to your 
 +ownCloud 
 +server use the Login filter. Those LDAP users who have access but are not 
 +listed 
 +as users (if there are any) will be hidden users. You may bypass the form 
 +fields 
 +and enter a raw LDAP filter if you prefer.
 +
 +.. figure:: ../images/ldap-wizard-2-user.png
 +
 +only those object classes:
 +  ownCloud will determine the object classes that are typically available for
 +  user objects in your LDAP. ownCloud will automatically select the object 
 +  class that returns the highest amount of users. You may select multiple 
 +  object classes.
 +
 +only from those groups:
 +  If your LDAP server supports the ``member-of-overlay`` in LDAP filters, you 
 +  can define that only users from one or more certain groups are allowed to
 +  appear in user listings in ownCloud. By default, no value will be selected. 
 +You
 +  may select multiple groups.
 +
 +  If your LDAP server does not support the member-of-overlay in LDAP filters,
 +  the input field is disabled. Please contact your LDAP administrator.
 +
 +Edit raw filter instead:
 +  Clicking on this text toggles the filter mode and you can enter the raw LDAP 
 +  filter directly. Example::
 +
 +   (&(objectClass=inetOrgPerson)(memberOf=cn=owncloudusers,ou=groups,
 +   dc=example,dc=com))
 +
 +x users found:
 +  This is an indicator that tells you approximately how many users will be
 +  listed in ownCloud. The number updates automatically after any changes.
 +
 +Login Filter
 +^^^^^^^^^^^^
 +
 +The settings in the Login Filter tab determine which LDAP users can log in to 
 +your
 +ownCloud system and which attribute or attributes the provided login name is 
 +matched
 +against (e.g. LDAP/AD username, email address). You may select multiple user 
 +details.
 +(You may bypass the form fields and enter a raw LDAP filter if you prefer.)
 +
 +You may override your User Filter settings on the User Filter tab by using a 
 +raw 
 +LDAP filter.
 +
 +.. figure:: ../images/ldap-wizard-3-login.png
 +
 +LDAP Username:
 +  If this value is checked, the login value will be compared to the username in
 +  the LDAP directory. The corresponding attribute, usually *uid* or
 +  *samaccountname* will be detected automatically by ownCloud.
 +
 +LDAP Email Address:
 +  If this value is checked, the login value will be compared to an email address
 +  in the LDAP directory; specifically, the *mailPrimaryAddress* and *mail* 
 +  attributes.
 +
 +Other Attributes:
 +  This multi-select box allows you to select other attributes for the 
 +  comparison. The list is generated automatically from the user object 
 +  attributes in your LDAP server.
 +
 +Edit raw filter instead:
 +  Clicking on this text toggles the filter mode and you can enter the raw LDAP 
 +  filter directly.
 +
 +  The **%uid** placeholder is replaced with the login name entered by the 
 +  user upon login.
 +
 +  Examples:
 +
 +  * only username:: 
 +
 +     (&(objectClass=inetOrgPerson)(memberOf=cn=owncloudusers,ou=groups,
 +     dc=example,dc=com)(uid=%uid)
 +  
 +  * username or email address::
 +  
 +     ((&(objectClass=inetOrgPerson)(memberOf=cn=owncloudusers,ou=groups,
 +     dc=example,dc=com)(|(uid=%uid)(mail=%uid)))
 +
 +Group Filter
 +^^^^^^^^^^^^
 +
 +By default, no LDAP groups will be available in ownCloud. The settings in the 
 +group filter tab determine which groups will be available in ownCloud. You may 
 +also elect to enter a raw LDAP filter instead.
 +
 +.. figure:: ../images/ldap-wizard-4-group.png
 +
 +only those object classes:
 +  ownCloud will determine the object classes that are typically available for
 +  group objects in your LDAP server. ownCloud will only list object
 +  classes that return at least one group object. You can select multiple
 +  object classes. A typical object class is "group", or "posixGroup".
 +
 +only from those groups:
 +  ownCloud will generate a list of available groups found in your LDAP server. 
 +  and then you select the group or groups that get access to your ownCloud 
 +  server.
 +
 +Edit raw filter instead:
 +  Clicking on this text toggles the filter mode and you can enter the raw LDAP 
 +  filter directly.
 +
 +  Example:
 +
 +  * *objectClass=group*
 +  * *objectClass=posixGroup*
 +
 +y groups found:
 +  This tells you approximately how many groups will be available in ownCloud. 
 +  The number updates automatically after any change.
 +
 +
 +Advanced Settings
 +-----------------
 +
 +The LDAP Advanced Setting section contains options that are not needed for a 
 +working connection. This provides controls to disable the current 
 +configuration, 
 +configure replica hosts, and various performance-enhancing options.
 +
 +The Advanced Settings are structured into three parts:
 +
 +* Connection Settings
 +* Directory Settings
 +* Special Attributes
 +
 +Connection Settings
 +^^^^^^^^^^^^^^^^^^^
 +
 +.. figure:: ../images/ldap-advanced-1-connection.png
 +
 +   LDAP Advanced Settings, section Connection Settings
 +
 +Configuration Active:
 +  Enables or Disables the current configuration. By default, it is turned off. 
 +  When ownCloud makes a successful test connection it is automatically turned 
 +  on.
 +
 +Backup (Replica) Host:
 +  If you have a backup LDAP server, enter the connection settings here. 
 +  ownCloud will then automatically connect to the backup when the main server 
 +  cannot be reached. The backup server must be a replica of the main server so 
 +  that the object UUIDs match.
 +
 +  Example:
 +
 +  * *directory2.my-company.com*
 +
 +Backup (Replica) Port:
 +  The connection port of the backup LDAP server. If no port is given,
 +  but only a host, then the main port (as specified above) will be used.
 +
 +  Example:
 +
 +  * *389*
 +
 +Disable Main Server:
 +  You can manually override the main server and make ownCloud only connect to
 +  the backup server. This is useful for planned downtimes.
 +
 +Turn off SSL certificate validation:
 +  Turns off SSL certificate checking. Use it for testing only!
 +
 +Cache Time-To-Live:
 +  A cache is introduced to avoid unnecessary LDAP traffic, for example caching 
 +  usernames so they don't have to be looked up for every page, and speeding up 
 +  loading of the Users page. Saving the configuration empties the cache. The 
 +  time is given in seconds.
 +
 +  Note that almost every PHP request requires a new connection to the LDAP 
 +  server. If you require fresh PHP requests we recommend defining a minimum 
 +  lifetime of 15s or so, rather than completely eliminating the cache.
 +
 +  Examples:
 +
 +  * ten minutes: *600*
 +  * one hour: *3600*
 +  
 +See the Caching section below for detailed information on how the cache 
 +operates.
 +
 +Directory Settings
 +^^^^^^^^^^^^^^^^^^^
 +
 +.. figure:: ../images/ldap-advanced-2-directory.png
 +
 +   LDAP Advanced Settings, section Directory Settings
 +
 +User Display Name Field:
 +  The attribute that should be used as display name in ownCloud.
 +
 +  *  Example: *displayName*
 +
 +Base User Tree:
 +  The base DN of LDAP, from where all users can be reached. This must be a 
 +  complete DN, regardless of what you have entered for your Base DN in the 
 +  Basic setting. You can specify multiple base trees, one on each line.
 +
 +  * Example:
 +
 +    | *cn=programmers,dc=my-company,dc=com*
 +    | *cn=designers,dc=my-company,dc=com*
 +
 +User Search Attributes:
 +  These attributes are used when searches for users are performed, for example 
 +  in the share dialogue. The user display name attribute is the 
 +  default. You may list multiple attributes, one per line.
 +
 +  If an attribute is not available on a user object, the user will not be 
 +  listed, and will be unable to login. This also affects the display name 
 +  attribute. If you override the default you must specify the display name 
 +  attribute here.
 +
 +  * Example:
 +
 +    | *displayName*
 +    | *mail*
 +
 +Group Display Name Field:
 +  The attribute that should be used as ownCloud group name. ownCloud allows a
 +  limited set of characters (a-zA-Z0-9.-_@). Once a group name is assigned it 
 +  cannot be changed.
 +
 +  * Example: *cn*
 +
 +Base Group Tree:
 +  The base DN of LDAP, from where all groups can be reached. This must be a 
 +  complete DN, regardless of what you have entered for your Base DN in the 
 +  Basic setting. You can specify multiple base trees, one in each line.
 +
 +  * Example:
 +
 +    | *cn=barcelona,dc=my-company,dc=com*
 +    | *cn=madrid,dc=my-company,dc=com*
 +
 +Group Search Attributes:
 +  These attributes are used when a search for groups is done, for example in 
 +  the share dialogue. By default the group display name attribute as specified 
 +  above is used. Multiple attributes can be given, one in each line.
 +
 +  If you override the default, the group display name attribute will not be
 +  taken into account, unless you specify it as well.
 +
 +  * Example:
 +
 +    | *cn*
 +    | *description*
 +
 +Group Member association:
 +  The attribute that is used to indicate group memberships, i.e. the attribute
 +  used by LDAP groups to refer to their users.
 +
 +  ownCloud detects the value automatically. You should only change it if you
 +  have a very valid reason and know what you are doing.
 +
 +  * Example: *uniquemember*
 +
 +Special Attributes
 +^^^^^^^^^^^^^^^^^^
 +
 +.. figure:: ../images/ldap-advanced-3-attributes.png
 +
 +   LDAP Advanced Settings, section Special Attributes
 +
 +Quota Field:
 +  ownCloud can read an LDAP attribute and set the user quota according to its
 +  value. Specify the attribute here, and it will return human-readable values, 
 +  e.g. "2 GB". Any quota set in LDAP overrides quotas set on the ownCloud user 
 +  management page.
 +
 +  * Example: *ownCloudQuota*
 +
 +Quota Default:
 +  Override ownCloud default quota for LDAP users who do not have a quota set in 
 +  the Quota Field.
 +
 +  * Example: *15 GB*
 +
 +Email Field:
 +  Set the user's email from their LDAP attribute. Leave it empty for default 
 +  behavior.
 +
 +  * Example: *mail*
 +
 +User Home Folder Naming Rule:
 +  By default, the ownCloud server creates the user directory in your ownCloud 
-   data directory. You may want to override this setting and name it after an 
-   attribute value. The attribute given can also return an absolute path, e.g. 
++  data directory and gives it the ownCloud username, .e.g ``/var/www/owncloud/data/alice``. You may want to override this setting and name it after an LDAP
++  attribute value. The attribute can also return an absolute path, e.g. 
 +  ``/mnt/storage43/alice``. Leave it empty for default behavior.
 +
 +  * Example: *cn*
 +
++In new ownCloud installations (8.0.10, 8.1.5, 8.2.0 and up) the home folder rule is enforced. This means that once you set a home folder naming rule (get a home folder from an LDAP attribute), it must be available for all users. If it isn't available for a user, then that user will not be able to login. Also, the filesystem will not be set up for that user, so their file shares will not be available to other users.
++
++In existing ownCloud installations the old behavior still applies, which is using the ownCloud username as the home folder when an LDAP attribute is not set. You may change this to enforcing the home folder rule with the ``occ`` command in ownCloud 8.2, like this example on Ubuntu::
++
++  sudo -u www-data php occ config:app:set user_ldap enforce_home_folder_naming_rule --value=1 
++  
 +Expert Settings
 +---------------
 +
 +.. figure:: ../images/ldap-expert.png
 +
 +In the Expert Settings fundamental behavior can be adjusted to your needs. The
 +configuration should be well-tested before starting production use.
 +
 +Internal Username:
 +  The internal username is the identifier in ownCloud for LDAP users. By default
 +  it will be created from the UUID attribute. The UUID attribute ensures that 
 +  the username is unique, and that characters do not need to be converted. Only 
 +  these characters are allowed: [\a-\zA-\Z0-\9_. at -]. Other characters are 
 +  replaced with their ASCII equivalents, or are simply omitted.
 +
 +  The LDAP backend ensures that there are no duplicate internal usernames in
 +  ownCloud, i.e. that it is checking all other activated user backends
 +  (including local ownCloud users). On collisions a random number (between 1000
 +  and 9999) will be attached to the retrieved value. For example, if "alice"
 +  exists, the next username may be "alice_1337".
 +
 +  The internal username is the default name for the user home folder in 
 +  ownCloud. It is also a part of remote URLs, for instance for all \*DAV 
 +  services.
 +
 +  You can override all of this with the Internal Username setting. Leave it 
 +  empty for default behaviour. Changes will affect only newly mapped LDAP users.
 +
 +  * Example: *uid*
 +
 +Override UUID detection
 +  By default, ownCloud auto-detects the UUID attribute. The UUID attribute is
 +  used to uniquely identify LDAP users and groups. The internal username will 
 +  be created based on the UUID, if not specified otherwise.
 +
 +  You can override the setting and pass an attribute of your choice. You must
 +  make sure that the attribute of your choice can be fetched for both users and
 +  groups and it is unique. Leave it empty for default behaviour. Changes will
 +  have effect only on newly mapped LDAP users and groups. It also will
 +  have effect when a user's or group's DN changes and an old UUID was cached, 
 +  which will result in a new user. Because of this, the setting should be 
 +  applied before putting ownCloud in production use and clearing the bindings
 +  (see the ``User and Group Mapping`` section below).
 +
 +  * Example: *cn*
 +
 +Username-LDAP User Mapping
 +  ownCloud uses usernames as keys to store and assign data. In order to
 +  precisely identify and recognize users, each LDAP user will have a internal
 +  username in ownCloud. This requires a mapping from ownCloud username to LDAP
 +  user. The created username is mapped to the UUID of the LDAP user.
 +  Additionally the DN is cached as well to reduce LDAP interaction, but it is
 +  not used for identification. If the DN changes, the change will be detected by
 +  ownCloud by checking the UUID value.
 +
 +  The same is valid for groups.
 +
 +  The internal ownCloud name is used all over in ownCloud. Clearing the Mappings
 +  will have leftovers everywhere. Never clear the mappings in a production 
 +  environment, but only in a testing or experimental server.
 +
 +  **Clearing the Mappings is not configuration sensitive, it affects all LDAP
 +  configurations!**
 +
 +Testing the configuration
 +-------------------------
 +
 +The **Test Configuration** button checks the values as currently given in the 
 +input fields. You do not need to save before testing. By clicking on the 
 +button, ownCloud will try to bind to the ownCloud server using the
 +settings currently given in the input fields. If the binding fails you'll see a 
 +yellow banner with the error message "The configuration is invalid. Please have 
 +a look at the logs for further details." 
 +
 +When the configuration test reports success, save your settings and check if the 
 +users and groups are fetched correctly on the Users page.
 +
 +ownCloud Avatar integration
 +---------------------------
 +
 +ownCloud supports user profile pictures, which are also called avatars. If a user 
 +has a photo stored in the *jpegPhoto* or *thumbnailPhoto* attribute on your LDAP 
 +server, it will be used as their avatar. In this case the user cannot alter their 
 +avatar (on their Personal page) as it must be changed in LDAP. *jpegPhoto* is 
 +preferred over *thumbnailPhoto*.
 +
 +.. figure:: ../images/ldap-fetched-avatar.png
 +
 +   Profile picture fetched from LDAP
 +
 +If the *jpegPhoto* or *thumbnailPhoto* attribute is not set or empty, then 
 +users can upload and manage their avatars on their ownCloud Personal pages. 
 +Avatars managed in ownCloud are not stored in LDAP.
 +
 +The *jpegPhoto* or *thumbnailPhoto* attribute is fetched once a day to make
 +sure the current photo from LDAP is used in ownCloud. LDAP avatars override 
 +ownCloud avatars, and when an LDAP avatar is deleted then the most recent 
 +ownCloud avatar replaces it.
 +
 +Photos served from LDAP are automatically cropped and resized in ownCloud. This 
 +affects only the presentation, and the original image is not changed.
 +
 +Troubleshooting, Tips and Tricks
 +--------------------------------
 +
 +SSL Certificate Verification (LDAPS, TLS)
 +-----------------------------------------
 +
 +A common mistake with SSL certificates is that they may not be known to PHP.
 +If you have trouble with certificate validation make sure that
 +
 +* You have the certificate of the server installed on the ownCloud server
 +* The certificate is announced in the system's LDAP configuration file (usually
 +  */etc/ldap/ldap.conf*
 +  
 +.. commenting out windows section as windows server is not supported  
 +..  *C:\\openldap\\sysconf\\ldap.conf* or
 +..  *C:\\ldap.conf* on Windows) using a **TLS_CACERT /path/to/cert** line.
 +
 +* Using LDAPS, also make sure that the port is correctly configured (by default
 +  636)
 +
 +Microsoft Active Directory
 +--------------------------
 +
 +Compared to earlier ownCloud versions, no further tweaks need to be done to
 +make ownCloud work with Active Directory. ownCloud will automatically find the
 +correct configuration in the set-up process.
 +
 +memberOf / Read MemberOf permissions
 +------------------------------------
 +
 +If you want to use ``memberOf`` within your filter you might need to give your
 +querying user the permissions to use it. For Microsoft Active Directory this
 +is described `here <https://serverfault.com/questions/167371/what-permissions-are
 +-required-for-enumerating-users-groups-in-active-directory/167401#167401>`_.
 +
 +Duplicating Server Configurations
 +---------------------------------
 +
 +In case you have a working configuration and want to create a similar one or
 +"snapshot" configurations before modifying them you can do the following:
 +
 +#. Go to the **Server** tab
 +#. On **Server Configuration** choose *Add Server Configuration*
 +#. Answer the question *Take over settings from recent server configuration?*
 +   with *yes*.
 +#. (optional) Switch to **Advanced** tab and uncheck **Configuration Active**
 +   in the *Connection Settings*, so the new configuration is not used on Save
 +#. Click on **Save**
 +
 +Now you can modify and enable the configuration.
 +
 +ownCloud LDAP Internals
 +-----------------------
 +
 +Some parts of how the LDAP backend works are described here.
 +
 +User and Group Mapping
 +^^^^^^^^^^^^^^^^^^^^^^
 +
 +In ownCloud the user or group name is used to have all relevant information in
 +the database assigned. To work reliably a permanent internal user name and
 +group name is created and mapped to the LDAP DN and UUID. If the DN changes in
 +LDAP it will be detected, and there will be no conflicts.
 +
 +Those mappings are done in the database table ``ldap_user_mapping`` and
 +``ldap_group_mapping``. The user name is also used for the user's folder (except
 +if something else is specified in *User Home Folder Naming Rule*), which
 +contains files and meta data.
 +
 +As of ownCloud 5 the internal user name and a visible display name are separated.
 +This is not the case for group names, yet, i.e. a group name cannot be altered.
 +
 +That means that your LDAP configuration should be good and ready before putting
 +it into production. The mapping tables are filled early, but as long as you are
 +testing, you can empty the tables any time. Do not do this in production.
 +
 +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 (see 
 +:doc:`../configuration_server/caching_configuration`). The ownCloud  **Cache**
 +helps to speed up user interactions and sharing. It is populated on demand,
 +and remains populated until the **Cache Time-To-Live** for 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.
 +
 +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 
 +default, and you can alter this with the **Cache Time-To-Live** setting. The 
 +cache answers each request that is identical to a previous request, within the 
 +time-to-live of the original request, rather than hitting the LDAP server.
 +
 +The **Cache Time-To-Live** is related to each single request. After a cache 
 +entry expires there is no automatic trigger for re-populating the information, 
 +as the cache is populated only by new requests, for example by opening the 
 +User administration page, or searching in a sharing dialog.
 +
 +There is one trigger which is automatically triggered by a certain background 
 +job which keeps the ``user-group-mappings`` up-to-date, and always in cache.
 +
 +Under normal circumstances, all users are never loaded at the same time. 
 +Typically the loading of users happens while page results are generated, in 
 +steps of 30 until the limit is reached or no results are left. For this to 
 +work on an oC-Server and LDAP-Server, **Paged Results** must be supported, 
 +which presumes PHP >= 5.4.
 +
 +ownCloud remembers which user belongs to which LDAP-configuration. That means 
 +each request will always be directed to the right server unless a user is 
 +defunct, for example due to a server migration or unreachable server. In this 
 +case the other servers will also receive the request.
 +
 +Handling with Backup Server
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +When ownCloud is not able to contact the main LDAP server, ownCloud assumes it 
 +is offline and will not try to connect again for the time specified in **Cache 
 +Time-To-Live**. If you have a backup server configured ownCloud will connect to 
 +it instead. When you have scheduled downtime, check **Disable Main Server**  to 
 +avoid unnecessary connection attempts.
diff --cc core/doc/admin/_sources/enterprise_external_storage/windows-network-drive_configuration.txt
index 1549e28,0000000..9084301
mode 100644,000000..100644
--- a/core/doc/admin/_sources/enterprise_external_storage/windows-network-drive_configuration.txt
+++ b/core/doc/admin/_sources/enterprise_external_storage/windows-network-drive_configuration.txt
@@@ -1,125 -1,0 +1,130 @@@
 +========================================================
 +Installing and Configuring the Windows Network Drive App
 +========================================================
 +
 +The Windows Network Drive app creates a control panel on your Admin page for 
- seamless mounting of SMB/CIFS file shares on ownCloud servers that run on Linux. 
- It does not work on Windows IIS or Windows Apache setups, but only Linux 
- servers, because it requires the Samba client. (Samba is the free software 
- implementation of the SMB/CIFS networking protocol.)
++seamless mounting of SMB/CIFS file shares on ownCloud servers.
 +
 +Any Windows file share, and Samba servers on Linux and other Unix-type operating 
 +systems use the SMB/CIFS file-sharing protocol. The files and directories on the 
 +SMB/CIFS server will be visible on your Files page just like your other ownCloud 
 +files and folders. They are labeled with a little four-pane Windows-style icon, 
 +and the left pane of your Files page includes a Windows Network Drive filter. 
 +Figure 1 shows a new Windows Network Drive share marked with red warnings. 
 +This indicates that ownCloud cannot connect to the share because it is not 
 +available, or there is an error in the configuration. 
 +
 +.. figure:: images/wnd-1.png
 +   :alt: Windows Network Drive share on your Files page.
 +   
 +   *Figure 1: Windows Network Drive share on your Files page.*
 +
 +Files are synchronized bi-directionally, and you can create, upload, and delete 
 +files and folders. ownCloud server admins can create Windows Network Drive 
 +mounts, and optionally allow users to create their own personal Windows Network 
 +Drive mounts. The password for each mount is encrypted and stored in the 
 +ownCloud database, using a long random secret key stored in ``config.php``. This 
 +allows ownCloud to access the shares when the users who own the mounts are not 
 +logged in.
 +
 +Installation
 +------------
 +
 +Enable the Windows Network Drive app on your ownCloud Apps page. Then there are 
 +a few dependencies to install.
 +
 +You must install the ownCloud ``php5-libsmbclient`` binary; please refer to the README in 
 +your `customer.owncloud.com <https://customer.owncloud.com/>`_ account for instructions 
 +on obtaining it.
 +
 +You also need the Samba client installed on your Linux system. This is included in 
 +all Linux distributions; on Debian, Ubuntu, and other Debian derivatives this 
 +is ``smbclient``. On SUSE, Red Hat, CentOS, and other Red Hat derivatives it is 
 +``samba-client``.
 +
 +Additional Installation Steps
 +-----------------------------
 +
 +If your Linux distribution ships with ``libsmbclient 3.x``, which is included in the Samba 
 +client, you may need to set up the HOME variable in Apache to prevent a segmentation 
 +fault. If you have ``libsmbclient 4.1.6`` and higher it doesn't seem to be an issue, so 
 +you won't have to change your HOME variable.
 +
 +To set up the HOME variable on Ubuntu, modify the ``/etc/apache2/envvars`` 
 +file::
 +
 +  unset HOME
 +  export HOME=/var/www
 +
 +In Red Hat/CentOS, modify the ``/etc/sysconfig/httpd`` file and add the 
 +following line to set the HOME variable in Apache::
 +
 +  export HOME=/usr/share/httpd
 + 
 +By default CentOS has activated SELinux, and the ``httpd`` process can not make 
 +outgoing network connections. This will cause problems with the ``curl``, ``ldap`` 
 +and ``samba`` libraries. You'll need to get around this in order to make 
 +this work. First check the status::
 +
 +  getsebool -a | grep httpd
 +  httpd_can_network_connect --> off
 +
 +Then enable support for network connections::
 +
 +  setsebool -P httpd_can_network_connect 1
 +
 +In openSUSE, modify the ``/usr/sbin/start_apache2`` file::
 + 
 +  export HOME=/var/lib/apache2
 +
 +Restart Apache, open your ownCloud Admin page and start creating SMB/CIFS mounts.
 +
 +Creating a New Share
 +--------------------
 +
 +When you create a new SMB share you need the login credentials for the share, 
 +the server address, the share name, and the folder you want to connect to. 
 +
 +1. First enter the ownCloud mountpoint for your new SMB share. This must not be 
 +   an existing folder.
 +2. Then enter which ownCloud users or groups get access to the share. The 
 +   default is all users.
 +3. Next, enter the address of the server that contains the SMB share.
 +4. Then the Windows share name.
- 5. Then the root folder of the share.
++5. Then the root folder of the share. This is the folder name, or the ``$user`` variable for user's home directories.
 +6. Then your login credentials.
 +
++.. figure:: images/wnd-3.jpg
++   :alt: $user variable in the folder field.
++
++   *Figure 2: $user variable to automatically set user's home directories.*
++   
 +You have four options for login credentials: 
 +
 +* **User credentials**.
 +* **Global credentials**, which uses the credentials  set in the Global 
 +  credentials fields
 +* **Login credentials** is for users to connect to the mountpoint using their 
 +  DOMAIN/logincredentials; enter the domain in the **Domain** field.
 +* **Custom Credentials** 
 +  
 +.. figure:: images/wnd-2.png
 +   :scale: 45%
 +   :alt: Windows Network Drive configuration panel.
 +   
-    *Figure 2: Windows Network Drive configuration panel. (Click to enlarge.)*
-   
- When you're finished click the **Save** button.  
++   *Figure 3: Windows Network Drive configuration panel. (Click to enlarge.)*
++
++When you're finished click the **Save** button.
++
++.. note:: When you create a new mountpoint using Login credentials you must log out of ownCloud,     
++   and then log back in so you can access the share. You only have to do this the first time.
 +
 +Personal SMB Mounts
 +-------------------
 +
 +Users create their own personal SMB mounts on their Personal pages. These are 
 +created the same way as Admin-created shares. Users have only two options for 
 +login credentials: 
 +
 +* **Personal Credentials**.
 +* **Custom Credentials**
diff --cc core/doc/admin/_sources/installation/source_installation.txt
index 25fdec0,0000000..daa7317
mode 100644,000000..100644
--- a/core/doc/admin/_sources/installation/source_installation.txt
+++ b/core/doc/admin/_sources/installation/source_installation.txt
@@@ -1,419 -1,0 +1,428 @@@
 +============================
 +Manual Installation on Linux
 +============================
 +
 +Installing ownCloud on Linux from our Open Build Service packages is the 
 +preferred method (see :doc:`linux_installation`). These are maintained by 
 +ownCloud engineers, and you can use your package manager to keep your ownCloud 
 +server up-to-date.
 +
 +.. note:: Enterprise Subscription customers should refer to  
 +   :doc:`../enterprise_installation/linux_installation`
 +
 +If there are no packages for your Linux distribution, or you prefer installing 
 +from the source tarball, you can setup ownCloud from scratch using a classic 
 +LAMP stack (Linux, Apache, MySQL/MariaDB, PHP). This document provides a 
 +complete walk-through for installing ownCloud on Ubuntu 14.04 LTS Server with 
 +Apache and MariaDB, using `the ownCloud .tar archive 
 +<https://owncloud.org/install/>`_.
 +
 +* :ref:`prerequisites_label`
 +* :ref:`ubuntu_installation_label`
 +* :ref:`apache_configuration_label`
 +* :ref:`enabling_ssl_label`
 +* :ref:`installation_wizard_label`
 +* :ref:`strong_permissions_label`
 +* :ref:`selinux_tips_label`
 +* :ref:`php_ini_tips_label`
 +* :ref:`php_fpm_tips_label`
 +* :ref:`other_HTTP_servers_label`
 +
 +.. note:: Admins of SELinux-enabled distributions such as CentOS, Fedora, and 
 +   Red Hat Enterprise Linux may need to set new rules to enable installing 
 +   ownCloud. See :ref:`selinux_tips_label` for a suggested configuration.
 +
 +.. _prerequisites_label:
 +
 +Prerequisites
 +-------------
 +
 +The ownCloud .tar archive contains all of the required PHP modules. This section 
 +lists all required and optional PHP modules.  Consult the `PHP manual 
 +<http://php.net/manual/en/extensions.php>`_ for more information on modules. 
 +Your Linux distribution should have packages for all required modules.
 +
 +Required:
 +
 +* php5 (>= 5.5)
 +* PHP module ctype
 +* PHP module dom
 +* PHP module GD
 +* PHP module iconv
 +* PHP module JSON
 +* PHP module libxml
 +* PHP module mb multibyte
 +* PHP module posix
 +* PHP module SimpleXML
 +* PHP module XMLWriter
 +* PHP module zip
 +* PHP module zlib
 +
 +Database connectors (pick the one for your database:)
 +
 +* PHP module sqlite (>= 3, usually not recommended for performance reasons)
 +* PHP module pdo_mysql (MySQL/MariaDB)
 +* PHP module pgsql (requires PostgreSQL >= 9.0)
 +
 +*Recommended* packages:
 +
 +* PHP module curl (highly recommended, some functionality, e.g. HTTP user
 +  authentication, depends on this)
 +* PHP module fileinfo (highly recommended, enhances file analysis performance)
 +* PHP module bz2 (recommended, required for extraction of apps)
 +* PHP module intl (increases language translation performance and fixes sorting 
 +  of non-ASCII characters)
 +* PHP module mcrypt (increases file encryption performance)
 +* PHP module openssl (required for accessing HTTPS resources)
 +
 +Required for specific apps:
 +
 +* PHP module ldap (for LDAP integration)
 +* `php5-libsmbclient 
 +  <https://software.opensuse.org/download.html?project=isv%3AownCloud%3
 +  Acommunity%3A8.1&package=php5-libsmbclient>`_ (SMB/CIFS integration) 
 +* PHP module ftp (for FTP storage / external user authentication)
 +* PHP module imap (for external user authentication)
 +
 +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 one of the following 
 +memcaches:
 +
 +* PHP module apc
 +* PHP module apcu
 +* PHP module memcached
 +* PHP module redis (required for Transactional File Locking)
 +
 +See :doc:`../configuration_server/caching_configuration` to learn how to select 
 +and configure a memcache.
 +
 +For preview generation (*optional*):
 +
 +* PHP module imagick
 +* avconv or ffmpeg
 +* OpenOffice or LibreOffice
 +
 +You don’t need the WebDAV module for your Web server (i.e. Apache’s 
 +``mod_webdav``), as ownCloud has a built-in WebDAV server of its own, SabreDAV. 
 +If ``mod_webdav`` is enabled you must disable it for ownCloud. (See 
 +:ref:`apache_configuration_label` for an example configuration.)
 +  
 +.. _ubuntu_installation_label:  
 +
 +Example Installation on Ubuntu 14.04 LTS Server
 +-----------------------------------------------
 +
 +On a machine running a pristine Ubuntu 14.04 LTS server, install the
 +required and recommended modules for a typical ownCloud installation, using
 +Apache and MariaDB, by issuing the following commands in a terminal::
 +
 +    apt-get install apache2 mariadb-server libapache2-mod-php5
 +    apt-get install php5-gd php5-json php5-mysql php5-curl
 +    apt-get install php5-intl php5-mcrypt php5-imagick
 +
 +* This installs the packages for the ownCloud core system. If you are planning 
 +  on running additional apps, keep in mind that they might require additional 
 +  packages.  See :ref:`prerequisites_label` for details.
 +
 +* At the installation of the MySQL/MariaDB server, you will be prompted to 
-   create a root password. Be sure to remember the password you enter there 
-   for later use as you will need it during ownCloud database setup.
++  create a root password. Be sure to remember your password as you will need it 
++  during ownCloud database setup.
 +
 +Now download the archive of the latest ownCloud version:
 +
 +* Go to the `ownCloud Download Page <http://owncloud.org/install>`_.
 +* Go to **Download ownCloud Server > Download > Archive file for 
 +  server owners** and download either the tar.bz2 or .zip archive.
 +* This downloads a file named owncloud-x.y.z.tar.bz2 or owncloud-x.y.z.zip 
 +  (where x.y.z is the version number).
 +* Download its corresponding checksum file, e.g. owncloud-x.y.z.tar.bz2.md5, 
 +  or owncloud-x.y.z.tar.bz2.sha256. 
 +* Verify the MD5 or SHA256 sum::
 +   
 +    md5sum -c owncloud-x.y.z.tar.bz2.md5 < owncloud-x.y.z.tar.bz2
 +    sha256sum -c owncloud-x.y.z.tar.bz2.sha256 < owncloud-x.y.z.tar.bz2
 +    md5sum  -c owncloud-x.y.z.zip.md5 < owncloud-x.y.z.zip
 +    sha256sum  -c owncloud-x.y.z.zip.sha256 < owncloud-x.y.z.zip
 +    
 +* You may also verify the PGP signature::
 +    
 +    wget https://download.owncloud.org/community/owncloud-x.y.z.tar.bz2.asc
 +    wget https://www.owncloud.org/owncloud.asc
 +    gpg --import owncloud.asc
 +    gpg --verify owncloud-x.y.z.tar.bz2.asc owncloud-x.y.z.tar.bz2
 +  
 +* Now you can extract the archive contents. Run the appropriate unpacking 
 +  command for your archive type::
 +
 +    tar -xjf owncloud-x.y.z.tar.bz2
 +    unzip owncloud-x.y.z.zip
 +
 +* This unpacks to a single ``owncloud`` directory. Copy the ownCloud directory 
-   to its final destination in the document root of your web server::
++  to its final destination. When you are running the Apache HTTP server you may 
++  safely install ownCloud in your Apache document root::
 +
 +    cp -r owncloud /path/to/webserver/document-root
 +
 +  where ``/path/to/webserver/document-root`` is replaced by the 
 +  document root of your Web server. On Ubuntu systems this 
-   ``/var/www/owncloud``, so your copying command is::
++  ``/var/www/html/owncloud``, so your copying command is::
 +    
-     cp -r owncloud /var/www
++    cp -r owncloud /var/www/html
++
++On other HTTP servers it is recommended to install ownCloud outside of the 
++document root. 
 +    
 + .. _apache_configuration_label:   
 +    
 +Apache Web Server Configuration
 +-------------------------------
 +
 +On Debian, Ubuntu, and their derivatives, Apache installs with a useful 
 +configuration so all you have to do is create a 
 +:file:`/etc/apache2/sites-available/owncloud.conf` file with these lines in 
- it:
++it, replacing the **Directory** and other filepaths with your own filepaths:
 +
 +.. code-block:: xml
 +   
-  Alias /owncloud /var/www/owncloud
-   <Directory /var/www/owncloud/>
++  <Directory /var/www/html/owncloud/>
 +    Options +FollowSymlinks
 +    AllowOverride All
 +
 +   <IfModule mod_dav.c>
 +    Dav off
 +   </IfModule>
 +
-    SetEnv HOME /var/www/owncloud
-    SetEnv HTTP_HOME /var/www/owncloud
++   SetEnv HOME /var/www/html/owncloud
++   SetEnv HTTP_HOME /var/www/html/owncloud
++
++  </Directory>
++  
++If you install ownCloud outside of Apache's DocumentRoot, then you must add an 
++**Alias** directive at the top of the file. In this example ownCloud is installed in
++``/var/www/owncloud``::
 +
-   </Directory>   
++ Alias /owncloud "/var/www/owncloud/"
 +
 +Then create a symlink to :file:`/etc/apache2/sites-enabled`::
 +
 +  ln -s /etc/apache2/sites-available/owncloud.conf /etc/apache2/sites-enabled/owncloud.conf
 +  
 +Additional Apache Configurations
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +* For ownCloud to work correctly, we need the module ``mod_rewrite``. Enable it 
 +  by running::
 +
 +    a2enmod rewrite
 +  
 +  Additional recommended modules are ``mod_headers``, ``mod_env``, ``mod_dir`` and ``mod_mime``::
 +  
 +    a2enmod headers
 +    a2enmod env
 +    a2enmod dir
 +    a2enmod mime
 +  
 +  If you're running ``mod_fcgi`` instead of the standard ``mod_php`` also enable::
 +  
 +    a2enmod setenvif
 +
 +* You must disable any server-configured authentication for ownCloud, as it 
 +  uses Basic authentication internally for DAV services. If you have turned on 
 +  authentication on a parent folder (via e.g. an ``AuthType Basic``
 +  directive), you can turn off the authentication specifically for the ownCloud 
 +  entry. Following the above example configuration file, add the following line 
 +  in the ``<Directory`` section::
 +
 +    Satisfy Any
 +
 +* When using SSL, take special note of the ServerName. You should specify one in 
 +  the  server configuration, as well as in the CommonName field of the 
 +  certificate. If you want your ownCloud to be reachable via the internet, then 
 +  set both of these to the domain you want to reach your ownCloud server.
 +
 +* Now restart Apache::
 +
 +     service apache2 restart
 +
 +* If you're running ownCloud in a subdirectory and want to use CalDAV or 
 +  CardDAV clients make sure you have configured the correct 
 +  :ref:`service-discovery-label` URLs.
 +
 +.. _enabling_ssl_label:
 +
 +Enabling SSL
 +------------
 +
 +.. note:: You can use ownCloud over plain HTTP, but we strongly encourage you to
 +          use SSL/TLS to encrypt all of your server traffic, and to protect 
 +          user's logins and data in transit.
 +
 +Apache installed under Ubuntu comes already set-up with a simple
 +self-signed certificate. All you have to do is to enable the ssl module and
 +the default site. Open a terminal and run::
 +
 +     a2enmod ssl
 +     a2ensite default-ssl
 +     service apache2 reload
 +
 +.. note:: Self-signed certificates have their drawbacks - especially when you
 +          plan to make your ownCloud server publicly accessible. You might want
 +          to consider getting a certificate signed by a commercial signing
 +          authority. Check with your domain name registrar or hosting service 
 +          for good deals on commercial certificates.    
 +    
 +.. _installation_wizard_label:
 +    
 +Installation Wizard
 +-------------------
 +
 +After restarting Apache you must complete your installation by 
 +running either the graphical Installation Wizard, or on the command line with 
 +the ``occ`` command. To enable this, temporarily change the ownership on your 
 +ownCloud directories to your HTTP user (see :ref:`strong_perms_label` to learn 
 +how to find your HTTP user)::
 +
-  chown -R www-data:www-data /var/www/owncloud/
++ chown -R www-data:www-data /var/www/html/owncloud/
 + 
 +.. note:: Admins of SELinux-enabled distributions may need to write new SELinux 
 +   rules to complete their ownCloud installation; see 
 +   :ref:`selinux_tips_label`. 
 +
 +To use ``occ`` see :doc:`command_line_installation`. 
 +
 +To use the graphical Installation Wizard see :doc:`installation_wizard`.
 +
 +After your installation is complete and you can log into ownCloud, you must 
 +apply strong permissions to your ownCloud directory.
 +
 +.. _strong_permissions_label:
 +
 +Setting Strong Directory Permissions
 +------------------------------------
 +
 +After completing installation, you must immediately set the directory 
 +permissions in your ownCloud installation as strictly as possible for stronger 
 +security. Please refer to :ref:`strong_perms_label`.
 +
 +.. _selinux_tips_label:
 +
 +SELinux Configuration Tips
 +--------------------------
 +
 +See :doc:`selinux_configuration` for a suggested configuration for 
 +SELinux-enabled distributions such as Fedora and CentOS.
 +
 +.. _php_ini_tips_label:
 +
 +php.ini Configuration Notes
 +---------------------------
 +
 +Keep in mind that changes to ``php.ini`` may have to be done on more than one 
 +ini file. This can be the case, for example, for the ``date.timezone`` setting.
 +
 +**php.ini - used by the webserver:**
 +::
 +
 +   /etc/php5/apache2/php.ini
 + or
 +   /etc/php5/fpm/php.ini
 + or ...
 +
 +**php.ini - used by the php-cli and so by ownCloud CRON jobs:**
 +::
 +
 +  /etc/php5/cli/php.ini
 +
 +
 +.. _php_fpm_tips_label:
 +
 +php-fpm Configuration Notes
 +---------------------------
 +
 +**Security: Use at least PHP => 5.5.22 or >= 5.6.6**
 +
 +Due to `a bug with security implications <https://bugs.php.net/bug.php?id=64938>`_ 
 +in older PHP releases with the handling of XML data you are highly encouraged to run
 +at least PHP 5.5.22 or 5.6.6 when in a threaded environment.
 +
 +**System environment variables**
 +
 +When you are using ``php-fpm``, system environment variables like 
 +PATH, TMP or others are not automatically populated in the same way as 
 +when using ``php-cli``. A PHP call like ``getenv('PATH');`` can therefore 
 +return an empty result. So you may need to manually configure environment 
 +varibles in the appropropriate ``php-fpm`` ini/config file. 
 +
 +Here are some example root paths for these ini/config files:
 +
 ++--------------------+-----------------------+
 +| Ubuntu/Mint        | CentOS/Red Hat/Fedora |
 ++--------------------+-----------------------+ 
 +| ``/etc/php5/fpm/`` | ``/etc/php-fpm.d/``   |
 ++--------------------+-----------------------+ 
 +
 +In both examples, the ini/config file is called ``www.conf``, and depending on 
 +the distro version or customizations you have made, it may be in a subdirectory.
 +
 +Usually, you will find some or all of the environment variables 
 +already in the file, but commented out like this::
 +
 +	;env[HOSTNAME] = $HOSTNAME
 +	;env[PATH] = /usr/local/bin:/usr/bin:/bin
 +	;env[TMP] = /tmp
 +	;env[TMPDIR] = /tmp
 +	;env[TEMP] = /tmp
 +
 +Uncomment the appropriate existing entries. Then run ``printenv PATH`` to 
 +confirm your paths, for example::
 +
 +        $ printenv PATH
 +        /home/user/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:
 +        /sbin:/bin:/
 +
 +If any of your system environment variables are not present in the file then 
 +you must add them.
 +
 +When you are using shared hosting or a control panel to manage your ownCloud VM 
 +or server, the configuration files are almost certain to be located somewhere 
 +else, for security and flexibility reasons, so check your documentation for the 
 +correct locations.
 +
 +Please keep in mind that it is possible to create different settings for 
 +``php-cli`` and ``php-fpm``, and for different domains and Web sites. 
 +The best way to check your settings is with :ref:`label-phpinfo`.
 +
 +**Maximum upload size**
 +
 +If you want to increase the maximum upload size, you will also have to modify 
 +your ``php-fpm`` configuration and increase the ``upload_max_filesize`` and 
 +``post_max_size`` values. You will need to restart ``php5-fpm`` and your HTTP 
 +server in order for these changes to be applied.
 +
 +**.htaccess notes for webservers \<> Apache**
 +
 +ownCloud comes with its own ``owncloud/.htaccess`` file. ``php-fpm`` can't 
 +read PHP settings in ``.htaccess`` unless the ``htscanner`` PECL extension is 
 +installed. If ``php-fpm`` is used without this PECL extension installed, 
 +settings and permissions must be set in the ``owncloud/.user.ini`` file.
 +
 +.. _other_HTTP_servers_label:
 +
 +Other Web Servers
 +-----------------
 +
 +**Nginx Configuration**
 +
 +See :doc:`nginx_configuration`
 +
 +**Yaws Configuration**
 +
 +See :doc:`yaws_configuration`
 +
 +**Hiawatha Configuration**
 +
 +See :doc:`hiawatha_configuration`
diff --cc core/doc/admin/_sources/release_notes.txt
index 0dd2c0c,0000000..d79c4a8
mode 100644,000000..100644
--- a/core/doc/admin/_sources/release_notes.txt
+++ b/core/doc/admin/_sources/release_notes.txt
@@@ -1,431 -1,0 +1,433 @@@
 +================================
 +ownCloud |version| Release Notes
 +================================
 +
 +Changes in 8.2
 +--------------
 +
++Home folder rule is enforced in the user_ldap application in new ownCloud installations; see :doc:`configuration_user/user_auth_ldap`. This affects ownCloud 8.0.10, 8.1.5 and 8.2.0 and up.
++
 +New location for Linux package repositories; ownCloud admins must manually 
 +change to the new repos. See :doc:`maintenance/upgrade`
 +
 +PHP 5.6.11+ breaks the LDAP wizard with a 'Could not connect to LDAP' error. See https://github.com/owncloud/core/issues/20020. 
 +
 +``filesystem_check_changes`` in ``config.php`` is set to 0 by default. This 
 +prevents unnecessary update checks and improves performance. If you are using 
 +external storage mounts such as NFS on a remote storage server, set this to 1 
 +so that ownCloud will detect remote file changes.
 +
 +XSendFile support has been removed, so there is no longer support for `serving 
 +static files
 +<https://doc.owncloud.org/server/8.1/admin_manual/configuration_files/
 +serving_static_files_configuration.html>`_ from your ownCloud server.
 +
 +LDAP issue: 8.2 uses the ``memberof`` attribute by default. If this is not 
 +activated on your LDAP server your user groups will not be detected, and you 
 +will see this message in your ownCloud log: ``Error PHP Array to string 
 +conversion at /var/www/html/owncloud/lib/private/template/functions.php#36``. 
 +Fix this by disabling the ``memberof`` attribute on your ownCloud server with 
 +the ``occ`` command, like this example on Ubuntu Linux::
 +
 + sudo -u www-data php occ ldap:set-config "s01" useMemberOfToDetectMembership 0
 + 
 +Run ``sudo -u www-data php occ ldap:show-config`` to find the correct ``sNN`` 
 +value; if there is not one then use empty quotes, ``""``. (See 
 +:doc:`configuration_server/occ_command`.)
 +
 +Users of the Linux Package need to update their repository setup as described
 +in this `blogpost <https://owncloud.org/blog/upgrading-to-owncloud-server-8-2/>`_.
 +
 +The log format for failed logins to the ``owncloud.log`` has a slight syntax change.
 +If a tool relies on logging failed logins please revise its rule. For ``fail2ban``
 +you will find an updated rule at the `forums <https://forum.owncloud.org/viewtopic.
 +php?f=8&t=28678>`_.
 +
 +Changes in 8.1
 +--------------
 +
 +Use APCu only if available in version 4.0.6 and higher. If you install an older version, you will see a ``APCu below version 4.0.6 is installed, for stability and performance reasons we recommend to update to a newer APCu version`` warning on your ownCloud admin page.
 +
 +SMB external storage now based on ``php5-libsmbclient``, which must be downloaded 
 +from the ownCloud software repositories (`installation instructions 
 +<https://software.opensuse.org/download.html?project=isv%3AownCloud%3Acommunity% 
 +3A8.1&package=php5-libsmbclient>`_).
 +  
 +"Download from link" feature has been removed.
 +
 +The ``.htaccess`` and ``index.html`` files in the ``data/`` directory are now 
 +updated after every update. If you make any modifications to these files they 
 +will be lost after updates.
 +
 +The SabreDAV browser at ``/remote.php/webdav`` has been removed.
 +
 +Using ownCloud without a ``trusted_domain`` configuration will not work anymore.
 +
 +The logging format for failed logins has changed and considers now the proxy 
 +configuration in ``config.php``.
 +
 +A default set of security and privacy HTTP headers have been added to the 
 +ownCloud ``.htaccess`` file, and ownCloud administrators may now customize which 
 +headers are sent.
 +
 +More strict SSL certificate checking improves security but can result in
 +"cURL error 60: SSL certificate problem: unable to get local issuer certificate"
 +errors with certain broken PHP versions. Please verify your SSL setup, update your
 +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 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.
 +
 +ownCloud ships now with its own root certificate bundle derived from Mozilla's 
 +root certificates file. The system root certificate bundle will not be used 
 +anymore for most requests.
 +  
 +When you upgrade from ownCloud 8.0, with encryption enabled, to 8.1, you must 
 +enable the new encryption backend and migrate your encryption keys. See 
 +:doc:`configuration_files/encryption_configuration`
 +
 +Encryption can no longer be disabled in ownCloud 8.1. It is planned to re-add
 +this feature to the command line client for a future release.
 +
 +It is not recommended to upgrade encryption-enabled systems from ownCloud Server 8.0
 +to version 8.1.0 as there is a chance the migration will break. We recommend 
 +migrating to the first bugfix release, ownCloud Server 8.1.1.
 +
 +Due to various technical issues, by default desktop sync clients older than 
 +1.7 are not allowed to connect and sync with the ownCloud server. This is 
 +configurable via the ``minimum.supported.desktop.version`` switch in 
 +``config.php``.
 +
 +Previews are now generated at a maximum size of 2048 x 2048 pixels. This is configurable
 +via the ``preview_max_x`` and ``preview_max_y`` switches in ``config.php``.
 +
 +The ownCloud 8 server is not supported on any version of Windows.
 +
 +The 8.1.0 release has a minor bug which makes app updates fail at first try. Reload the
 +apps page and try again, and the update will succeed.
 +
 +The ``forcessl`` option within the ``config.php`` and the ``Enforce SSL`` option 
 +within the Admin-Backend was removed. This now needs to be configured like 
 +described in :ref:`use_https_label`.
 +
 +WebDAV file locking was removed in oC 8.1 which causes Finder on Mac OS X to mount WebDAV read-only.
 +
 +Enterprise 8.1 Only
 +-------------------
 +
 +The SharePoint Drive app does not verify the SSL certificate of the SharePoint 
 +server or the ownCloud server, as it is expected that both devices are in the 
 +same trusted environment.
 +
 +ownCloud 8.0
 +------------
 +
 +Manual LDAP Port Configuration
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +When you are configuring the LDAP user and group backend application, ownCloud 
 +may not auto-detect the LDAP server's port number, so you will need to enter it 
 +manually.
 +
 +.. https://github.com/owncloud/core/pull/16748
 +
 +No Preview Icon on Text Files
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +There is no preview icon displayed for text files when the file contains fewer than six characters.
 +
 +.. https://github.com/owncloud/core/issues/16556#event-316503097
 +
 +Remote Federated Cloud Share Cannot be Reshared With Local Users
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +When you mount a Federated Cloud share from a remote ownCloud server, you cannot re-share it with your local ownCloud users. (See :doc:`configuration_files/federated_cloud_sharing_configuration` to learn more about federated cloud sharing)
 +
 +Manually Migrate Encryption Keys after Upgrade
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +If you are using the Encryption app and upgrading from older versions of 
 +ownCloud to ownCloud 8.0, you must manually migrate your encryption keys with 
 +the *occ* command after the upgrade is complete, like this example for CentOS: 
 +*sudo -u apache php occ encryption:migrate* You must run *occ* as your HTTP 
 +user. See :doc:`../configuration_server/occ_command` to learn more about *occ*
 +
 +Windows Server Not Supported
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Windows Server is not supported in ownCloud 8.
 +
 +PHP 5.3 Support Dropped
 +^^^^^^^^^^^^^^^^^^^^^^^
 +
 +PHP 5.3 is not supported in ownCloud 8, and PHP 5.4 or better is required.
 +
 +Disable Apache Multiviews
 +^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +If Multiviews are enabled in your Apache configuration, this may cause problems 
 +with content negotiation, so disable Multiviews by removing it from your Apache 
 +configuration. Look for lines like this:: 
 +
 + <Directory /var/www/owncloud>
 + Options Indexes FollowSymLinks Multiviews
 + 
 +Delete ``Multiviews`` and restart Apache.
 +
 +.. https://github.com/owncloud/core/issues/9039
 +
 +ownCloud Does Not Follow Symlinks
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +ownCloud's file scanner does not follow symlinks, which could lead to 
 +infinite loops. To avoid this do not use soft or hard links in your ownCloud 
 +data directory.
 +
 +.. https://github.com/owncloud/core/issues/8976
 +
 +No Commas in Group Names
 +^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Creating an ownCloud group with a comma in the group name causes ownCloud to 
 +treat the group as two groups.
 +
 +.. https://github.com/owncloud/core/issues/10983
 +
 +Hebrew File Names Too Large on Windows
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +On Windows servers Hebrew file names grow to five times their original size 
 +after being translated to Unicode.
 +
 +.. https://github.com/owncloud/core/issues/8938
 +
 +Google Drive Large Files Fail with 500 Error
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Google Drive tries to download the entire file into memory, then write it to a 
 +temp file, and then stream it to the client, so very large file downloads from 
 +Google Drive may fail with a 500 internal server error.
 +
 +.. https://github.com/owncloud/core/issues/8810
 +
 +Encrypting Large Numbers of Files
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +When you activate the Encryption app on a running server that has large numbers 
 +of files, it is possible that you will experience timeouts. It is best to 
 +activate encryption at installation, before accumulating large numbers of files 
 +on your ownCloud server.
 +
 +.. https://github.com/owncloud/core/issues/10657
 +
 +
 +Enterprise 8.0 Only
 +-------------------
 +
 +Sharepoint Drive SSL Not Verified
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +The SharePoint Drive app does not verify the SSL certificate of the SharePoint 
 +server or the ownCloud server, as it is expected that both devices are in the 
 +same trusted environment.
 +
 +No Federated Cloud Sharing with Shibboleth
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Federated Cloud Sharing (formerly Server-to-Server file sharing)does not work 
 +with Shibboleth .
 +
 +.. https://github.com/owncloud/user_shibboleth/issues/28
 +
 +Direct Uploads to SWIFT do not Appear in ownCloud
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +When files are uploaded directly to a SWIFT share mounted as external storage 
 +in ownCloud, the files do not appear in ownCloud. However, files uploaded to 
 +the SWIFT mount through ownCloud are listed correctly in both locations.
 +
 +.. https://github.com/owncloud/core/issues/8633
 +
 +SWIFT Objectstore Incompatible with Encryption App
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +The current SWIFT implementation is incompatible with any app that uses direct 
 +file I/O and circumvents the ownCloud virtual filesystem. Using the Encryption 
 +app on a SWIFT object store incurs twice as many HTTP requests and increases 
 +latency significantly.
 +
 +.. https://github.com/owncloud/core/issues/10900
 +
 +App Store is Back
 +^^^^^^^^^^^^^^^^^
 +
 +The ownCloud App Store has been re-enabled in oC 8. Note that third-party apps 
 +are not supported.
 +
 +ownCloud 7 Release Notes
 +------------------------
 +
 +Manual LDAP Port Configuration
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +When you are configuring the LDAP user and group backend application, ownCloud 
 +may not auto-detect the LDAP server's port number, so you will need to enter it 
 +manually.
 +
 +.. https://github.com/owncloud/core/pull/16748
 +
 +LDAP Search Performance Improved
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Prior to 7.0.4, LDAP searches were substring-based and would match search 
 +attributes if the substring occurred anywhere in the attribute value. Rather, 
 +searches are performed on beginning attributes. With 7.0.4, searches will match 
 +at the beginning of the attribute value only. This provides better performance 
 +and a better user experience.
 +
 +Substring searches can still be performed by prepending the search term with 
 +"*".For example, a search for ``te`` will find Terri, but not Nate::
 + 
 + occ ldap:search "te"
 +
 +If you want to broaden the search to include 
 +Nate, then search for ``*te``::
 +
 + occ ldap:search "*te"
 +
 +Refine searches by adjusting your search attributes in the ``User Search 
 +Attributes`` form in your LDAP configuration on the Admin page. For example, if 
 +your search attributes are ``givenName`` and ``sn`` you can find users by first 
 +name + last name very quickly. For example, you'll find Terri Hanson by 
 +searching for ``te ha``. Trailing whitespaces are ignored.
 +
 +.. https://github.com/owncloud/core/issues/12647
 +
 +Protecting ownCloud on IIS from Data Loss
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Under certain circumstances, running your ownCloud server on IIS could be at 
 +risk of data loss. To prevent this, follow these steps.
 +
 +In your ownCloud server configuration file, ``owncloud\config\config.php``, set 
 +``config_is_read_only`` to true.
 +    
 +Set the ``config.php`` file to read-only.
 +    
 +When you make server updates ``config.php`` must be made writeable. When your 
 +updates are completed re-set it to read-only.
 +
 +Antivirus App Modes
 +^^^^^^^^^^^^^^^^^^^
 +
 +The Antivirus App offers three modes for running the ClamAV anti-virus scanner: 
 +as a daemon on the ownCloud server, a daemon on a remote server, or an 
 +executable mode that calls ``clamscan`` on the local server. We recommend using 
 +one of the daemon modes, as they are the most reliable.
 +
 +"Enable Only for Specific Groups" Fails
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Some ownCloud applications have the option to be enabled only for certain 
 +groups. However, when you select specific groups they do not get access to the 
 +app.
 +
 +Changes to File Previews
 +^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +For security and performance reasons, file previews are available only for 
 +image files, covers of MP3 files, and text files, and have been disabled for 
 +all other filetypes. Files without previews are represented by generic icons 
 +according to their file types. 
 +
 +4GB Limit on SFTP Transfers
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Because of limitations in ``phpseclib``, you cannot upload files larger than 
 +4GB over SFTP.
 +
 +"Not Enough Space Available" on File Upload
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Setting user quotas to ``unlimited`` on an ownCloud installation that has 
 +unreliable free disk space reporting-- for example, on a shared hosting 
 +provider-- may cause file uploads to fail with a "Not Enough Space Available" 
 +error. A workaround is to set file quotas for all users instead of 
 +``unlimited``.
 +
 +No More Expiration Date On Local Shares
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +In older versions of ownCloud, you could set an expiration date on both local 
 +and public shares. Now you can set an expiration date only on public shares, 
 +and 
 +local shares do not expire when public shares expire.
 +
 +Zero Quota Not Read-Only
 +^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Setting a user's storage quota should be the equivalent of read-only, however, 
 +users can 
 +still create empty files.
 +
 +Enterprise 7 Only
 +-----------------
 +
 +No Federated Cloud Sharing with Shibboleth
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +Federated Cloud Sharing (formerly Server-to-Server file sharing) does not work 
 +with Shibboleth .
 +
 +Windows Network Drive
 +^^^^^^^^^^^^^^^^^^^^^
 +Windows Network Drive runs only on Linux servers because it requires the Samba 
 +client, which is included in all Linux distributions. 
 +
 +``php5-libsmbclient`` is also required, and there may be issues with older 
 +versions of ``libsmbclient``; see Using External Storage > Installing and 
 +Configuring the Windows Network Drive App in the Enterprise Admin manual for 
 +more information. 
 +
 +By default CentOS has activated SELinux, and the ``httpd`` process can not make 
 +outgoing network connections. This will cause problems with curl, ldap and samba 
 +libraries. Again, see Using External Storage > Installing and Configuring the 
 +Windows Network Drive App in the Enterprise Admin manual for instructions.
 +
 +Sharepoint Drive SSL
 +^^^^^^^^^^^^^^^^^^^^
 +
 +The SharePoint Drive app does not verify the SSL certificate of the SharePoint 
 +server or the ownCloud server, as it is expected that both devices are in the 
 +same trusted environment.
 +
 +Shibboleth and WebDAV Incompatible
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +Shibboleth and standard WebDAV are incompatible, and cannot be used together in 
 +ownCloud. If Shibboleth is enabled, the ownCloud client uses an extended WebDAV 
 +protocol
 +
 +No SQLite
 +^^^^^^^^^
 +
 +SQLite is no longer an installation option for ownCloud Enterprise Edition, as 
 +it not suitable for multiple-user installations or managing large numbers of 
 +files.
 +
 +No App Store
 +^^^^^^^^^^^^
 +
 +The App Store is disabled for the Enterprise Edition.
 +
 +LDAP Home Connector Linux Only
 +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 +
 +The LDAP Home Connector application requires Linux (with MySQL, MariaDB, 
 +or PostgreSQL) to operate correctly.
diff --cc core/doc/admin/configuration_files/files_locking_transactional.html
index 7b2880d,0000000..d07e93a
mode 100644,000000..100644
--- a/core/doc/admin/configuration_files/files_locking_transactional.html
+++ b/core/doc/admin/configuration_files/files_locking_transactional.html
@@@ -1,240 -1,0 +1,240 @@@
 +
 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 +  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 +
 +
 +<html xmlns="http://www.w3.org/1999/xhtml">
 +  <head>
 +    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 +    
 +    <title>Transactional File Locking — ownCloud 8.2 Server Administration Manual 8.2 documentation</title>
 +    
 +    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
 +    
 +    <script type="text/javascript">
 +      var DOCUMENTATION_OPTIONS = {
 +        URL_ROOT:    '../',
 +        VERSION:     '8.2',
 +        COLLAPSE_INDEX: false,
 +        FILE_SUFFIX: '.html',
 +        HAS_SOURCE:  true
 +      };
 +    </script>
 +    <script type="text/javascript" src="../_static/jquery.js"></script>
 +    <script type="text/javascript" src="../_static/underscore.js"></script>
 +    <script type="text/javascript" src="../_static/doctools.js"></script>
 +    <script type="text/javascript" src="../_static/bootstrap.js"></script>
 +    <link rel="top" title="ownCloud 8.2 Server Administration Manual 8.2 documentation" href="../index.html" />
 +    <link rel="up" title="File Sharing and Management" href="index.html" />
 +    <link rel="next" title="Previews Configuration" href="previews_configuration.html" />
 +    <link rel="prev" title="Encryption Configuration" href="encryption_configuration.html" />
 +<script type="text/javascript">
 +(function () {
 +  /**
 +   * Patch TOC list.
 +   *
 +   * Will mutate the underlying span to have a correct ul for nav.
 +   *
 +   * @param $span: Span containing nested UL's to mutate.
 +   * @param minLevel: Starting level for nested lists. (1: global, 2: local).
 +   */
 +  var patchToc = function ($ul, minLevel) {
 +    var findA;
 +
 +    // Find all a "internal" tags, traversing recursively.
 +    findA = function ($elem, level) {
 +      var level = level || 0,
 +        $items = $elem.find("> li > a.internal, > ul, > li > ul");
 +
 +      // Iterate everything in order.
 +      $items.each(function (index, item) {
 +        var $item = $(item),
 +          tag = item.tagName.toLowerCase(),
 +          pad = 15 + ((level - minLevel) * 10);
 +
 +        if (tag === 'a' && level >= minLevel) {
 +          // Add to existing padding.
 +          $item.css('padding-left', pad + "px");
 +          console.log(level, $item, 'padding-left', pad + "px");
 +        } else if (tag === 'ul') {
 +          // Recurse.
 +          findA($item, level + 1);
 +        }
 +      });
 +    };
 +
 +    console.log("HERE");
 +    findA($ul);
 +  };
 +
 +  $(document).ready(function () {
 +    // Add styling, structure to TOC's.
 +    $(".dropdown-menu").each(function () {
 +      $(this).find("ul").each(function (index, item){
 +        var $item = $(item);
 +        $item.addClass('unstyled');
 +      });
 +      $(this).find("li").each(function () {
 +        $(this).parent().append(this);
 +      });
 +    });
 +
 +    // Patch in level.
 +    patchToc($("ul.globaltoc"), 2);
 +    patchToc($("ul.localtoc"), 2);
 +
 +    // Enable dropdown.
 +    $('.dropdown-toggle').dropdown();
 +  });
 +}());
 +</script>
 +
 +  </head>
 +  <body>
 +  
 +
 +<div class="container">
 +  <div class="content">
 +    <div class="page-header">
 +      <h1><a href="../contents.html">ownCloud 8.2 Server Administration Manual</a></h1>
 +
 +    </div>
 +    
 +			<div class="row">
 +				<div class="span3">
 +					<div class="sidebar">
 +						<div class="well">
 +							<div class="menu-support-container">
 +								<ul id="menu-support" class="menu">
 +									<ul>
 +										
 +<li><a href="../contents.html">Table of Contents</a></li>
 +									</ul>
 +                  <ul class="current">
 +<li class="toctree-l1"><a class="reference internal" href="../index.html">ownCloud 8.2 Server Administration Manual Introduction</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">ownCloud 8.2 Release Notes</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../whats_new_admin.html">What’s New for Admins in ownCloud 8.2</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">ownCloud Server Configuration</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_user/index.html">User Management</a></li>
 +<li class="toctree-l1 current"><a class="reference internal" href="index.html">File Sharing and Management</a><ul class="current">
 +<li class="toctree-l2"><a class="reference internal" href="file_sharing_configuration.html">File Sharing</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="federated_cloud_sharing_configuration.html">Configuring Federated Cloud Sharing</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="big_file_upload_configuration.html">Uploading big files > 512MB</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="collaborative_documents_configuration.html">Configuring the Collaborative Documents App</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="default_files_configuration.html">Providing Default Files</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="external_storage_configuration_gui.html">Configuring External Storage (GUI)</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="external_storage_configuration.html">Configuring External Storage (Configuration File)</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="external_storage/auth_mechanisms.html">External Storage Authentication mechanisms</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="encryption_configuration.html">Encryption Configuration</a></li>
 +<li class="toctree-l2 current"><a class="current reference internal" href="">Transactional File Locking</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="previews_configuration.html">Previews Configuration</a></li>
 +</ul>
 +</li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database Configuration</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../operations/index.html">Operations</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../issues/index.html">Issues and Troubleshooting</a></li>
 +</ul>
 +<ul>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_installation/index.html">Enterprise Subscription Installation (ES Only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_clients/index.html">Creating Branded ownCloud Clients (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_server_branding/index.html">Enterprise Server Branding (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_external_storage/index.html">External Storage (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_user_management/index.html">User Management (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_files_drop/index.html">Enabling Anonymous Uploads with Files Drop (ES Only)</a></li>
 +</ul>
 +
 +								</ul>
 +							</div>
 +						</div>
 +					</div>
 +				</div>
 +        
 +
 +				<div class="span9">
 +					<div class="page-content">
 +						
 +  <div class="section" id="transactional-file-locking">
 +<h1>Transactional File Locking<a class="headerlink" href="#transactional-file-locking" title="Permalink to this headline">¶</a></h1>
 +<p>ownCloud’s Transactional File Locking mechanism locks files to avoid
 +file corruption during normal operation. It performs these functions:</p>
 +<ul class="simple">
 +<li>Operates at a higher level than the filesystem, so you don’t need to use a
 +filesystem that supports locking</li>
 +<li>Locks parent directories so they cannot be renamed during any activity on
 +files inside the directories</li>
 +<li>Releases locks after file transactions are interrupted, for
 +example when a sync client loses the connection during an upload</li>
 +<li>Manages locking and releasing locks correctly on shared files during changes
 +from multiple users</li>
 +<li>Manages locks correctly on external storage mounts</li>
 +<li>Manages encrypted files correctly</li>
 +</ul>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">Transactional file locking is in core, and replaces the old File
 +Locking app. The File Locking app has been removed from ownCloud in version
 +8.2.1. If your ownCloud server still has the File Locking app, you must
 +visit your Apps page to verify that it is disabled; the File Locking app and
 +Transactional File Locking cannot both operate at the same time.</p>
 +</div>
 +<p>When you see the warning on your ownCloud admin page “Transactional file locking
 +is using the database as locking backend, for best performance it’s advised to
 +configure a memcache for locking”, you are not required to use a memcache. File
 +locking is enabled by default, using the database locking backend. This
 +places a significant load on your database. Using <tt class="docutils literal"><span class="pre">memcache.locking</span></tt> relieves
 +the database load and improves performance. Admins of ownCloud servers with
 +heavy workloads should install a memcache. (See
 +<a class="reference internal" href="../configuration_server/caching_configuration.html"><em>Configuring Memory Caching</em></a>.)</p>
 +<p>To use a memcache with Transactional File Locking, you must install the Redis
 +server and corresponding PHP module. After installing Redis you must enter a
 +configuration in your <tt class="docutils literal"><span class="pre">config.php</span></tt> file like this example:</p>
 +<div class="highlight-python"><pre>'filelocking.enabled' => 'true',
 +'memcache.locking' => '\OC\Memcache\Redis',
 +'redis' => array(
 +     'host' => 'localhost',
 +     'port' => 6379,
 +     'timeout' => 0.0,
 +     'password' => '', // Optional, if not defined no password will be used.
 +      ),</pre>
 +</div>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">For enhanced security it is recommended to configure Redis to require
 +a password. See <a class="reference external" href="http://redis.io/topics/security">http://redis.io/topics/security</a> for more information.</p>
 +</div>
 +<p>If you want to configure Redis to listen on an Unix socket (which is
 +recommended if Redis is running on the same system as ownCloud) use this example
 +<tt class="docutils literal"><span class="pre">config.php</span></tt> configuration:</p>
 +<div class="highlight-python"><pre>'filelocking.enabled' => 'true',
 +'memcache.locking' => '\OC\Memcache\Redis',
 +'redis' => array(
 +     'host' => '/var/run/redis/redis.sock',
 +     'port' => 0,
 +     'timeout' => 0.0,
 +      ),</pre>
 +</div>
 +<p>See <tt class="docutils literal"><span class="pre">config.sample.php</span></tt> to see configuration examples for Redis, and for all
 +supported memcaches.</p>
- <p>If you are on Ubuntu you can follow <a class="reference external" href="https://www.en0ch.se/how-to-configure-redis-cache-in-ubuntu-14-04-with-owncloud/">this guide</a> for a complete installation from scratch.</p>
++<p>If you are on Ubuntu you can follow <a class="reference external" href="https://www.techandme.se/how-to-configure-redis-cache-in-ubuntu-14-04-with-owncloud/">this guide</a> for a complete installation from scratch.</p>
 +<p>Learn more about Reds at <a class="reference external" href="http://redis.io/">Redis</a>. Memcached, the popular
 +distributed memory caching system, is not suitable for the new file locking
 +because it is not designed to store locks, and data can disappear from the cache
 +at any time. Redis is a key-value store, and it guarantees that cached objects
 +are available for as long as they are needed.</p>
 +</div>
 +
 +
 +					</div>
 +				</div>
 +			</div>
 +    
 +  </div>
 +</div>
 +  </body>
 +</html>
diff --cc core/doc/admin/configuration_server/caching_configuration.html
index 5b3c4b0,0000000..41ed462
mode 100644,000000..100644
--- a/core/doc/admin/configuration_server/caching_configuration.html
+++ b/core/doc/admin/configuration_server/caching_configuration.html
@@@ -1,366 -1,0 +1,366 @@@
 +
 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 +  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 +
 +
 +<html xmlns="http://www.w3.org/1999/xhtml">
 +  <head>
 +    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 +    
 +    <title>Configuring Memory Caching — ownCloud 8.2 Server Administration Manual 8.2 documentation</title>
 +    
 +    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
 +    
 +    <script type="text/javascript">
 +      var DOCUMENTATION_OPTIONS = {
 +        URL_ROOT:    '../',
 +        VERSION:     '8.2',
 +        COLLAPSE_INDEX: false,
 +        FILE_SUFFIX: '.html',
 +        HAS_SOURCE:  true
 +      };
 +    </script>
 +    <script type="text/javascript" src="../_static/jquery.js"></script>
 +    <script type="text/javascript" src="../_static/underscore.js"></script>
 +    <script type="text/javascript" src="../_static/doctools.js"></script>
 +    <script type="text/javascript" src="../_static/bootstrap.js"></script>
 +    <link rel="top" title="ownCloud 8.2 Server Administration Manual 8.2 documentation" href="../index.html" />
 +    <link rel="up" title="ownCloud Server Configuration" href="index.html" />
 +    <link rel="next" title="Defining Background Jobs" href="background_jobs_configuration.html" />
 +    <link rel="prev" title="Configuring the ClamAV Antivirus Scanner" href="antivirus_configuration.html" />
 +<script type="text/javascript">
 +(function () {
 +  /**
 +   * Patch TOC list.
 +   *
 +   * Will mutate the underlying span to have a correct ul for nav.
 +   *
 +   * @param $span: Span containing nested UL's to mutate.
 +   * @param minLevel: Starting level for nested lists. (1: global, 2: local).
 +   */
 +  var patchToc = function ($ul, minLevel) {
 +    var findA;
 +
 +    // Find all a "internal" tags, traversing recursively.
 +    findA = function ($elem, level) {
 +      var level = level || 0,
 +        $items = $elem.find("> li > a.internal, > ul, > li > ul");
 +
 +      // Iterate everything in order.
 +      $items.each(function (index, item) {
 +        var $item = $(item),
 +          tag = item.tagName.toLowerCase(),
 +          pad = 15 + ((level - minLevel) * 10);
 +
 +        if (tag === 'a' && level >= minLevel) {
 +          // Add to existing padding.
 +          $item.css('padding-left', pad + "px");
 +          console.log(level, $item, 'padding-left', pad + "px");
 +        } else if (tag === 'ul') {
 +          // Recurse.
 +          findA($item, level + 1);
 +        }
 +      });
 +    };
 +
 +    console.log("HERE");
 +    findA($ul);
 +  };
 +
 +  $(document).ready(function () {
 +    // Add styling, structure to TOC's.
 +    $(".dropdown-menu").each(function () {
 +      $(this).find("ul").each(function (index, item){
 +        var $item = $(item);
 +        $item.addClass('unstyled');
 +      });
 +      $(this).find("li").each(function () {
 +        $(this).parent().append(this);
 +      });
 +    });
 +
 +    // Patch in level.
 +    patchToc($("ul.globaltoc"), 2);
 +    patchToc($("ul.localtoc"), 2);
 +
 +    // Enable dropdown.
 +    $('.dropdown-toggle').dropdown();
 +  });
 +}());
 +</script>
 +
 +  </head>
 +  <body>
 +  
 +
 +<div class="container">
 +  <div class="content">
 +    <div class="page-header">
 +      <h1><a href="../contents.html">ownCloud 8.2 Server Administration Manual</a></h1>
 +
 +    </div>
 +    
 +			<div class="row">
 +				<div class="span3">
 +					<div class="sidebar">
 +						<div class="well">
 +							<div class="menu-support-container">
 +								<ul id="menu-support" class="menu">
 +									<ul>
 +										
 +<li><a href="../contents.html">Table of Contents</a></li>
 +									</ul>
 +                  <ul class="current">
 +<li class="toctree-l1"><a class="reference internal" href="../index.html">ownCloud 8.2 Server Administration Manual Introduction</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">ownCloud 8.2 Release Notes</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../whats_new_admin.html">What’s New for Admins in ownCloud 8.2</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation</a></li>
 +<li class="toctree-l1 current"><a class="reference internal" href="index.html">ownCloud Server Configuration</a><ul class="current">
 +<li class="toctree-l2"><a class="reference internal" href="security_setup_warnings.html">Warnings on Admin Page</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="occ_command.html">Using the occ Command</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="activity_configuration.html">Configuring the Activity App</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="antivirus_configuration.html">Configuring the ClamAV Antivirus Scanner</a></li>
 +<li class="toctree-l2 current"><a class="current reference internal" href="">Configuring Memory Caching</a><ul>
 +<li class="toctree-l3"><a class="reference internal" href="#id1">APC</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#id2">APCu</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#id3">Memcached</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#id4">Redis</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#cache-directory-location">Cache Directory Location</a></li>
 +</ul>
 +</li>
 +<li class="toctree-l2"><a class="reference internal" href="background_jobs_configuration.html">Defining Background Jobs</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="config_sample_php_parameters.html">Config.php Parameters</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="email_configuration.html">Email Configuration</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="external_sites.html">Linking External Sites</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="custom_client_repos.html">Custom Client Download Repositories</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="knowledgebase_configuration.html">Knowledge Base Configuration</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="language_configuration.html">Language Configuration</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="logging_configuration.html">Logging Configuration</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="harden_server.html">Hardening and Security Guidance</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="reverse_proxy_configuration.html">Reverse Proxy Configuration</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="search_configuration.html">Enabling Full-Text Search</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="thirdparty_php_configuration.html">Using Third Party PHP Components</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="performance_tuning/index.html">Server Tuning & Performance Tips</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="js_css_asset_management_configuration.html">JavaScript and CSS Asset Management</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="automatic_configuration.html">Automatic Configuration Setup</a></li>
 +</ul>
 +</li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_user/index.html">User Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_files/index.html">File Sharing and Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database Configuration</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../operations/index.html">Operations</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../issues/index.html">Issues and Troubleshooting</a></li>
 +</ul>
 +<ul>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_installation/index.html">Enterprise Subscription Installation (ES Only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_clients/index.html">Creating Branded ownCloud Clients (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_server_branding/index.html">Enterprise Server Branding (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_external_storage/index.html">External Storage (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_user_management/index.html">User Management (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_files_drop/index.html">Enabling Anonymous Uploads with Files Drop (ES Only)</a></li>
 +</ul>
 +
 +								</ul>
 +							</div>
 +						</div>
 +					</div>
 +				</div>
 +        
 +
 +				<div class="span9">
 +					<div class="page-content">
 +						
 +  <div class="section" id="configuring-memory-caching">
 +<h1>Configuring Memory Caching<a class="headerlink" href="#configuring-memory-caching" title="Permalink to this headline">¶</a></h1>
 +<p>You can significantly improve your ownCloud server performance with memory
 +caching, where frequently-requested objects are stored in memory for faster
 +retrieval. There are two types of caches to use: a PHP opcode cache, which is
 +commonly called <em>opcache</em>, and data caching for your Web server. If you do not
 +install and enable a local memcache you will see a warning on your ownCloud
 +admin page. A memcache is not required and you may ignore the warning if you
 +prefer.</p>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">If you enable only a distributed cache in
 +your <tt class="docutils literal"><span class="pre">config.php</span></tt> (<tt class="docutils literal"><span class="pre">memcache.distributed</span></tt>) and not a
 +local cache (<tt class="docutils literal"><span class="pre">memcache.local</span></tt>) you will still see the cache warning.</p>
 +</div>
 +<p>A PHP opcache stores compiled PHP scripts so they don’t need to be re-compiled
 +every time they are called. PHP bundles the Zend OPcache in core since version
 +5.5, so you don’t need to install an opcache.</p>
 +<p>If you are using PHP 5.4, which is the oldest supported PHP version for
 +ownCloud, you may install the Alternative PHP Cache (APC). This is both an
 +opcache and data cache. APC has not been updated since 2012 and is essentially
 +dead, and PHP 5.4 is old and lags behind later releases. If it is possible
 +to upgrade to a later PHP release that is the best option.</p>
 +<p>Data caching is supplied by the Alternative PHP Cache, user (APCu) in PHP
 +5.5+, Memcached, or Redis.</p>
 +<p>ownCloud supports multiple memory caching backends, so you can choose the type
 +of memcache that best fits your needs. The supported caching backends are:</p>
 +<ul>
 +<li><dl class="first docutils">
 +<dt><a class="reference external" href="http://php.net/manual/en/book.apc.php">APC</a></dt>
 +<dd><p class="first last">A local cache for systems running PHP 5.4.</p>
 +</dd>
 +</dl>
 +</li>
 +<li><dl class="first docutils">
 +<dt><a class="reference external" href="https://pecl.php.net/package/APCu">APCu</a>, APCu 4.06 and up required.</dt>
 +<dd><p class="first last">A local cache for systems running PHP 5.5 and up.</p>
 +</dd>
 +</dl>
 +</li>
 +<li><dl class="first docutils">
 +<dt><a class="reference external" href="http://www.memcached.org/">Memcached</a></dt>
 +<dd><p class="first last">Distributed cache for multi-server ownCloud installations.</p>
 +</dd>
 +</dl>
 +</li>
 +<li><dl class="first docutils">
 +<dt><a class="reference external" href="http://redis.io/">Redis</a>, PHP module 2.2.5 and up required.</dt>
 +<dd><p class="first last">For distributed caching, and required for Transactional File Locking.</p>
 +</dd>
 +</dl>
 +</li>
 +</ul>
 +<p>These are supported but not recommended:</p>
 +<ul class="simple">
 +<li><a class="reference external" href="http://xcache.lighttpd.net/">XCache</a></li>
 +<li><a class="reference external" href="http://www.arbylon.net/projects/knowceans-tools/doc/org/knowceans/util/ArrayCache.html">ArrayCache</a></li>
 +</ul>
 +<p>Memcaches must be explicitly configured in ownCloud 8.1 and up by installing
 +and enabling your desired cache, and then adding the appropriate entry to
 +<tt class="docutils literal"><span class="pre">config.php</span></tt> (See <a class="reference internal" href="config_sample_php_parameters.html"><em>Config.php Parameters</em></a> for an overview of
 +all possible config parameters).</p>
 +<p>You may use both a local and a distributed cache. Recommended caches are APCu
 +and Redis. After installing and enabling your chosen memcache, verify that it is
 +active by running <a class="reference internal" href="../issues/index.html#label-phpinfo"><em>PHP Version and Information</em></a>.</p>
 +<div class="section" id="id1">
 +<h2>APC<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
 +<p>APC is only for systems running PHP 5.4 and older. The oldest supported PHP
 +version in ownCloud is 5.4.</p>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">RHEL 6 and CentOS 6 ship with PHP 5.3 and must be upgraded to PHP
 +5.4 to run ownCloud. See <a class="reference internal" href="../installation/php_54_installation.html"><em>Installing PHP 5.4 on RHEL 6 and CentOS 6</em></a>.</p>
 +</div>
 +<p>On Red Hat/CentOS/Fedora systems running PHP 5.4, install <tt class="docutils literal"><span class="pre">php-pecl-apc</span></tt>. On
 +Debian/Ubuntu/Mint systems install <tt class="docutils literal"><span class="pre">php-apc</span></tt>. Then restart your Web server.</p>
 +<p>After restarting your Web server, add this line to your <tt class="docutils literal"><span class="pre">config.php</span></tt> file:</p>
 +<div class="highlight-python"><pre>'memcache.local' => '\OC\Memcache\APC',</pre>
 +</div>
 +<p>Refresh your ownCloud admin page, and the cache warning should disappear.</p>
 +</div>
 +<div class="section" id="id2">
 +<h2>APCu<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
 +<p>PHP 5.5 and up includes the Zend OPcache in core, and on most Linux
 +distributions it is enabled by default. However, it does
 +not bundle a data cache. APCu is a data cache, and it is available in most
 +Linux distributions. On Red Hat/CentOS/Fedora systems running PHP 5.5 and up
 +install <tt class="docutils literal"><span class="pre">php-pecl-apcu</span></tt>. On Debian/Ubuntu/Mint systems install <tt class="docutils literal"><span class="pre">php5-apcu</span></tt>.
 +Then restart your Web server.</p>
 +<p>The version of APCu must be 4.0.6 and up.</p>
 +<p>After restarting your Web server, add this line to your <tt class="docutils literal"><span class="pre">config.php</span></tt> file:</p>
 +<div class="highlight-python"><pre>'memcache.local' => '\OC\Memcache\APCu',</pre>
 +</div>
 +<p>Refresh your ownCloud admin page, and the cache warning should disappear.</p>
 +</div>
 +<div class="section" id="id3">
 +<h2>Memcached<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
 +<p>Memcached is a reliable oldtimer for shared caching on distributed servers,
 +and performs well with ownCloud with one exception: it is not suitable to use
 +with <a class="reference internal" href="../configuration_files/files_locking_transactional.html"><em>Transactional File Locking</em></a>
 +because it does not store locks, and data can disappear from the cache at any time
 +(Redis is the best for this).</p>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">Be sure to install the <strong>memcached</strong> PHP module, and not memcache, as
 +in the following examples. ownCloud supports only the <strong>memcached</strong> PHP
 +module.</p>
 +</div>
 +<p>Setting up Memcached is easy. On Debian/Ubuntu/Mint install <tt class="docutils literal"><span class="pre">memcached</span></tt> and
 +<tt class="docutils literal"><span class="pre">php5-memcached</span></tt>. The installer will automatically start <tt class="docutils literal"><span class="pre">memcached</span></tt> and
 +configure it to launch at startup.</p>
 +<p>On Red Hat/CentOS/Fedora install <tt class="docutils literal"><span class="pre">memcached</span></tt> and
 +<tt class="docutils literal"><span class="pre">php-pecl-memcached</span></tt>. It will not start automatically, so you must use
 +your service manager to start <tt class="docutils literal"><span class="pre">memcached</span></tt>, and to launch it at boot as a
 +daemon.</p>
 +<p>You can verify that the Memcached daemon is running with <tt class="docutils literal"><span class="pre">ps</span> <span class="pre">ax</span></tt>:</p>
 +<div class="highlight-python"><pre>ps ax | grep memcached
 +19563 ? Sl 0:02 /usr/bin/memcached -m 64 -p 11211 -u memcache -l
 +127.0.0.1</pre>
 +</div>
 +<p>Restart your Web server, add the appropriate entries to your
 +<tt class="docutils literal"><span class="pre">config.php</span></tt>, and refresh your ownCloud admin page. This example uses APCu
 +for the local cache, Memcached as the distributed memcache, and lists all the
 +servers in the shared cache pool with their port numbers:</p>
 +<div class="highlight-python"><pre>'memcache.local' => '\OC\Memcache\APCu',
 +'memcache.distributed' => '\OC\Memcache\Memcached',
 +'memcached_servers' => array(
 +     array('localhost', 11211),
 +     array('server1.example.com', 11211),
 +     array('server2.example.com', 11211),
 +     ),</pre>
 +</div>
 +</div>
 +<div class="section" id="id4">
 +<h2>Redis<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h2>
 +<p>Redis is an excellent modern memcache to use for both distributed caching, and
 +as a local cache with <a class="reference internal" href="../configuration_files/files_locking_transactional.html"><em>Transactional File Locking</em></a> because it guarantees
 +that cached objects are available for as long as they are needed.</p>
 +<p>The Redis PHP module must be version 2.2.5 and up.</p>
 +<p>On Debian/Ubuntu/Mint install <tt class="docutils literal"><span class="pre">redis-server</span></tt> and <tt class="docutils literal"><span class="pre">php5-redis</span></tt>. The installer
 +will automatically launch <tt class="docutils literal"><span class="pre">redis-server</span></tt> and configure it to launch at
 +startup.</p>
 +<p>On Red Hat/CentOS/Fedora install <tt class="docutils literal"><span class="pre">redis</span></tt> and <tt class="docutils literal"><span class="pre">php-pecl-redis</span></tt>. It will not
 +start automatically, so you must use your service manager to start
 +<tt class="docutils literal"><span class="pre">redis</span></tt>, and to launch it at boot as a daemon.</p>
 +<p>You can verify that the Redis daemon is running with <tt class="docutils literal"><span class="pre">ps</span> <span class="pre">ax</span></tt>:</p>
 +<div class="highlight-python"><pre>ps ax | grep redis
 +22203 ? Ssl    0:00 /usr/bin/redis-server 127.0.0.1:6379</pre>
 +</div>
 +<p>Restart your Web server, add the appropriate entries to your <tt class="docutils literal"><span class="pre">config.php</span></tt>, and
 +refresh your ownCloud admin page. This example <tt class="docutils literal"><span class="pre">config.php</span></tt> configuration uses
 +Redis for the local server cache:</p>
 +<div class="highlight-python"><pre>'memcache.local' => '\OC\Memcache\Redis',
 +'redis' => array(
 +     'host' => 'localhost',
 +     'port' => 6379,
 +     'timeout' => 0.0,
 +      ),</pre>
 +</div>
 +<p>If you want to connect to Redis configured to listen on an unix socket (which is
 +recommended if Redis is running on the same system as ownCloud) use this example
 +<tt class="docutils literal"><span class="pre">config.php</span></tt> configuration:</p>
 +<div class="highlight-python"><pre>'memcache.local' => '\OC\Memcache\Redis',
 +'redis' => array(
 +     'host' => '/var/run/redis/redis.sock',
 +     'port' => 0,
 +     'timeout' => 0.0,
 +      ),</pre>
 +</div>
 +<p>Redis is very configurable; consult <a class="reference external" href="http://redis.io/documentation">the Redis documentation</a> to learn more.</p>
- <p>If you are on Ubuntu you can follow <a class="reference external" href="https://www.en0ch.se/how-to-configure-redis-cache-in-ubuntu-14-04-with-owncloud/">this guide</a> for a complete installation from scratch.</p>
++<p>If you are on Ubuntu you can follow <a class="reference external" href="https://www.techandme.se/how-to-configure-redis-cache-in-ubuntu-14-04-with-owncloud/">this guide</a> for a complete installation from scratch.</p>
 +</div>
 +<div class="section" id="cache-directory-location">
 +<h2>Cache Directory Location<a class="headerlink" href="#cache-directory-location" title="Permalink to this headline">¶</a></h2>
 +<p>The cache directory defaults to <tt class="docutils literal"><span class="pre">data/$user/cache</span></tt> where <tt class="docutils literal"><span class="pre">$user</span></tt> is the
 +current user. You may use the <tt class="docutils literal"><span class="pre">'cache_path'</span></tt> directive in <tt class="docutils literal"><span class="pre">config.php</span></tt>
 +(See <a class="reference internal" href="config_sample_php_parameters.html"><em>Config.php Parameters</em></a>) to select a different location.</p>
 +</div>
 +</div>
 +
 +
 +					</div>
 +				</div>
 +			</div>
 +    
 +  </div>
 +</div>
 +  </body>
 +</html>
diff --cc core/doc/admin/configuration_user/user_auth_ldap.html
index 4fd113f,0000000..bd32453
mode 100644,000000..100644
--- a/core/doc/admin/configuration_user/user_auth_ldap.html
+++ b/core/doc/admin/configuration_user/user_auth_ldap.html
@@@ -1,797 -1,0 +1,801 @@@
 +
 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 +  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 +
 +
 +<html xmlns="http://www.w3.org/1999/xhtml">
 +  <head>
 +    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 +    
 +    <title>User Authentication with LDAP — ownCloud 8.2 Server Administration Manual 8.2 documentation</title>
 +    
 +    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
 +    
 +    <script type="text/javascript">
 +      var DOCUMENTATION_OPTIONS = {
 +        URL_ROOT:    '../',
 +        VERSION:     '8.2',
 +        COLLAPSE_INDEX: false,
 +        FILE_SUFFIX: '.html',
 +        HAS_SOURCE:  true
 +      };
 +    </script>
 +    <script type="text/javascript" src="../_static/jquery.js"></script>
 +    <script type="text/javascript" src="../_static/underscore.js"></script>
 +    <script type="text/javascript" src="../_static/doctools.js"></script>
 +    <script type="text/javascript" src="../_static/bootstrap.js"></script>
 +    <link rel="top" title="ownCloud 8.2 Server Administration Manual 8.2 documentation" href="../index.html" />
 +    <link rel="up" title="User Management" href="index.html" />
 +    <link rel="next" title="LDAP User Cleanup" href="user_auth_ldap_cleanup.html" />
 +    <link rel="prev" title="User Authentication with IMAP, SMB, and FTP" href="user_auth_ftp_smb_imap.html" />
 +<script type="text/javascript">
 +(function () {
 +  /**
 +   * Patch TOC list.
 +   *
 +   * Will mutate the underlying span to have a correct ul for nav.
 +   *
 +   * @param $span: Span containing nested UL's to mutate.
 +   * @param minLevel: Starting level for nested lists. (1: global, 2: local).
 +   */
 +  var patchToc = function ($ul, minLevel) {
 +    var findA;
 +
 +    // Find all a "internal" tags, traversing recursively.
 +    findA = function ($elem, level) {
 +      var level = level || 0,
 +        $items = $elem.find("> li > a.internal, > ul, > li > ul");
 +
 +      // Iterate everything in order.
 +      $items.each(function (index, item) {
 +        var $item = $(item),
 +          tag = item.tagName.toLowerCase(),
 +          pad = 15 + ((level - minLevel) * 10);
 +
 +        if (tag === 'a' && level >= minLevel) {
 +          // Add to existing padding.
 +          $item.css('padding-left', pad + "px");
 +          console.log(level, $item, 'padding-left', pad + "px");
 +        } else if (tag === 'ul') {
 +          // Recurse.
 +          findA($item, level + 1);
 +        }
 +      });
 +    };
 +
 +    console.log("HERE");
 +    findA($ul);
 +  };
 +
 +  $(document).ready(function () {
 +    // Add styling, structure to TOC's.
 +    $(".dropdown-menu").each(function () {
 +      $(this).find("ul").each(function (index, item){
 +        var $item = $(item);
 +        $item.addClass('unstyled');
 +      });
 +      $(this).find("li").each(function () {
 +        $(this).parent().append(this);
 +      });
 +    });
 +
 +    // Patch in level.
 +    patchToc($("ul.globaltoc"), 2);
 +    patchToc($("ul.localtoc"), 2);
 +
 +    // Enable dropdown.
 +    $('.dropdown-toggle').dropdown();
 +  });
 +}());
 +</script>
 +
 +  </head>
 +  <body>
 +  
 +
 +<div class="container">
 +  <div class="content">
 +    <div class="page-header">
 +      <h1><a href="../contents.html">ownCloud 8.2 Server Administration Manual</a></h1>
 +
 +    </div>
 +    
 +			<div class="row">
 +				<div class="span3">
 +					<div class="sidebar">
 +						<div class="well">
 +							<div class="menu-support-container">
 +								<ul id="menu-support" class="menu">
 +									<ul>
 +										
 +<li><a href="../contents.html">Table of Contents</a></li>
 +									</ul>
 +                  <ul class="current">
 +<li class="toctree-l1"><a class="reference internal" href="../index.html">ownCloud 8.2 Server Administration Manual Introduction</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">ownCloud 8.2 Release Notes</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../whats_new_admin.html">What’s New for Admins in ownCloud 8.2</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">ownCloud Server Configuration</a></li>
 +<li class="toctree-l1 current"><a class="reference internal" href="index.html">User Management</a><ul class="current">
 +<li class="toctree-l2"><a class="reference internal" href="user_configuration.html">User Management</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="reset_admin_password.html">Resetting a Lost Admin Password</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="user_auth_ftp_smb_imap.html">User Authentication with IMAP, SMB, and FTP</a></li>
 +<li class="toctree-l2 current"><a class="current reference internal" href="">User Authentication with LDAP</a><ul>
 +<li class="toctree-l3"><a class="reference internal" href="#configuration">Configuration</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#advanced-settings">Advanced Settings</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#expert-settings">Expert Settings</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#testing-the-configuration">Testing the configuration</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#owncloud-avatar-integration">ownCloud Avatar integration</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#troubleshooting-tips-and-tricks">Troubleshooting, Tips and Tricks</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#ssl-certificate-verification-ldaps-tls">SSL Certificate Verification (LDAPS, TLS)</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#microsoft-active-directory">Microsoft Active Directory</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#memberof-read-memberof-permissions">memberOf / Read MemberOf permissions</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#duplicating-server-configurations">Duplicating Server Configurations</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#owncloud-ldap-internals">ownCloud LDAP Internals</a></li>
 +</ul>
 +</li>
 +<li class="toctree-l2"><a class="reference internal" href="user_auth_ldap_cleanup.html">LDAP User Cleanup</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="user_provisioning_api.html">User Provisioning API</a></li>
 +</ul>
 +</li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_files/index.html">File Sharing and Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database Configuration</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../operations/index.html">Operations</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../issues/index.html">Issues and Troubleshooting</a></li>
 +</ul>
 +<ul>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_installation/index.html">Enterprise Subscription Installation (ES Only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_clients/index.html">Creating Branded ownCloud Clients (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_server_branding/index.html">Enterprise Server Branding (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_external_storage/index.html">External Storage (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_user_management/index.html">User Management (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_files_drop/index.html">Enabling Anonymous Uploads with Files Drop (ES Only)</a></li>
 +</ul>
 +
 +								</ul>
 +							</div>
 +						</div>
 +					</div>
 +				</div>
 +        
 +
 +				<div class="span9">
 +					<div class="page-content">
 +						
 +  <div class="section" id="user-authentication-with-ldap">
 +<h1>User Authentication with LDAP<a class="headerlink" href="#user-authentication-with-ldap" title="Permalink to this headline">¶</a></h1>
 +<p>ownCloud ships with an LDAP application to allow LDAP users (including Active
 +Directory) to appear in your ownCloud user listings. These users will
 +authenticate to ownCloud with their LDAP credentials, so you don’t have to
 +create separate ownCloud user accounts for them. You will manage their ownCloud
 +group memberships, quotas, and sharing permissions just like any other ownCloud
 +user.</p>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">The PHP LDAP module is required; this is supplied by <tt class="docutils literal"><span class="pre">php5-ldap</span></tt> on
 +Debian/Ubuntu, and <tt class="docutils literal"><span class="pre">php-ldap</span></tt> on CentOS/Red Hat/Fedora. PHP 5.4+ is
 +required in ownCloud 8.1.</p>
 +</div>
 +<p>The LDAP application supports:</p>
 +<ul class="simple">
 +<li>LDAP group support</li>
 +<li>File sharing with ownCloud users and groups</li>
 +<li>Access via WebDAV and ownCloud Desktop Client</li>
 +<li>Versioning, external Storage and all other ownCloud features</li>
 +<li>Seamless connectivity to Active Directory, with no extra configuration
 +required</li>
 +<li>Support for primary groups in Active Directory</li>
 +<li>Auto-detection of LDAP attributes such as base DN, email, and the LDAP server
 +port number</li>
 +<li>Read-only access to your LDAP (no edit or delete of users on your LDAP)</li>
 +</ul>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">The LDAP app is not compatible with the <tt class="docutils literal"><span class="pre">User</span> <span class="pre">backend</span> <span class="pre">using</span> <span class="pre">remote</span> <span class="pre">HTTP</span> <span class="pre">servers</span></tt> app.
 +You cannot use both of them at the same time.</p>
 +</div>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">A non-blocking or correctly configured SELinux setup is needed
 +for the LDAP backend to work. Please refer to the <a class="reference internal" href="../installation/selinux_configuration.html#selinux-config-label"><em>SELinux Configuration</em></a>.</p>
 +</div>
 +<div class="section" id="configuration">
 +<h2>Configuration<a class="headerlink" href="#configuration" title="Permalink to this headline">¶</a></h2>
 +<p>First enable the <tt class="docutils literal"><span class="pre">LDAP</span> <span class="pre">user</span> <span class="pre">and</span> <span class="pre">group</span> <span class="pre">backend</span></tt> app on the Apps page in
 +ownCloud. Then go to your Admin page to configure it.</p>
 +<p>The LDAP configuration panel has four tabs. A correctly completed first tab
 +(“Server”) is mandatory to access the other tabs. A green indicator lights when
 +the configuration is correct. Hover your cursor over the fields to see some
 +pop-up tooltips.</p>
 +<div class="section" id="server-tab">
 +<h3>Server Tab<a class="headerlink" href="#server-tab" title="Permalink to this headline">¶</a></h3>
 +<p>Start with the Server tab. You may configure multiple servers if you have them.
 +At a minimum you must supply the LDAP server’s hostname. If your server requires
 +authentication, enter your credentials on this tab. ownCloud will then attempt
 +to auto-detect the server’s port and base DN. The base DN and port are
 +mandatory, so if ownCloud cannot detect them you must enter them manually.</p>
 +<div class="figure">
 +<img alt="../_images/ldap-wizard-1-server.png" src="../_images/ldap-wizard-1-server.png" />
 +</div>
 +<dl class="docutils">
 +<dt>Server configuration:</dt>
 +<dd>Configure one or more LDAP servers. Click the <strong>Delete Configuration</strong>
 +button to remove the active configuration.</dd>
 +<dt>Host:</dt>
 +<dd><p class="first">The host name or IP address of the LDAP server. It can also be a <strong>ldaps://</strong>
 +URI. If you enter the port number, it speeds up server detection.</p>
 +<p>Examples:</p>
 +<ul class="last simple">
 +<li><em>directory.my-company.com</em></li>
 +<li><em>ldaps://directory.my-company.com</em></li>
 +<li><em>directory.my-company.com:9876</em></li>
 +</ul>
 +</dd>
 +<dt>Port:</dt>
 +<dd><p class="first">The port on which to connect to the LDAP server. The field is disabled in the
 +beginning of a new configuration. If the LDAP server is running on a standard
 +port, the port will be detected automatically. If you are using a
 +non-standard port, ownCloud will attempt to detect it. If this fails you must
 +enter the port number manually.</p>
 +<p>Example:</p>
 +<ul class="last simple">
 +<li><em>389</em></li>
 +</ul>
 +</dd>
 +<dt>User DN:</dt>
 +<dd><p class="first">The name as DN of a user who has permissions to do searches in the LDAP
 +directory. Leave it empty for anonymous access. We recommend that you have a
 +special LDAP system user for this.</p>
 +<p>Example:</p>
 +<ul class="last simple">
 +<li><em>uid=owncloudsystemuser,cn=sysusers,dc=my-company,dc=com</em></li>
 +</ul>
 +</dd>
 +<dt>Password:</dt>
 +<dd>The password for the user given above. Empty for anonymous access.</dd>
 +<dt>Base DN:</dt>
 +<dd><p class="first">The base DN of LDAP, from where all users and groups can be reached. You may
 +enter multiple base DNs, one per line. (Base DNs for users and groups can be
 +set in the Advanced tab.) This field is mandatory. ownCloud attempts to
 +determine the Base DN according to the provided User DN or the provided
 +Host, and you must enter it manually if ownCloud does not detect it.</p>
 +<p>Example:</p>
 +<ul class="last simple">
 +<li><em>dc=my-company,dc=com</em></li>
 +</ul>
 +</dd>
 +</dl>
 +</div>
 +<div class="section" id="user-filter">
 +<h3>User Filter<a class="headerlink" href="#user-filter" title="Permalink to this headline">¶</a></h3>
 +<p>Use this to control which LDAP users are listed as ownCloud users on your
 +ownCloud server. In order to control which LDAP users can login to your
 +ownCloud
 +server use the Login filter. Those LDAP users who have access but are not
 +listed
 +as users (if there are any) will be hidden users. You may bypass the form
 +fields
 +and enter a raw LDAP filter if you prefer.</p>
 +<div class="figure">
 +<img alt="../_images/ldap-wizard-2-user.png" src="../_images/ldap-wizard-2-user.png" />
 +</div>
 +<dl class="docutils">
 +<dt>only those object classes:</dt>
 +<dd>ownCloud will determine the object classes that are typically available for
 +user objects in your LDAP. ownCloud will automatically select the object
 +class that returns the highest amount of users. You may select multiple
 +object classes.</dd>
 +<dt>only from those groups:</dt>
 +<dd>If your LDAP server supports the <tt class="docutils literal"><span class="pre">member-of-overlay</span></tt> in LDAP filters, you
 +can define that only users from one or more certain groups are allowed to
 +appear in user listings in ownCloud. By default, no value will be selected.</dd>
 +<dt>You</dt>
 +<dd><p class="first">may select multiple groups.</p>
 +<p class="last">If your LDAP server does not support the member-of-overlay in LDAP filters,
 +the input field is disabled. Please contact your LDAP administrator.</p>
 +</dd>
 +<dt>Edit raw filter instead:</dt>
 +<dd><p class="first">Clicking on this text toggles the filter mode and you can enter the raw LDAP
 +filter directly. Example:</p>
 +<div class="last highlight-python"><pre>(&(objectClass=inetOrgPerson)(memberOf=cn=owncloudusers,ou=groups,
 +dc=example,dc=com))</pre>
 +</div>
 +</dd>
 +<dt>x users found:</dt>
 +<dd>This is an indicator that tells you approximately how many users will be
 +listed in ownCloud. The number updates automatically after any changes.</dd>
 +</dl>
 +</div>
 +<div class="section" id="login-filter">
 +<h3>Login Filter<a class="headerlink" href="#login-filter" title="Permalink to this headline">¶</a></h3>
 +<p>The settings in the Login Filter tab determine which LDAP users can log in to
 +your
 +ownCloud system and which attribute or attributes the provided login name is
 +matched
 +against (e.g. LDAP/AD username, email address). You may select multiple user
 +details.
 +(You may bypass the form fields and enter a raw LDAP filter if you prefer.)</p>
 +<p>You may override your User Filter settings on the User Filter tab by using a
 +raw
 +LDAP filter.</p>
 +<div class="figure">
 +<img alt="../_images/ldap-wizard-3-login.png" src="../_images/ldap-wizard-3-login.png" />
 +</div>
 +<dl class="docutils">
 +<dt>LDAP Username:</dt>
 +<dd>If this value is checked, the login value will be compared to the username in
 +the LDAP directory. The corresponding attribute, usually <em>uid</em> or
 +<em>samaccountname</em> will be detected automatically by ownCloud.</dd>
 +<dt>LDAP Email Address:</dt>
 +<dd>If this value is checked, the login value will be compared to an email address
 +in the LDAP directory; specifically, the <em>mailPrimaryAddress</em> and <em>mail</em>
 +attributes.</dd>
 +<dt>Other Attributes:</dt>
 +<dd>This multi-select box allows you to select other attributes for the
 +comparison. The list is generated automatically from the user object
 +attributes in your LDAP server.</dd>
 +<dt>Edit raw filter instead:</dt>
 +<dd><p class="first">Clicking on this text toggles the filter mode and you can enter the raw LDAP
 +filter directly.</p>
 +<p>The <strong>%uid</strong> placeholder is replaced with the login name entered by the
 +user upon login.</p>
 +<p>Examples:</p>
 +<ul class="last">
 +<li><p class="first">only username:</p>
 +<div class="highlight-python"><pre>(&(objectClass=inetOrgPerson)(memberOf=cn=owncloudusers,ou=groups,
 +dc=example,dc=com)(uid=%uid)</pre>
 +</div>
 +</li>
 +<li><p class="first">username or email address:</p>
 +<div class="highlight-python"><pre>((&(objectClass=inetOrgPerson)(memberOf=cn=owncloudusers,ou=groups,
 +dc=example,dc=com)(|(uid=%uid)(mail=%uid)))</pre>
 +</div>
 +</li>
 +</ul>
 +</dd>
 +</dl>
 +</div>
 +<div class="section" id="group-filter">
 +<h3>Group Filter<a class="headerlink" href="#group-filter" title="Permalink to this headline">¶</a></h3>
 +<p>By default, no LDAP groups will be available in ownCloud. The settings in the
 +group filter tab determine which groups will be available in ownCloud. You may
 +also elect to enter a raw LDAP filter instead.</p>
 +<div class="figure">
 +<img alt="../_images/ldap-wizard-4-group.png" src="../_images/ldap-wizard-4-group.png" />
 +</div>
 +<dl class="docutils">
 +<dt>only those object classes:</dt>
 +<dd>ownCloud will determine the object classes that are typically available for
 +group objects in your LDAP server. ownCloud will only list object
 +classes that return at least one group object. You can select multiple
 +object classes. A typical object class is “group”, or “posixGroup”.</dd>
 +<dt>only from those groups:</dt>
 +<dd>ownCloud will generate a list of available groups found in your LDAP server.
 +and then you select the group or groups that get access to your ownCloud
 +server.</dd>
 +<dt>Edit raw filter instead:</dt>
 +<dd><p class="first">Clicking on this text toggles the filter mode and you can enter the raw LDAP
 +filter directly.</p>
 +<p>Example:</p>
 +<ul class="last simple">
 +<li><em>objectClass=group</em></li>
 +<li><em>objectClass=posixGroup</em></li>
 +</ul>
 +</dd>
 +<dt>y groups found:</dt>
 +<dd>This tells you approximately how many groups will be available in ownCloud.
 +The number updates automatically after any change.</dd>
 +</dl>
 +</div>
 +</div>
 +<div class="section" id="advanced-settings">
 +<h2>Advanced Settings<a class="headerlink" href="#advanced-settings" title="Permalink to this headline">¶</a></h2>
 +<p>The LDAP Advanced Setting section contains options that are not needed for a
 +working connection. This provides controls to disable the current
 +configuration,
 +configure replica hosts, and various performance-enhancing options.</p>
 +<p>The Advanced Settings are structured into three parts:</p>
 +<ul class="simple">
 +<li>Connection Settings</li>
 +<li>Directory Settings</li>
 +<li>Special Attributes</li>
 +</ul>
 +<div class="section" id="connection-settings">
 +<h3>Connection Settings<a class="headerlink" href="#connection-settings" title="Permalink to this headline">¶</a></h3>
 +<div class="figure">
 +<img alt="../_images/ldap-advanced-1-connection.png" src="../_images/ldap-advanced-1-connection.png" />
 +<p class="caption">LDAP Advanced Settings, section Connection Settings</p>
 +</div>
 +<dl class="docutils">
 +<dt>Configuration Active:</dt>
 +<dd>Enables or Disables the current configuration. By default, it is turned off.
 +When ownCloud makes a successful test connection it is automatically turned
 +on.</dd>
 +<dt>Backup (Replica) Host:</dt>
 +<dd><p class="first">If you have a backup LDAP server, enter the connection settings here.
 +ownCloud will then automatically connect to the backup when the main server
 +cannot be reached. The backup server must be a replica of the main server so
 +that the object UUIDs match.</p>
 +<p>Example:</p>
 +<ul class="last simple">
 +<li><em>directory2.my-company.com</em></li>
 +</ul>
 +</dd>
 +<dt>Backup (Replica) Port:</dt>
 +<dd><p class="first">The connection port of the backup LDAP server. If no port is given,
 +but only a host, then the main port (as specified above) will be used.</p>
 +<p>Example:</p>
 +<ul class="last simple">
 +<li><em>389</em></li>
 +</ul>
 +</dd>
 +<dt>Disable Main Server:</dt>
 +<dd>You can manually override the main server and make ownCloud only connect to
 +the backup server. This is useful for planned downtimes.</dd>
 +<dt>Turn off SSL certificate validation:</dt>
 +<dd>Turns off SSL certificate checking. Use it for testing only!</dd>
 +<dt>Cache Time-To-Live:</dt>
 +<dd><p class="first">A cache is introduced to avoid unnecessary LDAP traffic, for example caching
 +usernames so they don’t have to be looked up for every page, and speeding up
 +loading of the Users page. Saving the configuration empties the cache. The
 +time is given in seconds.</p>
 +<p>Note that almost every PHP request requires a new connection to the LDAP
 +server. If you require fresh PHP requests we recommend defining a minimum
 +lifetime of 15s or so, rather than completely eliminating the cache.</p>
 +<p>Examples:</p>
 +<ul class="last simple">
 +<li>ten minutes: <em>600</em></li>
 +<li>one hour: <em>3600</em></li>
 +</ul>
 +</dd>
 +</dl>
 +<p>See the Caching section below for detailed information on how the cache
 +operates.</p>
 +</div>
 +<div class="section" id="directory-settings">
 +<h3>Directory Settings<a class="headerlink" href="#directory-settings" title="Permalink to this headline">¶</a></h3>
 +<div class="figure">
 +<img alt="../_images/ldap-advanced-2-directory.png" src="../_images/ldap-advanced-2-directory.png" />
 +<p class="caption">LDAP Advanced Settings, section Directory Settings</p>
 +</div>
 +<dl class="docutils">
 +<dt>User Display Name Field:</dt>
 +<dd><p class="first">The attribute that should be used as display name in ownCloud.</p>
 +<ul class="last simple">
 +<li>Example: <em>displayName</em></li>
 +</ul>
 +</dd>
 +<dt>Base User Tree:</dt>
 +<dd><p class="first">The base DN of LDAP, from where all users can be reached. This must be a
 +complete DN, regardless of what you have entered for your Base DN in the
 +Basic setting. You can specify multiple base trees, one on each line.</p>
 +<ul class="last">
 +<li><p class="first">Example:</p>
 +<div class="line-block">
 +<div class="line"><em>cn=programmers,dc=my-company,dc=com</em></div>
 +<div class="line"><em>cn=designers,dc=my-company,dc=com</em></div>
 +</div>
 +</li>
 +</ul>
 +</dd>
 +<dt>User Search Attributes:</dt>
 +<dd><p class="first">These attributes are used when searches for users are performed, for example
 +in the share dialogue. The user display name attribute is the
 +default. You may list multiple attributes, one per line.</p>
 +<p>If an attribute is not available on a user object, the user will not be
 +listed, and will be unable to login. This also affects the display name
 +attribute. If you override the default you must specify the display name
 +attribute here.</p>
 +<ul class="last">
 +<li><p class="first">Example:</p>
 +<div class="line-block">
 +<div class="line"><em>displayName</em></div>
 +<div class="line"><em>mail</em></div>
 +</div>
 +</li>
 +</ul>
 +</dd>
 +<dt>Group Display Name Field:</dt>
 +<dd><p class="first">The attribute that should be used as ownCloud group name. ownCloud allows a
 +limited set of characters (a-zA-Z0-9.-_@). Once a group name is assigned it
 +cannot be changed.</p>
 +<ul class="last simple">
 +<li>Example: <em>cn</em></li>
 +</ul>
 +</dd>
 +<dt>Base Group Tree:</dt>
 +<dd><p class="first">The base DN of LDAP, from where all groups can be reached. This must be a
 +complete DN, regardless of what you have entered for your Base DN in the
 +Basic setting. You can specify multiple base trees, one in each line.</p>
 +<ul class="last">
 +<li><p class="first">Example:</p>
 +<div class="line-block">
 +<div class="line"><em>cn=barcelona,dc=my-company,dc=com</em></div>
 +<div class="line"><em>cn=madrid,dc=my-company,dc=com</em></div>
 +</div>
 +</li>
 +</ul>
 +</dd>
 +<dt>Group Search Attributes:</dt>
 +<dd><p class="first">These attributes are used when a search for groups is done, for example in
 +the share dialogue. By default the group display name attribute as specified
 +above is used. Multiple attributes can be given, one in each line.</p>
 +<p>If you override the default, the group display name attribute will not be
 +taken into account, unless you specify it as well.</p>
 +<ul class="last">
 +<li><p class="first">Example:</p>
 +<div class="line-block">
 +<div class="line"><em>cn</em></div>
 +<div class="line"><em>description</em></div>
 +</div>
 +</li>
 +</ul>
 +</dd>
 +<dt>Group Member association:</dt>
 +<dd><p class="first">The attribute that is used to indicate group memberships, i.e. the attribute
 +used by LDAP groups to refer to their users.</p>
 +<p>ownCloud detects the value automatically. You should only change it if you
 +have a very valid reason and know what you are doing.</p>
 +<ul class="last simple">
 +<li>Example: <em>uniquemember</em></li>
 +</ul>
 +</dd>
 +</dl>
 +</div>
 +<div class="section" id="special-attributes">
 +<h3>Special Attributes<a class="headerlink" href="#special-attributes" title="Permalink to this headline">¶</a></h3>
 +<div class="figure">
 +<img alt="../_images/ldap-advanced-3-attributes.png" src="../_images/ldap-advanced-3-attributes.png" />
 +<p class="caption">LDAP Advanced Settings, section Special Attributes</p>
 +</div>
 +<dl class="docutils">
 +<dt>Quota Field:</dt>
 +<dd><p class="first">ownCloud can read an LDAP attribute and set the user quota according to its
 +value. Specify the attribute here, and it will return human-readable values,
 +e.g. “2 GB”. Any quota set in LDAP overrides quotas set on the ownCloud user
 +management page.</p>
 +<ul class="last simple">
 +<li>Example: <em>ownCloudQuota</em></li>
 +</ul>
 +</dd>
 +<dt>Quota Default:</dt>
 +<dd><p class="first">Override ownCloud default quota for LDAP users who do not have a quota set in
 +the Quota Field.</p>
 +<ul class="last simple">
 +<li>Example: <em>15 GB</em></li>
 +</ul>
 +</dd>
 +<dt>Email Field:</dt>
 +<dd><p class="first">Set the user’s email from their LDAP attribute. Leave it empty for default
 +behavior.</p>
 +<ul class="last simple">
 +<li>Example: <em>mail</em></li>
 +</ul>
 +</dd>
 +<dt>User Home Folder Naming Rule:</dt>
 +<dd><p class="first">By default, the ownCloud server creates the user directory in your ownCloud
- data directory. You may want to override this setting and name it after an
- attribute value. The attribute given can also return an absolute path, e.g.
++data directory and gives it the ownCloud username, .e.g <tt class="docutils literal"><span class="pre">/var/www/owncloud/data/alice</span></tt>. You may want to override this setting and name it after an LDAP
++attribute value. The attribute can also return an absolute path, e.g.
 +<tt class="docutils literal"><span class="pre">/mnt/storage43/alice</span></tt>. Leave it empty for default behavior.</p>
 +<ul class="last simple">
 +<li>Example: <em>cn</em></li>
 +</ul>
 +</dd>
 +</dl>
++<p>In new ownCloud installations (8.0.10, 8.1.5, 8.2.0 and up) the home folder rule is enforced. This means that once you set a home folder naming rule (get a home folder from an LDAP attribute), it must be available for all users. If it isn’t available for a user, then that user will not be able to login. Also, the filesystem will not be set up for that user, so their file shares will not be available to other users.</p>
++<p>In existing ownCloud installations the old behavior still applies, which is using the ownCloud username as the home folder when an LDAP attribute is not set. You may change this to enforcing the home folder rule with the <tt class="docutils literal"><span class="pre">occ</span></tt> command in ownCloud 8.2, like this example on Ubuntu:</p>
++<div class="highlight-python"><pre>sudo -u www-data php occ config:app:set user_ldap enforce_home_folder_naming_rule --value=1</pre>
++</div>
 +</div>
 +</div>
 +<div class="section" id="expert-settings">
 +<h2>Expert Settings<a class="headerlink" href="#expert-settings" title="Permalink to this headline">¶</a></h2>
 +<div class="figure">
 +<img alt="../_images/ldap-expert.png" src="../_images/ldap-expert.png" />
 +</div>
 +<p>In the Expert Settings fundamental behavior can be adjusted to your needs. The
 +configuration should be well-tested before starting production use.</p>
 +<dl class="docutils">
 +<dt>Internal Username:</dt>
 +<dd><p class="first">The internal username is the identifier in ownCloud for LDAP users. By default
 +it will be created from the UUID attribute. The UUID attribute ensures that
 +the username is unique, and that characters do not need to be converted. Only
 +these characters are allowed: [a-zA-Z0-9_.@-]. Other characters are
 +replaced with their ASCII equivalents, or are simply omitted.</p>
 +<p>The LDAP backend ensures that there are no duplicate internal usernames in
 +ownCloud, i.e. that it is checking all other activated user backends
 +(including local ownCloud users). On collisions a random number (between 1000
 +and 9999) will be attached to the retrieved value. For example, if “alice”
 +exists, the next username may be “alice_1337”.</p>
 +<p>The internal username is the default name for the user home folder in
 +ownCloud. It is also a part of remote URLs, for instance for all *DAV
 +services.</p>
 +<p>You can override all of this with the Internal Username setting. Leave it
 +empty for default behaviour. Changes will affect only newly mapped LDAP users.</p>
 +<ul class="last simple">
 +<li>Example: <em>uid</em></li>
 +</ul>
 +</dd>
 +<dt>Override UUID detection</dt>
 +<dd><p class="first">By default, ownCloud auto-detects the UUID attribute. The UUID attribute is
 +used to uniquely identify LDAP users and groups. The internal username will
 +be created based on the UUID, if not specified otherwise.</p>
 +<p>You can override the setting and pass an attribute of your choice. You must
 +make sure that the attribute of your choice can be fetched for both users and
 +groups and it is unique. Leave it empty for default behaviour. Changes will
 +have effect only on newly mapped LDAP users and groups. It also will
 +have effect when a user’s or group’s DN changes and an old UUID was cached,
 +which will result in a new user. Because of this, the setting should be
 +applied before putting ownCloud in production use and clearing the bindings
 +(see the <tt class="docutils literal"><span class="pre">User</span> <span class="pre">and</span> <span class="pre">Group</span> <span class="pre">Mapping</span></tt> section below).</p>
 +<ul class="last simple">
 +<li>Example: <em>cn</em></li>
 +</ul>
 +</dd>
 +<dt>Username-LDAP User Mapping</dt>
 +<dd><p class="first">ownCloud uses usernames as keys to store and assign data. In order to
 +precisely identify and recognize users, each LDAP user will have a internal
 +username in ownCloud. This requires a mapping from ownCloud username to LDAP
 +user. The created username is mapped to the UUID of the LDAP user.
 +Additionally the DN is cached as well to reduce LDAP interaction, but it is
 +not used for identification. If the DN changes, the change will be detected by
 +ownCloud by checking the UUID value.</p>
 +<p>The same is valid for groups.</p>
 +<p>The internal ownCloud name is used all over in ownCloud. Clearing the Mappings
 +will have leftovers everywhere. Never clear the mappings in a production
 +environment, but only in a testing or experimental server.</p>
 +<p class="last"><strong>Clearing the Mappings is not configuration sensitive, it affects all LDAP
 +configurations!</strong></p>
 +</dd>
 +</dl>
 +</div>
 +<div class="section" id="testing-the-configuration">
 +<h2>Testing the configuration<a class="headerlink" href="#testing-the-configuration" title="Permalink to this headline">¶</a></h2>
 +<p>The <strong>Test Configuration</strong> button checks the values as currently given in the
 +input fields. You do not need to save before testing. By clicking on the
 +button, ownCloud will try to bind to the ownCloud server using the
 +settings currently given in the input fields. If the binding fails you’ll see a
 +yellow banner with the error message “The configuration is invalid. Please have
 +a look at the logs for further details.”</p>
 +<p>When the configuration test reports success, save your settings and check if the
 +users and groups are fetched correctly on the Users page.</p>
 +</div>
 +<div class="section" id="owncloud-avatar-integration">
 +<h2>ownCloud Avatar integration<a class="headerlink" href="#owncloud-avatar-integration" title="Permalink to this headline">¶</a></h2>
 +<p>ownCloud supports user profile pictures, which are also called avatars. If a user
 +has a photo stored in the <em>jpegPhoto</em> or <em>thumbnailPhoto</em> attribute on your LDAP
 +server, it will be used as their avatar. In this case the user cannot alter their
 +avatar (on their Personal page) as it must be changed in LDAP. <em>jpegPhoto</em> is
 +preferred over <em>thumbnailPhoto</em>.</p>
 +<div class="figure">
 +<img alt="../_images/ldap-fetched-avatar.png" src="../_images/ldap-fetched-avatar.png" />
 +<p class="caption">Profile picture fetched from LDAP</p>
 +</div>
 +<p>If the <em>jpegPhoto</em> or <em>thumbnailPhoto</em> attribute is not set or empty, then
 +users can upload and manage their avatars on their ownCloud Personal pages.
 +Avatars managed in ownCloud are not stored in LDAP.</p>
 +<p>The <em>jpegPhoto</em> or <em>thumbnailPhoto</em> attribute is fetched once a day to make
 +sure the current photo from LDAP is used in ownCloud. LDAP avatars override
 +ownCloud avatars, and when an LDAP avatar is deleted then the most recent
 +ownCloud avatar replaces it.</p>
 +<p>Photos served from LDAP are automatically cropped and resized in ownCloud. This
 +affects only the presentation, and the original image is not changed.</p>
 +</div>
 +<div class="section" id="troubleshooting-tips-and-tricks">
 +<h2>Troubleshooting, Tips and Tricks<a class="headerlink" href="#troubleshooting-tips-and-tricks" title="Permalink to this headline">¶</a></h2>
 +</div>
 +<div class="section" id="ssl-certificate-verification-ldaps-tls">
 +<h2>SSL Certificate Verification (LDAPS, TLS)<a class="headerlink" href="#ssl-certificate-verification-ldaps-tls" title="Permalink to this headline">¶</a></h2>
 +<p>A common mistake with SSL certificates is that they may not be known to PHP.
 +If you have trouble with certificate validation make sure that</p>
 +<ul class="simple">
 +<li>You have the certificate of the server installed on the ownCloud server</li>
 +<li>The certificate is announced in the system’s LDAP configuration file (usually
 +<em>/etc/ldap/ldap.conf</em></li>
 +</ul>
 +<ul class="simple">
 +<li>Using LDAPS, also make sure that the port is correctly configured (by default
 +636)</li>
 +</ul>
 +</div>
 +<div class="section" id="microsoft-active-directory">
 +<h2>Microsoft Active Directory<a class="headerlink" href="#microsoft-active-directory" title="Permalink to this headline">¶</a></h2>
 +<p>Compared to earlier ownCloud versions, no further tweaks need to be done to
 +make ownCloud work with Active Directory. ownCloud will automatically find the
 +correct configuration in the set-up process.</p>
 +</div>
 +<div class="section" id="memberof-read-memberof-permissions">
 +<h2>memberOf / Read MemberOf permissions<a class="headerlink" href="#memberof-read-memberof-permissions" title="Permalink to this headline">¶</a></h2>
 +<p>If you want to use <tt class="docutils literal"><span class="pre">memberOf</span></tt> within your filter you might need to give your
 +querying user the permissions to use it. For Microsoft Active Directory this
 +is described <a class="reference external" href="https://serverfault.com/questions/167371/what-permissions-are-required-for-enumerating-users-groups-in-active-directory/167401#167401">here</a>.</p>
 +</div>
 +<div class="section" id="duplicating-server-configurations">
 +<h2>Duplicating Server Configurations<a class="headerlink" href="#duplicating-server-configurations" title="Permalink to this headline">¶</a></h2>
 +<p>In case you have a working configuration and want to create a similar one or
 +“snapshot” configurations before modifying them you can do the following:</p>
 +<ol class="arabic simple">
 +<li>Go to the <strong>Server</strong> tab</li>
 +<li>On <strong>Server Configuration</strong> choose <em>Add Server Configuration</em></li>
 +<li>Answer the question <em>Take over settings from recent server configuration?</em>
 +with <em>yes</em>.</li>
 +<li>(optional) Switch to <strong>Advanced</strong> tab and uncheck <strong>Configuration Active</strong>
 +in the <em>Connection Settings</em>, so the new configuration is not used on Save</li>
 +<li>Click on <strong>Save</strong></li>
 +</ol>
 +<p>Now you can modify and enable the configuration.</p>
 +</div>
 +<div class="section" id="owncloud-ldap-internals">
 +<h2>ownCloud LDAP Internals<a class="headerlink" href="#owncloud-ldap-internals" title="Permalink to this headline">¶</a></h2>
 +<p>Some parts of how the LDAP backend works are described here.</p>
 +<div class="section" id="user-and-group-mapping">
 +<h3>User and Group Mapping<a class="headerlink" href="#user-and-group-mapping" title="Permalink to this headline">¶</a></h3>
 +<p>In ownCloud the user or group name is used to have all relevant information in
 +the database assigned. To work reliably a permanent internal user name and
 +group name is created and mapped to the LDAP DN and UUID. If the DN changes in
 +LDAP it will be detected, and there will be no conflicts.</p>
 +<p>Those mappings are done in the database table <tt class="docutils literal"><span class="pre">ldap_user_mapping</span></tt> and
 +<tt class="docutils literal"><span class="pre">ldap_group_mapping</span></tt>. The user name is also used for the user’s folder (except
 +if something else is specified in <em>User Home Folder Naming Rule</em>), which
 +contains files and meta data.</p>
 +<p>As of ownCloud 5 the internal user name and a visible display name are separated.
 +This is not the case for group names, yet, i.e. a group name cannot be altered.</p>
 +<p>That means that your LDAP configuration should be good and ready before putting
 +it into production. The mapping tables are filled early, but as long as you are
 +testing, you can empty the tables any time. Do not do this in production.</p>
 +</div>
 +<div class="section" id="caching">
 +<h3>Caching<a class="headerlink" href="#caching" title="Permalink to this headline">¶</a></h3>
 +<p>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 (see
 +<a class="reference internal" href="../configuration_server/caching_configuration.html"><em>Configuring Memory Caching</em></a>). The ownCloud  <strong>Cache</strong>
 +helps to speed up user interactions and sharing. It is populated on demand,
 +and remains populated until the <strong>Cache Time-To-Live</strong> for 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.</p>
 +<p>You can adjust the <strong>Cache Time-To-Live</strong> value to balance performance and
 +freshness of LDAP data. All LDAP requests will be cached for 10 minutes by
 +default, and you can alter this with the <strong>Cache Time-To-Live</strong> setting. The
 +cache answers each request that is identical to a previous request, within the
 +time-to-live of the original request, rather than hitting the LDAP server.</p>
 +<p>The <strong>Cache Time-To-Live</strong> is related to each single request. After a cache
 +entry expires there is no automatic trigger for re-populating the information,
 +as the cache is populated only by new requests, for example by opening the
 +User administration page, or searching in a sharing dialog.</p>
 +<p>There is one trigger which is automatically triggered by a certain background
 +job which keeps the <tt class="docutils literal"><span class="pre">user-group-mappings</span></tt> up-to-date, and always in cache.</p>
 +<p>Under normal circumstances, all users are never loaded at the same time.
 +Typically the loading of users happens while page results are generated, in
 +steps of 30 until the limit is reached or no results are left. For this to
 +work on an oC-Server and LDAP-Server, <strong>Paged Results</strong> must be supported,
 +which presumes PHP >= 5.4.</p>
 +<p>ownCloud remembers which user belongs to which LDAP-configuration. That means
 +each request will always be directed to the right server unless a user is
 +defunct, for example due to a server migration or unreachable server. In this
 +case the other servers will also receive the request.</p>
 +</div>
 +<div class="section" id="handling-with-backup-server">
 +<h3>Handling with Backup Server<a class="headerlink" href="#handling-with-backup-server" title="Permalink to this headline">¶</a></h3>
 +<p>When ownCloud is not able to contact the main LDAP server, ownCloud assumes it
 +is offline and will not try to connect again for the time specified in <strong>Cache
 +Time-To-Live</strong>. If you have a backup server configured ownCloud will connect to
 +it instead. When you have scheduled downtime, check <strong>Disable Main Server</strong>  to
 +avoid unnecessary connection attempts.</p>
 +</div>
 +</div>
 +</div>
 +
 +
 +					</div>
 +				</div>
 +			</div>
 +    
 +  </div>
 +</div>
 +  </body>
 +</html>
diff --cc core/doc/admin/enterprise_external_storage/windows-network-drive_configuration.html
index 4f0a590,0000000..303a9ff
mode 100644,000000..100644
--- a/core/doc/admin/enterprise_external_storage/windows-network-drive_configuration.html
+++ b/core/doc/admin/enterprise_external_storage/windows-network-drive_configuration.html
@@@ -1,279 -1,0 +1,285 @@@
 +
 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 +  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 +
 +
 +<html xmlns="http://www.w3.org/1999/xhtml">
 +  <head>
 +    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 +    
 +    <title>Installing and Configuring the Windows Network Drive App — ownCloud 8.2 Server Administration Manual 8.2 documentation</title>
 +    
 +    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
 +    
 +    <script type="text/javascript">
 +      var DOCUMENTATION_OPTIONS = {
 +        URL_ROOT:    '../',
 +        VERSION:     '8.2',
 +        COLLAPSE_INDEX: false,
 +        FILE_SUFFIX: '.html',
 +        HAS_SOURCE:  true
 +      };
 +    </script>
 +    <script type="text/javascript" src="../_static/jquery.js"></script>
 +    <script type="text/javascript" src="../_static/underscore.js"></script>
 +    <script type="text/javascript" src="../_static/doctools.js"></script>
 +    <script type="text/javascript" src="../_static/bootstrap.js"></script>
 +    <link rel="top" title="ownCloud 8.2 Server Administration Manual 8.2 documentation" href="../index.html" />
 +    <link rel="up" title="External Storage (ES only)" href="index.html" />
 +    <link rel="next" title="User Management (ES only)" href="../enterprise_user_management/index.html" />
 +    <link rel="prev" title="Configuring SharePoint Integration" href="sharepoint-integration_configuration.html" />
 +<script type="text/javascript">
 +(function () {
 +  /**
 +   * Patch TOC list.
 +   *
 +   * Will mutate the underlying span to have a correct ul for nav.
 +   *
 +   * @param $span: Span containing nested UL's to mutate.
 +   * @param minLevel: Starting level for nested lists. (1: global, 2: local).
 +   */
 +  var patchToc = function ($ul, minLevel) {
 +    var findA;
 +
 +    // Find all a "internal" tags, traversing recursively.
 +    findA = function ($elem, level) {
 +      var level = level || 0,
 +        $items = $elem.find("> li > a.internal, > ul, > li > ul");
 +
 +      // Iterate everything in order.
 +      $items.each(function (index, item) {
 +        var $item = $(item),
 +          tag = item.tagName.toLowerCase(),
 +          pad = 15 + ((level - minLevel) * 10);
 +
 +        if (tag === 'a' && level >= minLevel) {
 +          // Add to existing padding.
 +          $item.css('padding-left', pad + "px");
 +          console.log(level, $item, 'padding-left', pad + "px");
 +        } else if (tag === 'ul') {
 +          // Recurse.
 +          findA($item, level + 1);
 +        }
 +      });
 +    };
 +
 +    console.log("HERE");
 +    findA($ul);
 +  };
 +
 +  $(document).ready(function () {
 +    // Add styling, structure to TOC's.
 +    $(".dropdown-menu").each(function () {
 +      $(this).find("ul").each(function (index, item){
 +        var $item = $(item);
 +        $item.addClass('unstyled');
 +      });
 +      $(this).find("li").each(function () {
 +        $(this).parent().append(this);
 +      });
 +    });
 +
 +    // Patch in level.
 +    patchToc($("ul.globaltoc"), 2);
 +    patchToc($("ul.localtoc"), 2);
 +
 +    // Enable dropdown.
 +    $('.dropdown-toggle').dropdown();
 +  });
 +}());
 +</script>
 +
 +  </head>
 +  <body>
 +  
 +
 +<div class="container">
 +  <div class="content">
 +    <div class="page-header">
 +      <h1><a href="../contents.html">ownCloud 8.2 Server Administration Manual</a></h1>
 +
 +    </div>
 +    
 +			<div class="row">
 +				<div class="span3">
 +					<div class="sidebar">
 +						<div class="well">
 +							<div class="menu-support-container">
 +								<ul id="menu-support" class="menu">
 +									<ul>
 +										
 +<li><a href="../contents.html">Table of Contents</a></li>
 +									</ul>
 +                  <ul>
 +<li class="toctree-l1"><a class="reference internal" href="../index.html">ownCloud 8.2 Server Administration Manual Introduction</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">ownCloud 8.2 Release Notes</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../whats_new_admin.html">What’s New for Admins in ownCloud 8.2</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">ownCloud Server Configuration</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_user/index.html">User Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_files/index.html">File Sharing and Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database Configuration</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../operations/index.html">Operations</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../issues/index.html">Issues and Troubleshooting</a></li>
 +</ul>
 +<ul class="current">
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_installation/index.html">Enterprise Subscription Installation (ES Only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_clients/index.html">Creating Branded ownCloud Clients (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_server_branding/index.html">Enterprise Server Branding (ES only)</a></li>
 +<li class="toctree-l1 current"><a class="reference internal" href="index.html">External Storage (ES only)</a><ul class="current">
 +<li class="toctree-l2"><a class="reference internal" href="jive_configuration.html">Jive Integration</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="ldap_home_connector_configuration.html">LDAP Home Connector</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="s3_swift_as_primary_object_store_configuration.html">Configuring S3 and OpenStack Swift Objects as Primary Storage</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="sharepoint-integration_configuration.html">Configuring SharePoint Integration</a></li>
 +<li class="toctree-l2 current"><a class="current reference internal" href="">Installing and Configuring the Windows Network Drive App</a><ul>
 +<li class="toctree-l3"><a class="reference internal" href="#installation">Installation</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#additional-installation-steps">Additional Installation Steps</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#creating-a-new-share">Creating a New Share</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#personal-smb-mounts">Personal SMB Mounts</a></li>
 +</ul>
 +</li>
 +</ul>
 +</li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_user_management/index.html">User Management (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_files_drop/index.html">Enabling Anonymous Uploads with Files Drop (ES Only)</a></li>
 +</ul>
 +
 +								</ul>
 +							</div>
 +						</div>
 +					</div>
 +				</div>
 +        
 +
 +				<div class="span9">
 +					<div class="page-content">
 +						
 +  <div class="section" id="installing-and-configuring-the-windows-network-drive-app">
 +<h1>Installing and Configuring the Windows Network Drive App<a class="headerlink" href="#installing-and-configuring-the-windows-network-drive-app" title="Permalink to this headline">¶</a></h1>
 +<p>The Windows Network Drive app creates a control panel on your Admin page for
- seamless mounting of SMB/CIFS file shares on ownCloud servers that run on Linux.
- It does not work on Windows IIS or Windows Apache setups, but only Linux
- servers, because it requires the Samba client. (Samba is the free software
- implementation of the SMB/CIFS networking protocol.)</p>
++seamless mounting of SMB/CIFS file shares on ownCloud servers.</p>
 +<p>Any Windows file share, and Samba servers on Linux and other Unix-type operating
 +systems use the SMB/CIFS file-sharing protocol. The files and directories on the
 +SMB/CIFS server will be visible on your Files page just like your other ownCloud
 +files and folders. They are labeled with a little four-pane Windows-style icon,
 +and the left pane of your Files page includes a Windows Network Drive filter.
 +Figure 1 shows a new Windows Network Drive share marked with red warnings.
 +This indicates that ownCloud cannot connect to the share because it is not
 +available, or there is an error in the configuration.</p>
 +<div class="figure">
 +<img alt="Windows Network Drive share on your Files page." src="../_images/wnd-1.png" />
 +<p class="caption"><em>Figure 1: Windows Network Drive share on your Files page.</em></p>
 +</div>
 +<p>Files are synchronized bi-directionally, and you can create, upload, and delete
 +files and folders. ownCloud server admins can create Windows Network Drive
 +mounts, and optionally allow users to create their own personal Windows Network
 +Drive mounts. The password for each mount is encrypted and stored in the
 +ownCloud database, using a long random secret key stored in <tt class="docutils literal"><span class="pre">config.php</span></tt>. This
 +allows ownCloud to access the shares when the users who own the mounts are not
 +logged in.</p>
 +<div class="section" id="installation">
 +<h2>Installation<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h2>
 +<p>Enable the Windows Network Drive app on your ownCloud Apps page. Then there are
 +a few dependencies to install.</p>
 +<p>You must install the ownCloud <tt class="docutils literal"><span class="pre">php5-libsmbclient</span></tt> binary; please refer to the README in
 +your <a class="reference external" href="https://customer.owncloud.com/">customer.owncloud.com</a> account for instructions
 +on obtaining it.</p>
 +<p>You also need the Samba client installed on your Linux system. This is included in
 +all Linux distributions; on Debian, Ubuntu, and other Debian derivatives this
 +is <tt class="docutils literal"><span class="pre">smbclient</span></tt>. On SUSE, Red Hat, CentOS, and other Red Hat derivatives it is
 +<tt class="docutils literal"><span class="pre">samba-client</span></tt>.</p>
 +</div>
 +<div class="section" id="additional-installation-steps">
 +<h2>Additional Installation Steps<a class="headerlink" href="#additional-installation-steps" title="Permalink to this headline">¶</a></h2>
 +<p>If your Linux distribution ships with <tt class="docutils literal"><span class="pre">libsmbclient</span> <span class="pre">3.x</span></tt>, which is included in the Samba
 +client, you may need to set up the HOME variable in Apache to prevent a segmentation
 +fault. If you have <tt class="docutils literal"><span class="pre">libsmbclient</span> <span class="pre">4.1.6</span></tt> and higher it doesn’t seem to be an issue, so
 +you won’t have to change your HOME variable.</p>
 +<p>To set up the HOME variable on Ubuntu, modify the <tt class="docutils literal"><span class="pre">/etc/apache2/envvars</span></tt>
 +file:</p>
 +<div class="highlight-python"><pre>unset HOME
 +export HOME=/var/www</pre>
 +</div>
 +<p>In Red Hat/CentOS, modify the <tt class="docutils literal"><span class="pre">/etc/sysconfig/httpd</span></tt> file and add the
 +following line to set the HOME variable in Apache:</p>
 +<div class="highlight-python"><pre>export HOME=/usr/share/httpd</pre>
 +</div>
 +<p>By default CentOS has activated SELinux, and the <tt class="docutils literal"><span class="pre">httpd</span></tt> process can not make
 +outgoing network connections. This will cause problems with the <tt class="docutils literal"><span class="pre">curl</span></tt>, <tt class="docutils literal"><span class="pre">ldap</span></tt>
 +and <tt class="docutils literal"><span class="pre">samba</span></tt> libraries. You’ll need to get around this in order to make
 +this work. First check the status:</p>
 +<div class="highlight-python"><pre>getsebool -a | grep httpd
 +httpd_can_network_connect --> off</pre>
 +</div>
 +<p>Then enable support for network connections:</p>
 +<div class="highlight-python"><pre>setsebool -P httpd_can_network_connect 1</pre>
 +</div>
 +<p>In openSUSE, modify the <tt class="docutils literal"><span class="pre">/usr/sbin/start_apache2</span></tt> file:</p>
 +<div class="highlight-python"><pre>export HOME=/var/lib/apache2</pre>
 +</div>
 +<p>Restart Apache, open your ownCloud Admin page and start creating SMB/CIFS mounts.</p>
 +</div>
 +<div class="section" id="creating-a-new-share">
 +<h2>Creating a New Share<a class="headerlink" href="#creating-a-new-share" title="Permalink to this headline">¶</a></h2>
 +<p>When you create a new SMB share you need the login credentials for the share,
 +the server address, the share name, and the folder you want to connect to.</p>
 +<ol class="arabic simple">
 +<li>First enter the ownCloud mountpoint for your new SMB share. This must not be
 +an existing folder.</li>
 +<li>Then enter which ownCloud users or groups get access to the share. The
 +default is all users.</li>
 +<li>Next, enter the address of the server that contains the SMB share.</li>
 +<li>Then the Windows share name.</li>
- <li>Then the root folder of the share.</li>
++<li>Then the root folder of the share. This is the folder name, or the <tt class="docutils literal"><span class="pre">$user</span></tt> variable for user’s home directories.</li>
 +<li>Then your login credentials.</li>
 +</ol>
++<div class="figure">
++<img alt="$user variable in the folder field." src="../_images/wnd-3.jpg" />
++<p class="caption"><em>Figure 2: $user variable to automatically set user’s home directories.</em></p>
++</div>
 +<p>You have four options for login credentials:</p>
 +<ul class="simple">
 +<li><strong>User credentials</strong>.</li>
 +<li><strong>Global credentials</strong>, which uses the credentials  set in the Global
 +credentials fields</li>
 +<li><strong>Login credentials</strong> is for users to connect to the mountpoint using their
 +DOMAIN/logincredentials; enter the domain in the <strong>Domain</strong> field.</li>
 +<li><strong>Custom Credentials</strong></li>
 +</ul>
 +<div class="figure">
 +<a class="reference internal image-reference" href="../_images/wnd-2.png"><img alt="Windows Network Drive configuration panel." src="../_images/wnd-2.png" style="width: 726.75px; height: 161.55px;" /></a>
- <p class="caption"><em>Figure 2: Windows Network Drive configuration panel. (Click to enlarge.)</em></p>
++<p class="caption"><em>Figure 3: Windows Network Drive configuration panel. (Click to enlarge.)</em></p>
 +</div>
 +<p>When you’re finished click the <strong>Save</strong> button.</p>
++<div class="admonition note">
++<p class="first admonition-title">Note</p>
++<p class="last">When you create a new mountpoint using Login credentials you must log out of ownCloud,
++and then log back in so you can access the share. You only have to do this the first time.</p>
++</div>
 +</div>
 +<div class="section" id="personal-smb-mounts">
 +<h2>Personal SMB Mounts<a class="headerlink" href="#personal-smb-mounts" title="Permalink to this headline">¶</a></h2>
 +<p>Users create their own personal SMB mounts on their Personal pages. These are
 +created the same way as Admin-created shares. Users have only two options for
 +login credentials:</p>
 +<ul class="simple">
 +<li><strong>Personal Credentials</strong>.</li>
 +<li><strong>Custom Credentials</strong></li>
 +</ul>
 +</div>
 +</div>
 +
 +
 +					</div>
 +				</div>
 +			</div>
 +    
 +  </div>
 +</div>
 +  </body>
 +</html>
diff --cc core/doc/admin/installation/source_installation.html
index aede47c,0000000..2796b8d
mode 100644,000000..100644
--- a/core/doc/admin/installation/source_installation.html
+++ b/core/doc/admin/installation/source_installation.html
@@@ -1,564 -1,0 +1,571 @@@
 +
 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 +  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 +
 +
 +<html xmlns="http://www.w3.org/1999/xhtml">
 +  <head>
 +    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 +    
 +    <title>Manual Installation on Linux — ownCloud 8.2 Server Administration Manual 8.2 documentation</title>
 +    
 +    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
 +    
 +    <script type="text/javascript">
 +      var DOCUMENTATION_OPTIONS = {
 +        URL_ROOT:    '../',
 +        VERSION:     '8.2',
 +        COLLAPSE_INDEX: false,
 +        FILE_SUFFIX: '.html',
 +        HAS_SOURCE:  true
 +      };
 +    </script>
 +    <script type="text/javascript" src="../_static/jquery.js"></script>
 +    <script type="text/javascript" src="../_static/underscore.js"></script>
 +    <script type="text/javascript" src="../_static/doctools.js"></script>
 +    <script type="text/javascript" src="../_static/bootstrap.js"></script>
 +    <link rel="top" title="ownCloud 8.2 Server Administration Manual 8.2 documentation" href="../index.html" />
 +    <link rel="up" title="Installation" href="index.html" />
 +    <link rel="next" title="ownCloud Community Appliance" href="appliance_installation.html" />
 +    <link rel="prev" title="Installing and Managing Apps" href="apps_management_installation.html" />
 +<script type="text/javascript">
 +(function () {
 +  /**
 +   * Patch TOC list.
 +   *
 +   * Will mutate the underlying span to have a correct ul for nav.
 +   *
 +   * @param $span: Span containing nested UL's to mutate.
 +   * @param minLevel: Starting level for nested lists. (1: global, 2: local).
 +   */
 +  var patchToc = function ($ul, minLevel) {
 +    var findA;
 +
 +    // Find all a "internal" tags, traversing recursively.
 +    findA = function ($elem, level) {
 +      var level = level || 0,
 +        $items = $elem.find("> li > a.internal, > ul, > li > ul");
 +
 +      // Iterate everything in order.
 +      $items.each(function (index, item) {
 +        var $item = $(item),
 +          tag = item.tagName.toLowerCase(),
 +          pad = 15 + ((level - minLevel) * 10);
 +
 +        if (tag === 'a' && level >= minLevel) {
 +          // Add to existing padding.
 +          $item.css('padding-left', pad + "px");
 +          console.log(level, $item, 'padding-left', pad + "px");
 +        } else if (tag === 'ul') {
 +          // Recurse.
 +          findA($item, level + 1);
 +        }
 +      });
 +    };
 +
 +    console.log("HERE");
 +    findA($ul);
 +  };
 +
 +  $(document).ready(function () {
 +    // Add styling, structure to TOC's.
 +    $(".dropdown-menu").each(function () {
 +      $(this).find("ul").each(function (index, item){
 +        var $item = $(item);
 +        $item.addClass('unstyled');
 +      });
 +      $(this).find("li").each(function () {
 +        $(this).parent().append(this);
 +      });
 +    });
 +
 +    // Patch in level.
 +    patchToc($("ul.globaltoc"), 2);
 +    patchToc($("ul.localtoc"), 2);
 +
 +    // Enable dropdown.
 +    $('.dropdown-toggle').dropdown();
 +  });
 +}());
 +</script>
 +
 +  </head>
 +  <body>
 +  
 +
 +<div class="container">
 +  <div class="content">
 +    <div class="page-header">
 +      <h1><a href="../contents.html">ownCloud 8.2 Server Administration Manual</a></h1>
 +
 +    </div>
 +    
 +			<div class="row">
 +				<div class="span3">
 +					<div class="sidebar">
 +						<div class="well">
 +							<div class="menu-support-container">
 +								<ul id="menu-support" class="menu">
 +									<ul>
 +										
 +<li><a href="../contents.html">Table of Contents</a></li>
 +									</ul>
 +                  <ul class="current">
 +<li class="toctree-l1"><a class="reference internal" href="../index.html">ownCloud 8.2 Server Administration Manual Introduction</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">ownCloud 8.2 Release Notes</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../whats_new_admin.html">What’s New for Admins in ownCloud 8.2</a></li>
 +<li class="toctree-l1 current"><a class="reference internal" href="index.html">Installation</a><ul class="current">
 +<li class="toctree-l2"><a class="reference internal" href="system_requirements.html">System Requirements</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="linux_installation.html">Preferred Linux Installation Method</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="installation_wizard.html">Installation Wizard</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="command_line_installation.html">Installing ownCloud From the Command Line</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="apps_management_installation.html">Installing and Managing Apps</a></li>
 +<li class="toctree-l2 current"><a class="current reference internal" href="">Manual Installation on Linux</a><ul>
 +<li class="toctree-l3"><a class="reference internal" href="#prerequisites">Prerequisites</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#example-installation-on-ubuntu-14-04-lts-server">Example Installation on Ubuntu 14.04 LTS Server</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#apache-web-server-configuration">Apache Web Server Configuration</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#enabling-ssl">Enabling SSL</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#installation-wizard">Installation Wizard</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#setting-strong-directory-permissions">Setting Strong Directory Permissions</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#selinux-configuration-tips">SELinux Configuration Tips</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#php-ini-configuration-notes">php.ini Configuration Notes</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#php-fpm-configuration-notes">php-fpm Configuration Notes</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#other-web-servers">Other Web Servers</a></li>
 +</ul>
 +</li>
 +<li class="toctree-l2"><a class="reference internal" href="appliance_installation.html">ownCloud Community Appliance</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="php_54_installation.html">Installing PHP 5.4 on RHEL 6 and CentOS 6</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="php_55_installation.html">Installing PHP 5.5 on RHEL 7 and CentOS 7</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="selinux_configuration.html">SELinux Configuration</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="nginx_configuration.html">Nginx Configuration</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="ucs_installation.html">Univention Corporate Server</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="hiawatha_configuration.html">Hiawatha Configuration</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="yaws_configuration.html">Yaws Configuration</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="macos_installation.html">Mac OS X</a></li>
 +</ul>
 +</li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">ownCloud Server Configuration</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_user/index.html">User Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_files/index.html">File Sharing and Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database Configuration</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../operations/index.html">Operations</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../issues/index.html">Issues and Troubleshooting</a></li>
 +</ul>
 +<ul>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_installation/index.html">Enterprise Subscription Installation (ES Only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_clients/index.html">Creating Branded ownCloud Clients (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_server_branding/index.html">Enterprise Server Branding (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_external_storage/index.html">External Storage (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_user_management/index.html">User Management (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="../enterprise_files_drop/index.html">Enabling Anonymous Uploads with Files Drop (ES Only)</a></li>
 +</ul>
 +
 +								</ul>
 +							</div>
 +						</div>
 +					</div>
 +				</div>
 +        
 +
 +				<div class="span9">
 +					<div class="page-content">
 +						
 +  <div class="section" id="manual-installation-on-linux">
 +<h1>Manual Installation on Linux<a class="headerlink" href="#manual-installation-on-linux" title="Permalink to this headline">¶</a></h1>
 +<p>Installing ownCloud on Linux from our Open Build Service packages is the
 +preferred method (see <a class="reference internal" href="linux_installation.html"><em>Preferred Linux Installation Method</em></a>). These are maintained by
 +ownCloud engineers, and you can use your package manager to keep your ownCloud
 +server up-to-date.</p>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">Enterprise Subscription customers should refer to
 +<a class="reference internal" href="../enterprise_installation/linux_installation.html"><em>Installing & Upgrading ownCloud Enterprise Subscription</em></a></p>
 +</div>
 +<p>If there are no packages for your Linux distribution, or you prefer installing
 +from the source tarball, you can setup ownCloud from scratch using a classic
 +LAMP stack (Linux, Apache, MySQL/MariaDB, PHP). This document provides a
 +complete walk-through for installing ownCloud on Ubuntu 14.04 LTS Server with
 +Apache and MariaDB, using <a class="reference external" href="https://owncloud.org/install/">the ownCloud .tar archive</a>.</p>
 +<ul class="simple">
 +<li><a class="reference internal" href="#prerequisites-label"><em>Prerequisites</em></a></li>
 +<li><a class="reference internal" href="#ubuntu-installation-label"><em>Example Installation on Ubuntu 14.04 LTS Server</em></a></li>
 +<li><a class="reference internal" href="#apache-configuration-label"><em>Apache Web Server Configuration</em></a></li>
 +<li><a class="reference internal" href="#enabling-ssl-label"><em>Enabling SSL</em></a></li>
 +<li><a class="reference internal" href="#installation-wizard-label"><em>Installation Wizard</em></a></li>
 +<li><a class="reference internal" href="#strong-permissions-label"><em>Setting Strong Directory Permissions</em></a></li>
 +<li><a class="reference internal" href="#selinux-tips-label"><em>SELinux Configuration Tips</em></a></li>
 +<li><a class="reference internal" href="#php-ini-tips-label"><em>php.ini Configuration Notes</em></a></li>
 +<li><a class="reference internal" href="#php-fpm-tips-label"><em>php-fpm Configuration Notes</em></a></li>
 +<li><a class="reference internal" href="#other-http-servers-label"><em>Other Web Servers</em></a></li>
 +</ul>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">Admins of SELinux-enabled distributions such as CentOS, Fedora, and
 +Red Hat Enterprise Linux may need to set new rules to enable installing
 +ownCloud. See <a class="reference internal" href="#selinux-tips-label"><em>SELinux Configuration Tips</em></a> for a suggested configuration.</p>
 +</div>
 +<div class="section" id="prerequisites">
 +<span id="prerequisites-label"></span><h2>Prerequisites<a class="headerlink" href="#prerequisites" title="Permalink to this headline">¶</a></h2>
 +<p>The ownCloud .tar archive contains all of the required PHP modules. This section
 +lists all required and optional PHP modules.  Consult the <a class="reference external" href="http://php.net/manual/en/extensions.php">PHP manual</a> for more information on modules.
 +Your Linux distribution should have packages for all required modules.</p>
 +<p>Required:</p>
 +<ul class="simple">
 +<li>php5 (>= 5.5)</li>
 +<li>PHP module ctype</li>
 +<li>PHP module dom</li>
 +<li>PHP module GD</li>
 +<li>PHP module iconv</li>
 +<li>PHP module JSON</li>
 +<li>PHP module libxml</li>
 +<li>PHP module mb multibyte</li>
 +<li>PHP module posix</li>
 +<li>PHP module SimpleXML</li>
 +<li>PHP module XMLWriter</li>
 +<li>PHP module zip</li>
 +<li>PHP module zlib</li>
 +</ul>
 +<p>Database connectors (pick the one for your database:)</p>
 +<ul class="simple">
 +<li>PHP module sqlite (>= 3, usually not recommended for performance reasons)</li>
 +<li>PHP module pdo_mysql (MySQL/MariaDB)</li>
 +<li>PHP module pgsql (requires PostgreSQL >= 9.0)</li>
 +</ul>
 +<p><em>Recommended</em> packages:</p>
 +<ul class="simple">
 +<li>PHP module curl (highly recommended, some functionality, e.g. HTTP user
 +authentication, depends on this)</li>
 +<li>PHP module fileinfo (highly recommended, enhances file analysis performance)</li>
 +<li>PHP module bz2 (recommended, required for extraction of apps)</li>
 +<li>PHP module intl (increases language translation performance and fixes sorting
 +of non-ASCII characters)</li>
 +<li>PHP module mcrypt (increases file encryption performance)</li>
 +<li>PHP module openssl (required for accessing HTTPS resources)</li>
 +</ul>
 +<p>Required for specific apps:</p>
 +<ul class="simple">
 +<li>PHP module ldap (for LDAP integration)</li>
 +<li><a class="reference external" href="https://software.opensuse.org/download.html?project=isv%3AownCloud%3Acommunity%3A8.1&package=php5-libsmbclient">php5-libsmbclient</a> (SMB/CIFS integration)</li>
 +<li>PHP module ftp (for FTP storage / external user authentication)</li>
 +<li>PHP module imap (for external user authentication)</li>
 +</ul>
 +<p>Recommended for specific apps (<em>optional</em>):</p>
 +<ul class="simple">
 +<li>PHP module exif (for image rotation in pictures app)</li>
 +<li>PHP module gmp (for SFTP storage)</li>
 +</ul>
 +<p>For enhanced server performance (<em>optional</em>) select one of the following
 +memcaches:</p>
 +<ul class="simple">
 +<li>PHP module apc</li>
 +<li>PHP module apcu</li>
 +<li>PHP module memcached</li>
 +<li>PHP module redis (required for Transactional File Locking)</li>
 +</ul>
 +<p>See <a class="reference internal" href="../configuration_server/caching_configuration.html"><em>Configuring Memory Caching</em></a> to learn how to select
 +and configure a memcache.</p>
 +<p>For preview generation (<em>optional</em>):</p>
 +<ul class="simple">
 +<li>PHP module imagick</li>
 +<li>avconv or ffmpeg</li>
 +<li>OpenOffice or LibreOffice</li>
 +</ul>
 +<p>You don’t need the WebDAV module for your Web server (i.e. Apache’s
 +<tt class="docutils literal"><span class="pre">mod_webdav</span></tt>), as ownCloud has a built-in WebDAV server of its own, SabreDAV.
 +If <tt class="docutils literal"><span class="pre">mod_webdav</span></tt> is enabled you must disable it for ownCloud. (See
 +<a class="reference internal" href="#apache-configuration-label"><em>Apache Web Server Configuration</em></a> for an example configuration.)</p>
 +</div>
 +<div class="section" id="example-installation-on-ubuntu-14-04-lts-server">
 +<span id="ubuntu-installation-label"></span><h2>Example Installation on Ubuntu 14.04 LTS Server<a class="headerlink" href="#example-installation-on-ubuntu-14-04-lts-server" title="Permalink to this headline">¶</a></h2>
 +<p>On a machine running a pristine Ubuntu 14.04 LTS server, install the
 +required and recommended modules for a typical ownCloud installation, using
 +Apache and MariaDB, by issuing the following commands in a terminal:</p>
 +<div class="highlight-python"><pre>apt-get install apache2 mariadb-server libapache2-mod-php5
 +apt-get install php5-gd php5-json php5-mysql php5-curl
 +apt-get install php5-intl php5-mcrypt php5-imagick</pre>
 +</div>
 +<ul class="simple">
 +<li>This installs the packages for the ownCloud core system. If you are planning
 +on running additional apps, keep in mind that they might require additional
 +packages.  See <a class="reference internal" href="#prerequisites-label"><em>Prerequisites</em></a> for details.</li>
 +<li>At the installation of the MySQL/MariaDB server, you will be prompted to
- create a root password. Be sure to remember the password you enter there
- for later use as you will need it during ownCloud database setup.</li>
++create a root password. Be sure to remember your password as you will need it
++during ownCloud database setup.</li>
 +</ul>
 +<p>Now download the archive of the latest ownCloud version:</p>
 +<ul>
 +<li><p class="first">Go to the <a class="reference external" href="http://owncloud.org/install">ownCloud Download Page</a>.</p>
 +</li>
 +<li><p class="first">Go to <strong>Download ownCloud Server > Download > Archive file for
 +server owners</strong> and download either the tar.bz2 or .zip archive.</p>
 +</li>
 +<li><p class="first">This downloads a file named owncloud-x.y.z.tar.bz2 or owncloud-x.y.z.zip
 +(where x.y.z is the version number).</p>
 +</li>
 +<li><p class="first">Download its corresponding checksum file, e.g. owncloud-x.y.z.tar.bz2.md5,
 +or owncloud-x.y.z.tar.bz2.sha256.</p>
 +</li>
 +<li><p class="first">Verify the MD5 or SHA256 sum:</p>
 +<div class="highlight-python"><pre>md5sum -c owncloud-x.y.z.tar.bz2.md5 < owncloud-x.y.z.tar.bz2
 +sha256sum -c owncloud-x.y.z.tar.bz2.sha256 < owncloud-x.y.z.tar.bz2
 +md5sum  -c owncloud-x.y.z.zip.md5 < owncloud-x.y.z.zip
 +sha256sum  -c owncloud-x.y.z.zip.sha256 < owncloud-x.y.z.zip</pre>
 +</div>
 +</li>
 +<li><p class="first">You may also verify the PGP signature:</p>
 +<div class="highlight-python"><pre>wget https://download.owncloud.org/community/owncloud-x.y.z.tar.bz2.asc
 +wget https://www.owncloud.org/owncloud.asc
 +gpg --import owncloud.asc
 +gpg --verify owncloud-x.y.z.tar.bz2.asc owncloud-x.y.z.tar.bz2</pre>
 +</div>
 +</li>
 +<li><p class="first">Now you can extract the archive contents. Run the appropriate unpacking
 +command for your archive type:</p>
 +<div class="highlight-python"><pre>tar -xjf owncloud-x.y.z.tar.bz2
 +unzip owncloud-x.y.z.zip</pre>
 +</div>
 +</li>
 +<li><p class="first">This unpacks to a single <tt class="docutils literal"><span class="pre">owncloud</span></tt> directory. Copy the ownCloud directory
- to its final destination in the document root of your web server:</p>
++to its final destination. When you are running the Apache HTTP server you may
++safely install ownCloud in your Apache document root:</p>
 +<div class="highlight-python"><pre>cp -r owncloud /path/to/webserver/document-root</pre>
 +</div>
 +<p>where <tt class="docutils literal"><span class="pre">/path/to/webserver/document-root</span></tt> is replaced by the
 +document root of your Web server. On Ubuntu systems this
- <tt class="docutils literal"><span class="pre">/var/www/owncloud</span></tt>, so your copying command is:</p>
- <div class="highlight-python"><pre>cp -r owncloud /var/www</pre>
++<tt class="docutils literal"><span class="pre">/var/www/html/owncloud</span></tt>, so your copying command is:</p>
++<div class="highlight-python"><pre>cp -r owncloud /var/www/html</pre>
 +</div>
 +</li>
 +</ul>
++<p>On other HTTP servers it is recommended to install ownCloud outside of the
++document root.</p>
 +<blockquote>
 +<div></div></blockquote>
 +</div>
 +<div class="section" id="apache-web-server-configuration">
 +<span id="apache-configuration-label"></span><h2>Apache Web Server Configuration<a class="headerlink" href="#apache-web-server-configuration" title="Permalink to this headline">¶</a></h2>
 +<p>On Debian, Ubuntu, and their derivatives, Apache installs with a useful
 +configuration so all you have to do is create a
 +<tt class="file docutils literal"><span class="pre">/etc/apache2/sites-available/owncloud.conf</span></tt> file with these lines in
- it:</p>
- <div class="highlight-xml"><pre>Alias /owncloud /var/www/owncloud
-  <Directory /var/www/owncloud/>
-    Options +FollowSymlinks
-    AllowOverride All
++it, replacing the <strong>Directory</strong> and other filepaths with your own filepaths:</p>
++<div class="highlight-xml"><pre><Directory /var/www/html/owncloud/>
++  Options +FollowSymlinks
++  AllowOverride All
 +
-   <IfModule mod_dav.c>
-    Dav off
-   </IfModule>
++ <IfModule mod_dav.c>
++  Dav off
++ </IfModule>
 +
-   SetEnv HOME /var/www/owncloud
-   SetEnv HTTP_HOME /var/www/owncloud
++ SetEnv HOME /var/www/html/owncloud
++ SetEnv HTTP_HOME /var/www/html/owncloud
 +
-  </Directory></pre>
++</Directory></pre>
++</div>
++<p>If you install ownCloud outside of Apache’s DocumentRoot, then you must add an
++<strong>Alias</strong> directive at the top of the file. In this example ownCloud is installed in
++<tt class="docutils literal"><span class="pre">/var/www/owncloud</span></tt>:</p>
++<div class="highlight-python"><pre>Alias /owncloud "/var/www/owncloud/"</pre>
 +</div>
 +<p>Then create a symlink to <tt class="file docutils literal"><span class="pre">/etc/apache2/sites-enabled</span></tt>:</p>
 +<div class="highlight-python"><div class="highlight"><pre><span class="n">ln</span> <span class="o">-</span><span class="n">s</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">apache2</span><span class="o">/</span><span class="n">sites</span><span class="o">-</span><span class="n">available</span><span class="o">/</span><span class="n">owncloud</span><span class="o">.</span><span class="n">conf</span> <span class="o">/</span><span class="n" [...]
 +</pre></div>
 +</div>
 +<div class="section" id="additional-apache-configurations">
 +<h3>Additional Apache Configurations<a class="headerlink" href="#additional-apache-configurations" title="Permalink to this headline">¶</a></h3>
 +<ul>
 +<li><p class="first">For ownCloud to work correctly, we need the module <tt class="docutils literal"><span class="pre">mod_rewrite</span></tt>. Enable it
 +by running:</p>
 +<div class="highlight-python"><pre>a2enmod rewrite</pre>
 +</div>
 +<p>Additional recommended modules are <tt class="docutils literal"><span class="pre">mod_headers</span></tt>, <tt class="docutils literal"><span class="pre">mod_env</span></tt>, <tt class="docutils literal"><span class="pre">mod_dir</span></tt> and <tt class="docutils literal"><span class="pre">mod_mime</span></tt>:</p>
 +<div class="highlight-python"><pre>a2enmod headers
 +a2enmod env
 +a2enmod dir
 +a2enmod mime</pre>
 +</div>
 +<p>If you’re running <tt class="docutils literal"><span class="pre">mod_fcgi</span></tt> instead of the standard <tt class="docutils literal"><span class="pre">mod_php</span></tt> also enable:</p>
 +<div class="highlight-python"><pre>a2enmod setenvif</pre>
 +</div>
 +</li>
 +<li><p class="first">You must disable any server-configured authentication for ownCloud, as it
 +uses Basic authentication internally for DAV services. If you have turned on
 +authentication on a parent folder (via e.g. an <tt class="docutils literal"><span class="pre">AuthType</span> <span class="pre">Basic</span></tt>
 +directive), you can turn off the authentication specifically for the ownCloud
 +entry. Following the above example configuration file, add the following line
 +in the <tt class="docutils literal"><span class="pre"><Directory</span></tt> section:</p>
 +<div class="highlight-python"><pre>Satisfy Any</pre>
 +</div>
 +</li>
 +<li><p class="first">When using SSL, take special note of the ServerName. You should specify one in
 +the  server configuration, as well as in the CommonName field of the
 +certificate. If you want your ownCloud to be reachable via the internet, then
 +set both of these to the domain you want to reach your ownCloud server.</p>
 +</li>
 +<li><p class="first">Now restart Apache:</p>
 +<div class="highlight-python"><pre>service apache2 restart</pre>
 +</div>
 +</li>
 +<li><p class="first">If you’re running ownCloud in a subdirectory and want to use CalDAV or
 +CardDAV clients make sure you have configured the correct
 +<a class="reference internal" href="../issues/index.html#service-discovery-label"><em>Service discovery</em></a> URLs.</p>
 +</li>
 +</ul>
 +</div>
 +</div>
 +<div class="section" id="enabling-ssl">
 +<span id="enabling-ssl-label"></span><h2>Enabling SSL<a class="headerlink" href="#enabling-ssl" title="Permalink to this headline">¶</a></h2>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">You can use ownCloud over plain HTTP, but we strongly encourage you to
 +use SSL/TLS to encrypt all of your server traffic, and to protect
 +user’s logins and data in transit.</p>
 +</div>
 +<p>Apache installed under Ubuntu comes already set-up with a simple
 +self-signed certificate. All you have to do is to enable the ssl module and
 +the default site. Open a terminal and run:</p>
 +<div class="highlight-python"><pre>a2enmod ssl
 +a2ensite default-ssl
 +service apache2 reload</pre>
 +</div>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">Self-signed certificates have their drawbacks - especially when you
 +plan to make your ownCloud server publicly accessible. You might want
 +to consider getting a certificate signed by a commercial signing
 +authority. Check with your domain name registrar or hosting service
 +for good deals on commercial certificates.</p>
 +</div>
 +</div>
 +<div class="section" id="installation-wizard">
 +<span id="installation-wizard-label"></span><h2>Installation Wizard<a class="headerlink" href="#installation-wizard" title="Permalink to this headline">¶</a></h2>
 +<p>After restarting Apache you must complete your installation by
 +running either the graphical Installation Wizard, or on the command line with
 +the <tt class="docutils literal"><span class="pre">occ</span></tt> command. To enable this, temporarily change the ownership on your
 +ownCloud directories to your HTTP user (see <a class="reference internal" href="installation_wizard.html#strong-perms-label"><em>Setting Strong Directory Permissions</em></a> to learn
 +how to find your HTTP user):</p>
- <div class="highlight-python"><pre>chown -R www-data:www-data /var/www/owncloud/</pre>
++<div class="highlight-python"><pre>chown -R www-data:www-data /var/www/html/owncloud/</pre>
 +</div>
 +<div class="admonition note">
 +<p class="first admonition-title">Note</p>
 +<p class="last">Admins of SELinux-enabled distributions may need to write new SELinux
 +rules to complete their ownCloud installation; see
 +<a class="reference internal" href="#selinux-tips-label"><em>SELinux Configuration Tips</em></a>.</p>
 +</div>
 +<p>To use <tt class="docutils literal"><span class="pre">occ</span></tt> see <a class="reference internal" href="command_line_installation.html"><em>Installing ownCloud From the Command Line</em></a>.</p>
 +<p>To use the graphical Installation Wizard see <a class="reference internal" href="installation_wizard.html"><em>Installation Wizard</em></a>.</p>
 +<p>After your installation is complete and you can log into ownCloud, you must
 +apply strong permissions to your ownCloud directory.</p>
 +</div>
 +<div class="section" id="setting-strong-directory-permissions">
 +<span id="strong-permissions-label"></span><h2>Setting Strong Directory Permissions<a class="headerlink" href="#setting-strong-directory-permissions" title="Permalink to this headline">¶</a></h2>
 +<p>After completing installation, you must immediately set the directory
 +permissions in your ownCloud installation as strictly as possible for stronger
 +security. Please refer to <a class="reference internal" href="installation_wizard.html#strong-perms-label"><em>Setting Strong Directory Permissions</em></a>.</p>
 +</div>
 +<div class="section" id="selinux-configuration-tips">
 +<span id="selinux-tips-label"></span><h2>SELinux Configuration Tips<a class="headerlink" href="#selinux-configuration-tips" title="Permalink to this headline">¶</a></h2>
 +<p>See <a class="reference internal" href="selinux_configuration.html"><em>SELinux Configuration</em></a> for a suggested configuration for
 +SELinux-enabled distributions such as Fedora and CentOS.</p>
 +</div>
 +<div class="section" id="php-ini-configuration-notes">
 +<span id="php-ini-tips-label"></span><h2>php.ini Configuration Notes<a class="headerlink" href="#php-ini-configuration-notes" title="Permalink to this headline">¶</a></h2>
 +<p>Keep in mind that changes to <tt class="docutils literal"><span class="pre">php.ini</span></tt> may have to be done on more than one
 +ini file. This can be the case, for example, for the <tt class="docutils literal"><span class="pre">date.timezone</span></tt> setting.</p>
 +<p><strong>php.ini - used by the webserver:</strong></p>
 +<div class="highlight-python"><pre>  /etc/php5/apache2/php.ini
 +or
 +  /etc/php5/fpm/php.ini
 +or ...</pre>
 +</div>
 +<p><strong>php.ini - used by the php-cli and so by ownCloud CRON jobs:</strong></p>
 +<div class="highlight-python"><pre>/etc/php5/cli/php.ini</pre>
 +</div>
 +</div>
 +<div class="section" id="php-fpm-configuration-notes">
 +<span id="php-fpm-tips-label"></span><h2>php-fpm Configuration Notes<a class="headerlink" href="#php-fpm-configuration-notes" title="Permalink to this headline">¶</a></h2>
 +<p><strong>Security: Use at least PHP => 5.5.22 or >= 5.6.6</strong></p>
 +<p>Due to <a class="reference external" href="https://bugs.php.net/bug.php?id=64938">a bug with security implications</a>
 +in older PHP releases with the handling of XML data you are highly encouraged to run
 +at least PHP 5.5.22 or 5.6.6 when in a threaded environment.</p>
 +<p><strong>System environment variables</strong></p>
 +<p>When you are using <tt class="docutils literal"><span class="pre">php-fpm</span></tt>, system environment variables like
 +PATH, TMP or others are not automatically populated in the same way as
 +when using <tt class="docutils literal"><span class="pre">php-cli</span></tt>. A PHP call like <tt class="docutils literal"><span class="pre">getenv('PATH');</span></tt> can therefore
 +return an empty result. So you may need to manually configure environment
 +varibles in the appropropriate <tt class="docutils literal"><span class="pre">php-fpm</span></tt> ini/config file.</p>
 +<p>Here are some example root paths for these ini/config files:</p>
 +<table border="1" class="docutils">
 +<colgroup>
 +<col width="47%" />
 +<col width="53%" />
 +</colgroup>
 +<tbody valign="top">
 +<tr class="row-odd"><td>Ubuntu/Mint</td>
 +<td>CentOS/Red Hat/Fedora</td>
 +</tr>
 +<tr class="row-even"><td><tt class="docutils literal"><span class="pre">/etc/php5/fpm/</span></tt></td>
 +<td><tt class="docutils literal"><span class="pre">/etc/php-fpm.d/</span></tt></td>
 +</tr>
 +</tbody>
 +</table>
 +<p>In both examples, the ini/config file is called <tt class="docutils literal"><span class="pre">www.conf</span></tt>, and depending on
 +the distro version or customizations you have made, it may be in a subdirectory.</p>
 +<p>Usually, you will find some or all of the environment variables
 +already in the file, but commented out like this:</p>
 +<div class="highlight-python"><pre>;env[HOSTNAME] = $HOSTNAME
 +;env[PATH] = /usr/local/bin:/usr/bin:/bin
 +;env[TMP] = /tmp
 +;env[TMPDIR] = /tmp
 +;env[TEMP] = /tmp</pre>
 +</div>
 +<p>Uncomment the appropriate existing entries. Then run <tt class="docutils literal"><span class="pre">printenv</span> <span class="pre">PATH</span></tt> to
 +confirm your paths, for example:</p>
 +<div class="highlight-python"><pre>$ printenv PATH
 +/home/user/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:
 +/sbin:/bin:/</pre>
 +</div>
 +<p>If any of your system environment variables are not present in the file then
 +you must add them.</p>
 +<p>When you are using shared hosting or a control panel to manage your ownCloud VM
 +or server, the configuration files are almost certain to be located somewhere
 +else, for security and flexibility reasons, so check your documentation for the
 +correct locations.</p>
 +<p>Please keep in mind that it is possible to create different settings for
 +<tt class="docutils literal"><span class="pre">php-cli</span></tt> and <tt class="docutils literal"><span class="pre">php-fpm</span></tt>, and for different domains and Web sites.
 +The best way to check your settings is with <a class="reference internal" href="../issues/index.html#label-phpinfo"><em>PHP Version and Information</em></a>.</p>
 +<p><strong>Maximum upload size</strong></p>
 +<p>If you want to increase the maximum upload size, you will also have to modify
 +your <tt class="docutils literal"><span class="pre">php-fpm</span></tt> configuration and increase the <tt class="docutils literal"><span class="pre">upload_max_filesize</span></tt> and
 +<tt class="docutils literal"><span class="pre">post_max_size</span></tt> values. You will need to restart <tt class="docutils literal"><span class="pre">php5-fpm</span></tt> and your HTTP
 +server in order for these changes to be applied.</p>
 +<p><strong>.htaccess notes for webservers <> Apache</strong></p>
 +<p>ownCloud comes with its own <tt class="docutils literal"><span class="pre">owncloud/.htaccess</span></tt> file. <tt class="docutils literal"><span class="pre">php-fpm</span></tt> can’t
 +read PHP settings in <tt class="docutils literal"><span class="pre">.htaccess</span></tt> unless the <tt class="docutils literal"><span class="pre">htscanner</span></tt> PECL extension is
 +installed. If <tt class="docutils literal"><span class="pre">php-fpm</span></tt> is used without this PECL extension installed,
 +settings and permissions must be set in the <tt class="docutils literal"><span class="pre">owncloud/.user.ini</span></tt> file.</p>
 +</div>
 +<div class="section" id="other-web-servers">
 +<span id="other-http-servers-label"></span><h2>Other Web Servers<a class="headerlink" href="#other-web-servers" title="Permalink to this headline">¶</a></h2>
 +<p><strong>Nginx Configuration</strong></p>
 +<p>See <a class="reference internal" href="nginx_configuration.html"><em>Nginx Configuration</em></a></p>
 +<p><strong>Yaws Configuration</strong></p>
 +<p>See <a class="reference internal" href="yaws_configuration.html"><em>Yaws Configuration</em></a></p>
 +<p><strong>Hiawatha Configuration</strong></p>
 +<p>See <a class="reference internal" href="hiawatha_configuration.html"><em>Hiawatha Configuration</em></a></p>
 +</div>
 +</div>
 +
 +
 +					</div>
 +				</div>
 +			</div>
 +    
 +  </div>
 +</div>
 +  </body>
 +</html>
diff --cc core/doc/admin/release_notes.html
index 55ab919,0000000..fbf8441
mode 100644,000000..100644
--- a/core/doc/admin/release_notes.html
+++ b/core/doc/admin/release_notes.html
@@@ -1,536 -1,0 +1,537 @@@
 +
 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 +  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 +
 +
 +<html xmlns="http://www.w3.org/1999/xhtml">
 +  <head>
 +    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 +    
 +    <title>ownCloud 8.2 Release Notes — ownCloud 8.2 Server Administration Manual 8.2 documentation</title>
 +    
 +    <link rel="stylesheet" href="_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
 +    <link rel="stylesheet" href="_static/style.css" type="text/css" />
 +    <link rel="stylesheet" href="_static/bootstrap-sphinx.css" type="text/css" />
 +    
 +    <script type="text/javascript">
 +      var DOCUMENTATION_OPTIONS = {
 +        URL_ROOT:    '',
 +        VERSION:     '8.2',
 +        COLLAPSE_INDEX: false,
 +        FILE_SUFFIX: '.html',
 +        HAS_SOURCE:  true
 +      };
 +    </script>
 +    <script type="text/javascript" src="_static/jquery.js"></script>
 +    <script type="text/javascript" src="_static/underscore.js"></script>
 +    <script type="text/javascript" src="_static/doctools.js"></script>
 +    <script type="text/javascript" src="_static/bootstrap.js"></script>
 +    <link rel="top" title="ownCloud 8.2 Server Administration Manual 8.2 documentation" href="index.html" />
 +    <link rel="next" title="What’s New for Admins in ownCloud 8.2" href="whats_new_admin.html" />
 +    <link rel="prev" title="ownCloud 8.2 Server Administration Manual Introduction" href="index.html" />
 +<script type="text/javascript">
 +(function () {
 +  /**
 +   * Patch TOC list.
 +   *
 +   * Will mutate the underlying span to have a correct ul for nav.
 +   *
 +   * @param $span: Span containing nested UL's to mutate.
 +   * @param minLevel: Starting level for nested lists. (1: global, 2: local).
 +   */
 +  var patchToc = function ($ul, minLevel) {
 +    var findA;
 +
 +    // Find all a "internal" tags, traversing recursively.
 +    findA = function ($elem, level) {
 +      var level = level || 0,
 +        $items = $elem.find("> li > a.internal, > ul, > li > ul");
 +
 +      // Iterate everything in order.
 +      $items.each(function (index, item) {
 +        var $item = $(item),
 +          tag = item.tagName.toLowerCase(),
 +          pad = 15 + ((level - minLevel) * 10);
 +
 +        if (tag === 'a' && level >= minLevel) {
 +          // Add to existing padding.
 +          $item.css('padding-left', pad + "px");
 +          console.log(level, $item, 'padding-left', pad + "px");
 +        } else if (tag === 'ul') {
 +          // Recurse.
 +          findA($item, level + 1);
 +        }
 +      });
 +    };
 +
 +    console.log("HERE");
 +    findA($ul);
 +  };
 +
 +  $(document).ready(function () {
 +    // Add styling, structure to TOC's.
 +    $(".dropdown-menu").each(function () {
 +      $(this).find("ul").each(function (index, item){
 +        var $item = $(item);
 +        $item.addClass('unstyled');
 +      });
 +      $(this).find("li").each(function () {
 +        $(this).parent().append(this);
 +      });
 +    });
 +
 +    // Patch in level.
 +    patchToc($("ul.globaltoc"), 2);
 +    patchToc($("ul.localtoc"), 2);
 +
 +    // Enable dropdown.
 +    $('.dropdown-toggle').dropdown();
 +  });
 +}());
 +</script>
 +
 +  </head>
 +  <body>
 +  
 +
 +<div class="container">
 +  <div class="content">
 +    <div class="page-header">
 +      <h1><a href="contents.html">ownCloud 8.2 Server Administration Manual</a></h1>
 +
 +    </div>
 +    
 +			<div class="row">
 +				<div class="span3">
 +					<div class="sidebar">
 +						<div class="well">
 +							<div class="menu-support-container">
 +								<ul id="menu-support" class="menu">
 +									<ul>
 +										
 +<li><a href="contents.html">Table of Contents</a></li>
 +									</ul>
 +                  <ul class="current">
 +<li class="toctree-l1"><a class="reference internal" href="index.html">ownCloud 8.2 Server Administration Manual Introduction</a></li>
 +<li class="toctree-l1 current"><a class="current reference internal" href="">ownCloud 8.2 Release Notes</a><ul>
 +<li class="toctree-l2"><a class="reference internal" href="#changes-in-8-2">Changes in 8.2</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="#changes-in-8-1">Changes in 8.1</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="#enterprise-8-1-only">Enterprise 8.1 Only</a></li>
 +<li class="toctree-l2"><a class="reference internal" href="#owncloud-8-0">ownCloud 8.0</a><ul>
 +<li class="toctree-l3"><a class="reference internal" href="#manual-ldap-port-configuration">Manual LDAP Port Configuration</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#no-preview-icon-on-text-files">No Preview Icon on Text Files</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#remote-federated-cloud-share-cannot-be-reshared-with-local-users">Remote Federated Cloud Share Cannot be Reshared With Local Users</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#manually-migrate-encryption-keys-after-upgrade">Manually Migrate Encryption Keys after Upgrade</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#windows-server-not-supported">Windows Server Not Supported</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#php-5-3-support-dropped">PHP 5.3 Support Dropped</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#disable-apache-multiviews">Disable Apache Multiviews</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#owncloud-does-not-follow-symlinks">ownCloud Does Not Follow Symlinks</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#no-commas-in-group-names">No Commas in Group Names</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#hebrew-file-names-too-large-on-windows">Hebrew File Names Too Large on Windows</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#google-drive-large-files-fail-with-500-error">Google Drive Large Files Fail with 500 Error</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#encrypting-large-numbers-of-files">Encrypting Large Numbers of Files</a></li>
 +</ul>
 +</li>
 +<li class="toctree-l2"><a class="reference internal" href="#enterprise-8-0-only">Enterprise 8.0 Only</a><ul>
 +<li class="toctree-l3"><a class="reference internal" href="#sharepoint-drive-ssl-not-verified">Sharepoint Drive SSL Not Verified</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#no-federated-cloud-sharing-with-shibboleth">No Federated Cloud Sharing with Shibboleth</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#direct-uploads-to-swift-do-not-appear-in-owncloud">Direct Uploads to SWIFT do not Appear in ownCloud</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#swift-objectstore-incompatible-with-encryption-app">SWIFT Objectstore Incompatible with Encryption App</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#app-store-is-back">App Store is Back</a></li>
 +</ul>
 +</li>
 +<li class="toctree-l2"><a class="reference internal" href="#owncloud-7-release-notes">ownCloud 7 Release Notes</a><ul>
 +<li class="toctree-l3"><a class="reference internal" href="#id1">Manual LDAP Port Configuration</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#ldap-search-performance-improved">LDAP Search Performance Improved</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#protecting-owncloud-on-iis-from-data-loss">Protecting ownCloud on IIS from Data Loss</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#antivirus-app-modes">Antivirus App Modes</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#enable-only-for-specific-groups-fails">“Enable Only for Specific Groups” Fails</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#changes-to-file-previews">Changes to File Previews</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#gb-limit-on-sftp-transfers">4GB Limit on SFTP Transfers</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#not-enough-space-available-on-file-upload">“Not Enough Space Available” on File Upload</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#no-more-expiration-date-on-local-shares">No More Expiration Date On Local Shares</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#zero-quota-not-read-only">Zero Quota Not Read-Only</a></li>
 +</ul>
 +</li>
 +<li class="toctree-l2"><a class="reference internal" href="#enterprise-7-only">Enterprise 7 Only</a><ul>
 +<li class="toctree-l3"><a class="reference internal" href="#id2">No Federated Cloud Sharing with Shibboleth</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#windows-network-drive">Windows Network Drive</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#sharepoint-drive-ssl">Sharepoint Drive SSL</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#shibboleth-and-webdav-incompatible">Shibboleth and WebDAV Incompatible</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#no-sqlite">No SQLite</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#no-app-store">No App Store</a></li>
 +<li class="toctree-l3"><a class="reference internal" href="#ldap-home-connector-linux-only">LDAP Home Connector Linux Only</a></li>
 +</ul>
 +</li>
 +</ul>
 +</li>
 +<li class="toctree-l1"><a class="reference internal" href="whats_new_admin.html">What’s New for Admins in ownCloud 8.2</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="installation/index.html">Installation</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="configuration_server/index.html">ownCloud Server Configuration</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="configuration_user/index.html">User Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="configuration_files/index.html">File Sharing and Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="configuration_database/index.html">Database Configuration</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="configuration_mimetypes/index.html">Mimetypes Management</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="maintenance/index.html">Maintenance</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="operations/index.html">Operations</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="issues/index.html">Issues and Troubleshooting</a></li>
 +</ul>
 +<ul>
 +<li class="toctree-l1"><a class="reference internal" href="enterprise_installation/index.html">Enterprise Subscription Installation (ES Only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="enterprise_clients/index.html">Creating Branded ownCloud Clients (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="enterprise_server_branding/index.html">Enterprise Server Branding (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="enterprise_external_storage/index.html">External Storage (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="enterprise_user_management/index.html">User Management (ES only)</a></li>
 +<li class="toctree-l1"><a class="reference internal" href="enterprise_files_drop/index.html">Enabling Anonymous Uploads with Files Drop (ES Only)</a></li>
 +</ul>
 +
 +								</ul>
 +							</div>
 +						</div>
 +					</div>
 +				</div>
 +        
 +
 +				<div class="span9">
 +					<div class="page-content">
 +						
 +  <div class="section" id="owncloud-version-release-notes">
 +<h1>ownCloud 8.2 Release Notes<a class="headerlink" href="#owncloud-version-release-notes" title="Permalink to this headline">¶</a></h1>
 +<div class="section" id="changes-in-8-2">
 +<h2>Changes in 8.2<a class="headerlink" href="#changes-in-8-2" title="Permalink to this headline">¶</a></h2>
++<p>Home folder rule is enforced in the user_ldap application in new ownCloud installations; see <a class="reference internal" href="configuration_user/user_auth_ldap.html"><em>User Authentication with LDAP</em></a>. This affects ownCloud 8.0.10, 8.1.5 and 8.2.0 and up.</p>
 +<p>New location for Linux package repositories; ownCloud admins must manually
 +change to the new repos. See <a class="reference internal" href="maintenance/upgrade.html"><em>How to Upgrade Your ownCloud Server</em></a></p>
 +<p>PHP 5.6.11+ breaks the LDAP wizard with a ‘Could not connect to LDAP’ error. See <a class="reference external" href="https://github.com/owncloud/core/issues/20020">https://github.com/owncloud/core/issues/20020</a>.</p>
 +<p><tt class="docutils literal"><span class="pre">filesystem_check_changes</span></tt> in <tt class="docutils literal"><span class="pre">config.php</span></tt> is set to 0 by default. This
 +prevents unnecessary update checks and improves performance. If you are using
 +external storage mounts such as NFS on a remote storage server, set this to 1
 +so that ownCloud will detect remote file changes.</p>
 +<p>XSendFile support has been removed, so there is no longer support for <a class="reference external" href="https://doc.owncloud.org/server/8.1/admin_manual/configuration_files/serving_static_files_configuration.html">serving
 +static files</a> from your ownCloud server.</p>
 +<p>LDAP issue: 8.2 uses the <tt class="docutils literal"><span class="pre">memberof</span></tt> attribute by default. If this is not
 +activated on your LDAP server your user groups will not be detected, and you
 +will see this message in your ownCloud log: <tt class="docutils literal"><span class="pre">Error</span> <span class="pre">PHP</span> <span class="pre">Array</span> <span class="pre">to</span> <span class="pre">string</span>
 +<span class="pre">conversion</span> <span class="pre">at</span> <span class="pre">/var/www/html/owncloud/lib/private/template/functions.php#36</span></tt>.
 +Fix this by disabling the <tt class="docutils literal"><span class="pre">memberof</span></tt> attribute on your ownCloud server with
 +the <tt class="docutils literal"><span class="pre">occ</span></tt> command, like this example on Ubuntu Linux:</p>
 +<div class="highlight-python"><pre>sudo -u www-data php occ ldap:set-config "s01" useMemberOfToDetectMembership 0</pre>
 +</div>
 +<p>Run <tt class="docutils literal"><span class="pre">sudo</span> <span class="pre">-u</span> <span class="pre">www-data</span> <span class="pre">php</span> <span class="pre">occ</span> <span class="pre">ldap:show-config</span></tt> to find the correct <tt class="docutils literal"><span class="pre">sNN</span></tt>
 +value; if there is not one then use empty quotes, <tt class="docutils literal"><span class="pre">""</span></tt>. (See
 +<a class="reference internal" href="configuration_server/occ_command.html"><em>Using the occ Command</em></a>.)</p>
 +<p>Users of the Linux Package need to update their repository setup as described
 +in this <a class="reference external" href="https://owncloud.org/blog/upgrading-to-owncloud-server-8-2/">blogpost</a>.</p>
 +<p>The log format for failed logins to the <tt class="docutils literal"><span class="pre">owncloud.log</span></tt> has a slight syntax change.
 +If a tool relies on logging failed logins please revise its rule. For <tt class="docutils literal"><span class="pre">fail2ban</span></tt>
 +you will find an updated rule at the <a class="reference external" href="https://forum.owncloud.org/viewtopic.php?f=8&t=28678">forums</a>.</p>
 +</div>
 +<div class="section" id="changes-in-8-1">
 +<h2>Changes in 8.1<a class="headerlink" href="#changes-in-8-1" title="Permalink to this headline">¶</a></h2>
 +<p>Use APCu only if available in version 4.0.6 and higher. If you install an older version, you will see a <tt class="docutils literal"><span class="pre">APCu</span> <span class="pre">below</span> <span class="pre">version</span> <span class="pre">4.0.6</span> <span class="pre">is</span> <span class="pre">installed,</span> <span class="pre">for</span> <span class="pre">stability</span> <span class="pre">and</span> <span class="pre">performance</span> <span class="pre">reasons</span> <sp [...]
 +<p>SMB external storage now based on <tt class="docutils literal"><span class="pre">php5-libsmbclient</span></tt>, which must be downloaded
 +from the ownCloud software repositories (<a class="reference external" href="https://software.opensuse.org/download.html?project=isv%3AownCloud%3Acommunity%3A8.1&package=php5-libsmbclient">installation instructions</a>).</p>
 +<p>“Download from link” feature has been removed.</p>
 +<p>The <tt class="docutils literal"><span class="pre">.htaccess</span></tt> and <tt class="docutils literal"><span class="pre">index.html</span></tt> files in the <tt class="docutils literal"><span class="pre">data/</span></tt> directory are now
 +updated after every update. If you make any modifications to these files they
 +will be lost after updates.</p>
 +<p>The SabreDAV browser at <tt class="docutils literal"><span class="pre">/remote.php/webdav</span></tt> has been removed.</p>
 +<p>Using ownCloud without a <tt class="docutils literal"><span class="pre">trusted_domain</span></tt> configuration will not work anymore.</p>
 +<p>The logging format for failed logins has changed and considers now the proxy
 +configuration in <tt class="docutils literal"><span class="pre">config.php</span></tt>.</p>
 +<p>A default set of security and privacy HTTP headers have been added to the
 +ownCloud <tt class="docutils literal"><span class="pre">.htaccess</span></tt> file, and ownCloud administrators may now customize which
 +headers are sent.</p>
 +<p>More strict SSL certificate checking improves security but can result in
 +“cURL error 60: SSL certificate problem: unable to get local issuer certificate”
 +errors with certain broken PHP versions. Please verify your SSL setup, update your
 +PHP or contact your vendor if you receive these errors.</p>
 +<p>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
 +<a class="reference internal" href="configuration_user/user_auth_ldap.html"><em>User Authentication with LDAP</em></a>. Memory cache configuration for the
 +ownCloud server is no longer automatic, requiring installation of
 +your desired cache backend and configuration in
 +<tt class="docutils literal"><span class="pre">config.php</span></tt> (see <a class="reference internal" href="configuration_server/caching_configuration.html"><em>Configuring Memory Caching</em></a>.)</p>
 +<p>The OC_User_HTTP backend has been removed. Administrators are encouraged to use
 +the <tt class="docutils literal"><span class="pre">user_webdavauth</span></tt> application instead.</p>
 +<p>ownCloud ships now with its own root certificate bundle derived from Mozilla’s
 +root certificates file. The system root certificate bundle will not be used
 +anymore for most requests.</p>
 +<p>When you upgrade from ownCloud 8.0, with encryption enabled, to 8.1, you must
 +enable the new encryption backend and migrate your encryption keys. See
 +<a class="reference internal" href="configuration_files/encryption_configuration.html"><em>Encryption Configuration</em></a></p>
 +<p>Encryption can no longer be disabled in ownCloud 8.1. It is planned to re-add
 +this feature to the command line client for a future release.</p>
 +<p>It is not recommended to upgrade encryption-enabled systems from ownCloud Server 8.0
 +to version 8.1.0 as there is a chance the migration will break. We recommend
 +migrating to the first bugfix release, ownCloud Server 8.1.1.</p>
 +<p>Due to various technical issues, by default desktop sync clients older than
 +1.7 are not allowed to connect and sync with the ownCloud server. This is
 +configurable via the <tt class="docutils literal"><span class="pre">minimum.supported.desktop.version</span></tt> switch in
 +<tt class="docutils literal"><span class="pre">config.php</span></tt>.</p>
 +<p>Previews are now generated at a maximum size of 2048 x 2048 pixels. This is configurable
 +via the <tt class="docutils literal"><span class="pre">preview_max_x</span></tt> and <tt class="docutils literal"><span class="pre">preview_max_y</span></tt> switches in <tt class="docutils literal"><span class="pre">config.php</span></tt>.</p>
 +<p>The ownCloud 8 server is not supported on any version of Windows.</p>
 +<p>The 8.1.0 release has a minor bug which makes app updates fail at first try. Reload the
 +apps page and try again, and the update will succeed.</p>
 +<p>The <tt class="docutils literal"><span class="pre">forcessl</span></tt> option within the <tt class="docutils literal"><span class="pre">config.php</span></tt> and the <tt class="docutils literal"><span class="pre">Enforce</span> <span class="pre">SSL</span></tt> option
 +within the Admin-Backend was removed. This now needs to be configured like
 +described in <a class="reference internal" href="configuration_server/harden_server.html#use-https-label"><em>Use HTTPS</em></a>.</p>
 +<p>WebDAV file locking was removed in oC 8.1 which causes Finder on Mac OS X to mount WebDAV read-only.</p>
 +</div>
 +<div class="section" id="enterprise-8-1-only">
 +<h2>Enterprise 8.1 Only<a class="headerlink" href="#enterprise-8-1-only" title="Permalink to this headline">¶</a></h2>
 +<p>The SharePoint Drive app does not verify the SSL certificate of the SharePoint
 +server or the ownCloud server, as it is expected that both devices are in the
 +same trusted environment.</p>
 +</div>
 +<div class="section" id="owncloud-8-0">
 +<h2>ownCloud 8.0<a class="headerlink" href="#owncloud-8-0" title="Permalink to this headline">¶</a></h2>
 +<div class="section" id="manual-ldap-port-configuration">
 +<h3>Manual LDAP Port Configuration<a class="headerlink" href="#manual-ldap-port-configuration" title="Permalink to this headline">¶</a></h3>
 +<p>When you are configuring the LDAP user and group backend application, ownCloud
 +may not auto-detect the LDAP server’s port number, so you will need to enter it
 +manually.</p>
 +</div>
 +<div class="section" id="no-preview-icon-on-text-files">
 +<h3>No Preview Icon on Text Files<a class="headerlink" href="#no-preview-icon-on-text-files" title="Permalink to this headline">¶</a></h3>
 +<p>There is no preview icon displayed for text files when the file contains fewer than six characters.</p>
 +</div>
 +<div class="section" id="remote-federated-cloud-share-cannot-be-reshared-with-local-users">
 +<h3>Remote Federated Cloud Share Cannot be Reshared With Local Users<a class="headerlink" href="#remote-federated-cloud-share-cannot-be-reshared-with-local-users" title="Permalink to this headline">¶</a></h3>
 +<p>When you mount a Federated Cloud share from a remote ownCloud server, you cannot re-share it with your local ownCloud users. (See <a class="reference internal" href="configuration_files/federated_cloud_sharing_configuration.html"><em>Configuring Federated Cloud Sharing</em></a> to learn more about federated cloud sharing)</p>
 +</div>
 +<div class="section" id="manually-migrate-encryption-keys-after-upgrade">
 +<h3>Manually Migrate Encryption Keys after Upgrade<a class="headerlink" href="#manually-migrate-encryption-keys-after-upgrade" title="Permalink to this headline">¶</a></h3>
 +<p>If you are using the Encryption app and upgrading from older versions of
 +ownCloud to ownCloud 8.0, you must manually migrate your encryption keys with
 +the <em>occ</em> command after the upgrade is complete, like this example for CentOS:
 +<em>sudo -u apache php occ encryption:migrate</em> You must run <em>occ</em> as your HTTP
 +user. See <a class="reference internal" href="configuration_server/occ_command.html"><em>Using the occ Command</em></a> to learn more about <em>occ</em></p>
 +</div>
 +<div class="section" id="windows-server-not-supported">
 +<h3>Windows Server Not Supported<a class="headerlink" href="#windows-server-not-supported" title="Permalink to this headline">¶</a></h3>
 +<p>Windows Server is not supported in ownCloud 8.</p>
 +</div>
 +<div class="section" id="php-5-3-support-dropped">
 +<h3>PHP 5.3 Support Dropped<a class="headerlink" href="#php-5-3-support-dropped" title="Permalink to this headline">¶</a></h3>
 +<p>PHP 5.3 is not supported in ownCloud 8, and PHP 5.4 or better is required.</p>
 +</div>
 +<div class="section" id="disable-apache-multiviews">
 +<h3>Disable Apache Multiviews<a class="headerlink" href="#disable-apache-multiviews" title="Permalink to this headline">¶</a></h3>
 +<p>If Multiviews are enabled in your Apache configuration, this may cause problems
 +with content negotiation, so disable Multiviews by removing it from your Apache
 +configuration. Look for lines like this:</p>
 +<div class="highlight-python"><pre><Directory /var/www/owncloud>
 +Options Indexes FollowSymLinks Multiviews</pre>
 +</div>
 +<p>Delete <tt class="docutils literal"><span class="pre">Multiviews</span></tt> and restart Apache.</p>
 +</div>
 +<div class="section" id="owncloud-does-not-follow-symlinks">
 +<h3>ownCloud Does Not Follow Symlinks<a class="headerlink" href="#owncloud-does-not-follow-symlinks" title="Permalink to this headline">¶</a></h3>
 +<p>ownCloud’s file scanner does not follow symlinks, which could lead to
 +infinite loops. To avoid this do not use soft or hard links in your ownCloud
 +data directory.</p>
 +</div>
 +<div class="section" id="no-commas-in-group-names">
 +<h3>No Commas in Group Names<a class="headerlink" href="#no-commas-in-group-names" title="Permalink to this headline">¶</a></h3>
 +<p>Creating an ownCloud group with a comma in the group name causes ownCloud to
 +treat the group as two groups.</p>
 +</div>
 +<div class="section" id="hebrew-file-names-too-large-on-windows">
 +<h3>Hebrew File Names Too Large on Windows<a class="headerlink" href="#hebrew-file-names-too-large-on-windows" title="Permalink to this headline">¶</a></h3>
 +<p>On Windows servers Hebrew file names grow to five times their original size
 +after being translated to Unicode.</p>
 +</div>
 +<div class="section" id="google-drive-large-files-fail-with-500-error">
 +<h3>Google Drive Large Files Fail with 500 Error<a class="headerlink" href="#google-drive-large-files-fail-with-500-error" title="Permalink to this headline">¶</a></h3>
 +<p>Google Drive tries to download the entire file into memory, then write it to a
 +temp file, and then stream it to the client, so very large file downloads from
 +Google Drive may fail with a 500 internal server error.</p>
 +</div>
 +<div class="section" id="encrypting-large-numbers-of-files">
 +<h3>Encrypting Large Numbers of Files<a class="headerlink" href="#encrypting-large-numbers-of-files" title="Permalink to this headline">¶</a></h3>
 +<p>When you activate the Encryption app on a running server that has large numbers
 +of files, it is possible that you will experience timeouts. It is best to
 +activate encryption at installation, before accumulating large numbers of files
 +on your ownCloud server.</p>
 +</div>
 +</div>
 +<div class="section" id="enterprise-8-0-only">
 +<h2>Enterprise 8.0 Only<a class="headerlink" href="#enterprise-8-0-only" title="Permalink to this headline">¶</a></h2>
 +<div class="section" id="sharepoint-drive-ssl-not-verified">
 +<h3>Sharepoint Drive SSL Not Verified<a class="headerlink" href="#sharepoint-drive-ssl-not-verified" title="Permalink to this headline">¶</a></h3>
 +<p>The SharePoint Drive app does not verify the SSL certificate of the SharePoint
 +server or the ownCloud server, as it is expected that both devices are in the
 +same trusted environment.</p>
 +</div>
 +<div class="section" id="no-federated-cloud-sharing-with-shibboleth">
 +<h3>No Federated Cloud Sharing with Shibboleth<a class="headerlink" href="#no-federated-cloud-sharing-with-shibboleth" title="Permalink to this headline">¶</a></h3>
 +<p>Federated Cloud Sharing (formerly Server-to-Server file sharing)does not work
 +with Shibboleth .</p>
 +</div>
 +<div class="section" id="direct-uploads-to-swift-do-not-appear-in-owncloud">
 +<h3>Direct Uploads to SWIFT do not Appear in ownCloud<a class="headerlink" href="#direct-uploads-to-swift-do-not-appear-in-owncloud" title="Permalink to this headline">¶</a></h3>
 +<p>When files are uploaded directly to a SWIFT share mounted as external storage
 +in ownCloud, the files do not appear in ownCloud. However, files uploaded to
 +the SWIFT mount through ownCloud are listed correctly in both locations.</p>
 +</div>
 +<div class="section" id="swift-objectstore-incompatible-with-encryption-app">
 +<h3>SWIFT Objectstore Incompatible with Encryption App<a class="headerlink" href="#swift-objectstore-incompatible-with-encryption-app" title="Permalink to this headline">¶</a></h3>
 +<p>The current SWIFT implementation is incompatible with any app that uses direct
 +file I/O and circumvents the ownCloud virtual filesystem. Using the Encryption
 +app on a SWIFT object store incurs twice as many HTTP requests and increases
 +latency significantly.</p>
 +</div>
 +<div class="section" id="app-store-is-back">
 +<h3>App Store is Back<a class="headerlink" href="#app-store-is-back" title="Permalink to this headline">¶</a></h3>
 +<p>The ownCloud App Store has been re-enabled in oC 8. Note that third-party apps
 +are not supported.</p>
 +</div>
 +</div>
 +<div class="section" id="owncloud-7-release-notes">
 +<h2>ownCloud 7 Release Notes<a class="headerlink" href="#owncloud-7-release-notes" title="Permalink to this headline">¶</a></h2>
 +<div class="section" id="id1">
 +<h3>Manual LDAP Port Configuration<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
 +<p>When you are configuring the LDAP user and group backend application, ownCloud
 +may not auto-detect the LDAP server’s port number, so you will need to enter it
 +manually.</p>
 +</div>
 +<div class="section" id="ldap-search-performance-improved">
 +<h3>LDAP Search Performance Improved<a class="headerlink" href="#ldap-search-performance-improved" title="Permalink to this headline">¶</a></h3>
 +<p>Prior to 7.0.4, LDAP searches were substring-based and would match search
 +attributes if the substring occurred anywhere in the attribute value. Rather,
 +searches are performed on beginning attributes. With 7.0.4, searches will match
 +at the beginning of the attribute value only. This provides better performance
 +and a better user experience.</p>
 +<p>Substring searches can still be performed by prepending the search term with
 +“*”.For example, a search for <tt class="docutils literal"><span class="pre">te</span></tt> will find Terri, but not Nate:</p>
 +<div class="highlight-python"><pre>occ ldap:search "te"</pre>
 +</div>
 +<p>If you want to broaden the search to include
 +Nate, then search for <tt class="docutils literal"><span class="pre">*te</span></tt>:</p>
 +<div class="highlight-python"><pre>occ ldap:search "*te"</pre>
 +</div>
 +<p>Refine searches by adjusting your search attributes in the <tt class="docutils literal"><span class="pre">User</span> <span class="pre">Search</span>
 +<span class="pre">Attributes</span></tt> form in your LDAP configuration on the Admin page. For example, if
 +your search attributes are <tt class="docutils literal"><span class="pre">givenName</span></tt> and <tt class="docutils literal"><span class="pre">sn</span></tt> you can find users by first
 +name + last name very quickly. For example, you’ll find Terri Hanson by
 +searching for <tt class="docutils literal"><span class="pre">te</span> <span class="pre">ha</span></tt>. Trailing whitespaces are ignored.</p>
 +</div>
 +<div class="section" id="protecting-owncloud-on-iis-from-data-loss">
 +<h3>Protecting ownCloud on IIS from Data Loss<a class="headerlink" href="#protecting-owncloud-on-iis-from-data-loss" title="Permalink to this headline">¶</a></h3>
 +<p>Under certain circumstances, running your ownCloud server on IIS could be at
 +risk of data loss. To prevent this, follow these steps.</p>
 +<p>In your ownCloud server configuration file, <tt class="docutils literal"><span class="pre">owncloud\config\config.php</span></tt>, set
 +<tt class="docutils literal"><span class="pre">config_is_read_only</span></tt> to true.</p>
 +<p>Set the <tt class="docutils literal"><span class="pre">config.php</span></tt> file to read-only.</p>
 +<p>When you make server updates <tt class="docutils literal"><span class="pre">config.php</span></tt> must be made writeable. When your
 +updates are completed re-set it to read-only.</p>
 +</div>
 +<div class="section" id="antivirus-app-modes">
 +<h3>Antivirus App Modes<a class="headerlink" href="#antivirus-app-modes" title="Permalink to this headline">¶</a></h3>
 +<p>The Antivirus App offers three modes for running the ClamAV anti-virus scanner:
 +as a daemon on the ownCloud server, a daemon on a remote server, or an
 +executable mode that calls <tt class="docutils literal"><span class="pre">clamscan</span></tt> on the local server. We recommend using
 +one of the daemon modes, as they are the most reliable.</p>
 +</div>
 +<div class="section" id="enable-only-for-specific-groups-fails">
 +<h3>“Enable Only for Specific Groups” Fails<a class="headerlink" href="#enable-only-for-specific-groups-fails" title="Permalink to this headline">¶</a></h3>
 +<p>Some ownCloud applications have the option to be enabled only for certain
 +groups. However, when you select specific groups they do not get access to the
 +app.</p>
 +</div>
 +<div class="section" id="changes-to-file-previews">
 +<h3>Changes to File Previews<a class="headerlink" href="#changes-to-file-previews" title="Permalink to this headline">¶</a></h3>
 +<p>For security and performance reasons, file previews are available only for
 +image files, covers of MP3 files, and text files, and have been disabled for
 +all other filetypes. Files without previews are represented by generic icons
 +according to their file types.</p>
 +</div>
 +<div class="section" id="gb-limit-on-sftp-transfers">
 +<h3>4GB Limit on SFTP Transfers<a class="headerlink" href="#gb-limit-on-sftp-transfers" title="Permalink to this headline">¶</a></h3>
 +<p>Because of limitations in <tt class="docutils literal"><span class="pre">phpseclib</span></tt>, you cannot upload files larger than
 +4GB over SFTP.</p>
 +</div>
 +<div class="section" id="not-enough-space-available-on-file-upload">
 +<h3>“Not Enough Space Available” on File Upload<a class="headerlink" href="#not-enough-space-available-on-file-upload" title="Permalink to this headline">¶</a></h3>
 +<p>Setting user quotas to <tt class="docutils literal"><span class="pre">unlimited</span></tt> on an ownCloud installation that has
 +unreliable free disk space reporting– for example, on a shared hosting
 +provider– may cause file uploads to fail with a “Not Enough Space Available”
 +error. A workaround is to set file quotas for all users instead of
 +<tt class="docutils literal"><span class="pre">unlimited</span></tt>.</p>
 +</div>
 +<div class="section" id="no-more-expiration-date-on-local-shares">
 +<h3>No More Expiration Date On Local Shares<a class="headerlink" href="#no-more-expiration-date-on-local-shares" title="Permalink to this headline">¶</a></h3>
 +<p>In older versions of ownCloud, you could set an expiration date on both local
 +and public shares. Now you can set an expiration date only on public shares,
 +and
 +local shares do not expire when public shares expire.</p>
 +</div>
 +<div class="section" id="zero-quota-not-read-only">
 +<h3>Zero Quota Not Read-Only<a class="headerlink" href="#zero-quota-not-read-only" title="Permalink to this headline">¶</a></h3>
 +<p>Setting a user’s storage quota should be the equivalent of read-only, however,
 +users can
 +still create empty files.</p>
 +</div>
 +</div>
 +<div class="section" id="enterprise-7-only">
 +<h2>Enterprise 7 Only<a class="headerlink" href="#enterprise-7-only" title="Permalink to this headline">¶</a></h2>
 +<div class="section" id="id2">
 +<h3>No Federated Cloud Sharing with Shibboleth<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
 +<p>Federated Cloud Sharing (formerly Server-to-Server file sharing) does not work
 +with Shibboleth .</p>
 +</div>
 +<div class="section" id="windows-network-drive">
 +<h3>Windows Network Drive<a class="headerlink" href="#windows-network-drive" title="Permalink to this headline">¶</a></h3>
 +<p>Windows Network Drive runs only on Linux servers because it requires the Samba
 +client, which is included in all Linux distributions.</p>
 +<p><tt class="docutils literal"><span class="pre">php5-libsmbclient</span></tt> is also required, and there may be issues with older
 +versions of <tt class="docutils literal"><span class="pre">libsmbclient</span></tt>; see Using External Storage > Installing and
 +Configuring the Windows Network Drive App in the Enterprise Admin manual for
 +more information.</p>
 +<p>By default CentOS has activated SELinux, and the <tt class="docutils literal"><span class="pre">httpd</span></tt> process can not make
 +outgoing network connections. This will cause problems with curl, ldap and samba
 +libraries. Again, see Using External Storage > Installing and Configuring the
 +Windows Network Drive App in the Enterprise Admin manual for instructions.</p>
 +</div>
 +<div class="section" id="sharepoint-drive-ssl">
 +<h3>Sharepoint Drive SSL<a class="headerlink" href="#sharepoint-drive-ssl" title="Permalink to this headline">¶</a></h3>
 +<p>The SharePoint Drive app does not verify the SSL certificate of the SharePoint
 +server or the ownCloud server, as it is expected that both devices are in the
 +same trusted environment.</p>
 +</div>
 +<div class="section" id="shibboleth-and-webdav-incompatible">
 +<h3>Shibboleth and WebDAV Incompatible<a class="headerlink" href="#shibboleth-and-webdav-incompatible" title="Permalink to this headline">¶</a></h3>
 +<p>Shibboleth and standard WebDAV are incompatible, and cannot be used together in
 +ownCloud. If Shibboleth is enabled, the ownCloud client uses an extended WebDAV
 +protocol</p>
 +</div>
 +<div class="section" id="no-sqlite">
 +<h3>No SQLite<a class="headerlink" href="#no-sqlite" title="Permalink to this headline">¶</a></h3>
 +<p>SQLite is no longer an installation option for ownCloud Enterprise Edition, as
 +it not suitable for multiple-user installations or managing large numbers of
 +files.</p>
 +</div>
 +<div class="section" id="no-app-store">
 +<h3>No App Store<a class="headerlink" href="#no-app-store" title="Permalink to this headline">¶</a></h3>
 +<p>The App Store is disabled for the Enterprise Edition.</p>
 +</div>
 +<div class="section" id="ldap-home-connector-linux-only">
 +<h3>LDAP Home Connector Linux Only<a class="headerlink" href="#ldap-home-connector-linux-only" title="Permalink to this headline">¶</a></h3>
 +<p>The LDAP Home Connector application requires Linux (with MySQL, MariaDB,
 +or PostgreSQL) to operate correctly.</p>
 +</div>
 +</div>
 +</div>
 +
 +
 +					</div>
 +				</div>
 +			</div>
 +    
 +  </div>
 +</div>
 +  </body>
 +</html>
diff --cc version.php
index 3848ab8,372209f..2ba5846
--- a/version.php
+++ b/version.php
@@@ -1,7 -1,40 +1,7 @@@
 -<?php
 -/**
 - * @author C Montero-Luque <cml at owncloud.com>
 - * @author Frank Karlitschek <frank at owncloud.org>
 - * @author Lukas Reschke <lukas at owncloud.com>
 - * @author Roeland Jago Douma <roeland at famdouma.nl>
 - * @author Vincent Petry <pvince81 at owncloud.com>
 - *
 - * @copyright Copyright (c) 2015, ownCloud, Inc.
 - * @license AGPL-3.0
 - *
 - * This code is free software: you can redistribute it and/or modify
 - * it under the terms of the GNU Affero General Public License, version 3,
 - * as published by the Free Software Foundation.
 - *
 - * This program is distributed in the hope that it will be useful,
 - * but WITHOUT ANY WARRANTY; without even the implied warranty of
 - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 - * GNU Affero General Public License for more details.
 - *
 - * You should have received a copy of the GNU Affero General Public License, version 3,
 - * along with this program.  If not, see <http://www.gnu.org/licenses/>
 - *
 - */
 -// We only can count up. The 4. digit is only for the internal patchlevel to trigger DB upgrades
 -// between betas, final and RCs. This is _not_ the public version number. Reset minor/patchlevel
 -// when updating major/minor version number.
 -$OC_Version = array(8, 2, 2, 2);
 -
 -// The human readable string
 +<?php 
- $OC_Version = array(8,2,2,0);
- $OC_VersionString = '8.2.2 RC1';
++$OC_Version = array(8,2,2,2);
+ $OC_VersionString = '8.2.2';
 -
 -$OC_VersionCanBeUpgradedFrom = array(8, 1);
 -
 -// The ownCloud channel
 -$OC_Channel = 'git';
 -
 -// The build number
 -$OC_Build = '';
 -
 +$OC_Edition = '';
- $OC_Channel = 'testing';
++$OC_Channel = 'stable';
 +$OC_VersionCanBeUpgradedFrom = array(8,1);
- $OC_Build = '2015-12-15T22:03:18+00:00 f152228f4cfe9510badb5c27d75d1118b9979aab';
++$OC_Build = '2015-12-21T12:52:55+00:00 d60d903e75296950a52a0e25c7cd31f5b55ab68f';

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



More information about the Pkg-owncloud-commits mailing list