Skip to content

Commit 1b4a6c1

Browse files
committed
docs: replace removed updateAttributesInterval with current sync behavior
The updateAttributesInterval occ config key was removed in NC20 via the RemoveRefreshTime migration (nextcloud/server#22583). The background sync interval is now auto-calculated in Jobs/Sync.php based on the number of mapped users and the minimum paging size, clamped to 30 min–12 h, targeting one full sync per day. Replace the stale "Attribute update interval" section (which still referenced the removed occ command) with an accurate description of the current auto-calculated behavior. Fixes #11088 Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
1 parent fdf5de2 commit 1b4a6c1

1 file changed

Lines changed: 9 additions & 18 deletions

File tree

admin_manual/configuration_user/user_auth_ldap.rst

Lines changed: 9 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -645,26 +645,17 @@ Additional configuration options via occ
645645

646646
Few configuration settings can only be set on command line via ``occ``.
647647

648-
Attribute update interval
649-
^^^^^^^^^^^^^^^^^^^^^^^^^
648+
Background sync interval
649+
^^^^^^^^^^^^^^^^^^^^^^^^
650650

651-
The LDAP backend will update user information that is used within Nextcloud
652-
with the values provided by the LDAP server. For instance these are email,
653-
quota or the avatar. This happens on every login, the first detection of a user
654-
from LDAP and regularly by a background job.
651+
The LDAP backend updates user attributes (email, quota, avatar, and others) on
652+
every login, on first detection of a new user, and periodically via a background
653+
job.
655654

656-
The interval value determines the time between updates of the values and is
657-
used to avoid frequent overhead, including time-expensive write actions to
658-
the database.
659-
660-
The interval is described in seconds and it defaults to 86400 equalling a day.
661-
It is not a per-configuration option.
662-
663-
The value can be modified by::
664-
665-
sudo -E -u www-data php occ config:app:set user_ldap updateAttributesInterval --value=86400
666-
667-
A value of 0 will update it on every of the named occasions.
655+
The background job recalculates its run interval after each cycle. The goal is
656+
to process every known LDAP user approximately once per day. The interval is
657+
derived from the total number of mapped users and the smallest configured LDAP
658+
paging size, then clamped to a minimum of 30 minutes and a maximum of 12 hours.
668659

669660
Administrative Group mapping
670661
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

0 commit comments

Comments
 (0)