[Pkg-owncloud-commits] [owncloud-doc] 83/110: Add new page on LDAP User Cleanup
David Prévot
taffit at moszumanska.debian.org
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
More information about the Pkg-owncloud-commits
mailing list