From: Andreas Dilger Date: Fri, 18 Dec 2020 02:13:12 +0000 (-0700) Subject: LUDOC-484 misc: add identity_flush documentation X-Git-Url: https://git.whamcloud.com/?a=commitdiff_plain;h=3363b31b1d0eff6956ada796f265ff42a8daeafd;p=doc%2Fmanual.git LUDOC-484 misc: add identity_flush documentation Add a description of the mdt.*.identity_flush parameter. Signed-off-by: Andreas Dilger Change-Id: I92b72e6a06bc0e31c2e27fa05aeec67b9c3ebbe5 Reviewed-on: https://review.whamcloud.com/41040 Tested-by: jenkins --- diff --git a/LustreProgrammingInterfaces.xml b/LustreProgrammingInterfaces.xml index 3bb2065..cb72cf0 100644 --- a/LustreProgrammingInterfaces.xml +++ b/LustreProgrammingInterfaces.xml @@ -84,7 +84,7 @@ to complete, to avoid MDS threads and clients hanging due to errors accessing a remote service node. The upcall must finish within 30s before the MDS will continue without the supplementary - data. The upcall timeout can be set on the MDS using: + data. The upcall timeout in seconds can be set on the MDS using: lctl set_param mdt.*.identity_acquire_expire=seconds @@ -98,9 +98,19 @@ The group downcall data is cached by the kernel to avoid repeated upcalls for the same user slowing down the MDS. This cache is expired from the kernel after 1200s (20 minutes) by - default. The cache age can be set on the MDS using: + default. The cache age in seconds can be set on the MDS using: lctl set_param mdt.*.identity_expire=seconds + + To force eviction of cached identity data (e.g. after adding + or removing a user from a supplementary group), the cache entry + for a specific numeric UID can be flushed on the MDS using: + lctl set_param mdt.*.identity_flush=UID + To flush the cached records for all users from cache, use + -1 for the UID: + lctl set_param mdt.*.identity_flush=-1 + +