[Pkg-owncloud-commits] [owncloud-doc] 83/110: Add new page on LDAP User Cleanup

Fri Feb 6 21:10:38 UTC 2015

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

taffit pushed a commit to branch master
in repository owncloud-doc.

commit f2007d188f0546a2c253a827a14e8f059f9e2c82
Author: Carla Schroder <carla at owncloud.com>
Date:   Wed Jan 21 14:26:41 2015 -0800

    Add new page on LDAP User Cleanup
---
 admin_manual/configuration/index.rst               |  1 +
 .../configuration/user_auth_ldap_cleanup.rst       | 75 ++++++++++++++++++++++
 admin_manual/index.rst                             |  1 +
 user_manual/contents.rst                           |  4 +-
 user_manual/index.rst                              | 11 +---
 5 files changed, 79 insertions(+), 13 deletions(-)

diff --git a/admin_manual/configuration/index.rst b/admin_manual/configuration/index.rst
index 8435b39..1930281 100644
--- a/admin_manual/configuration/index.rst
+++ b/admin_manual/configuration/index.rst
@@ -32,5 +32,6 @@ Configuration
    thirdparty_php_configuration
    user_auth_ftp_smb_imap
    user_auth_ldap
+   user_auth_ldap_cleanup
    user_configuration
    reset_admin_password
\ No newline at end of file
diff --git a/admin_manual/configuration/user_auth_ldap_cleanup.rst b/admin_manual/configuration/user_auth_ldap_cleanup.rst
new file mode 100644
index 0000000..14a4889
--- /dev/null
+++ b/admin_manual/configuration/user_auth_ldap_cleanup.rst
@@ -0,0 +1,75 @@
+=================
+LDAP User Cleanup
+=================
+
+LDAP User Cleanup is a new feature in the ``LDAP user and group backend`` 
+application. LDAP User Cleanup is a background process that automatically 
+searches the ownCloud LDAP mappings table, and verifies if the LDAP users are 
+still available. Any users that are not available are marked as ``deleted`` in 
+the ``oc_preferences`` database table. Then you can run a command to display 
+this table, displaying only the users marked as ``deleted``, and then you have 
+the option of removing their data from your ownCloud data directory.
+
+These items are removed upon cleanup:
+
+* Local ownCloud group assignments
+* User preferences (DB table ``oc_preferences``)
+* User's ownCloud home folder
+* User's corresponding entry in ``oc_storages``
+
+There are two prequisites for LDAP User Cleanup to operate:
+
+1. Set ``ldapUserCleanupInterval`` in ``config.php`` to your desired check 
+   interval in minutes. The default is 51 minutes.
+
+2. All configured LDAP connections are enabled and operating correctly. As users 
+   can exist on multiple LDAP servers, you want to be sure that all of your 
+   LDAP servers are available so that a user on a temporarily disconnected LDAP 
+   server is not marked as ``deleted``.
+   
+The background process examines 50 users at a time, and runs at the interval you 
+configured with ``ldapUserCleanupInterval``. For example, if you have 200 LDAP 
+users and your ``ldapUserCleanupInterval`` is 20 minutes, the process will 
+examine the first 50 users, then 20 minutes later the next 50 users, and 20 
+minutes later the next 50, and so on.
+
+You have two commands to use:
+
+1. ``occ ldap:show-remnants`` displays a table with all users that have been 
+   marked as deleted, and their LDAP data.
+
+2. ``occ user:delete [user]`` removes the user's data from the ownCloud data directory.
+
+The ``occ`` command is in your ownCloud directory, for example 
+``/var/www/owncloud/occ``. This example shows what the table of users marked as 
+``deleted`` looks like, and it assumes you have changed to the directory that 
+``occ`` is in::
+
+ # ./occ ldap:show-remnants
+ +-----------------+-----------------+------------------+--------------------------------------+
+ | ownCloud name   | Display Name    | LDAP UID         | LDAP DN                              |
+ +-----------------+-----------------+------------------+--------------------------------------+
+ | aaliyah_brown   | aaliyah brown   | aaliyah_brown    | uid=aaliyah_brown,ou=people,dc=com   |
+ | aaliyah_hammes  | aaliyah hammes  | aaliyah_hammes   | uid=aaliyah_hammes,ou=people,dc=com  |
+ | aaliyah_johnston| aaliyah johnston| aaliyah_johnston | uid=aaliyah_johnston,ou=people,dc=com|
+ | aaliyah_kunze   | aaliyah kunze   | aaliyah_kunze    | uid=aaliyah_kunze,ou=people,dc=com   |
+ +-----------------+-----------------+------------------+--------------------------------------+
+
+Then you can run ``occ user:delete aaliyah_brown`` to delete user 
+aaliyah_brown. You must use the ownCloud name.
+
+Deleting Local ownCloud Users
+-----------------------------
+
+You may also use ``occ user:delete [user]`` to remove a local ownCloud user; 
+this removes their user account and their data.
+
+Using the occ Command
+---------------------
+
+To learn more about ``occ``, see :doc:`occ_command`.
+ 
+
+
+
+
diff --git a/admin_manual/index.rst b/admin_manual/index.rst
index 800f021..4f5822b 100644
--- a/admin_manual/index.rst
+++ b/admin_manual/index.rst
@@ -92,6 +92,7 @@ contains the following topics:
 * :doc:`configuration/thirdparty_php_configuration`
 * :doc:`configuration/user_auth_ftp_smb_imap`
 * :doc:`configuration/user_auth_ldap`
+* :doc:`configuration/user_auth_ldap_cleanup`
 * :doc:`configuration/user_configuration`
 * :doc:`configuration/reset_admin_password`
 
diff --git a/user_manual/contents.rst b/user_manual/contents.rst
index 5a80663..adf9872 100644
--- a/user_manual/contents.rst
+++ b/user_manual/contents.rst
@@ -19,6 +19,4 @@ ownCloud User Manual
     documents
     bookmarks
     userpreferences
-    external_storage/google_drive
-    android/android_app
-    ios/ios_app
\ No newline at end of file
+    external_storage/google_drive
\ No newline at end of file
diff --git a/user_manual/index.rst b/user_manual/index.rst
index c3f2996..fbd96f8 100644
--- a/user_manual/index.rst
+++ b/user_manual/index.rst
@@ -29,18 +29,9 @@ solution. After all, with ownCloud, it’s Your Cloud, Your Data, Your Way.
 
 Web Interface and Mobile Apps
 =============================
-How to access ownCloud from a web browser and from the ownCloud Android and iOS 
-apps.
+How to access ownCloud from a Web browser.
 
 * :doc:`webinterface`
-* :doc:`android/android_app`
-* :doc:`ios/ios_app`
-
-Mobile Apps
-===========
-How to access ownCloud from a Android device.
-
-* :doc:`android/android_app`
 
 File Access and Management
 ==========================

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

