From 3363b31b1d0eff6956ada796f265ff42a8daeafd Mon Sep 17 00:00:00 2001 From: Andreas Dilger Date: Thu, 17 Dec 2020 19:13:12 -0700 Subject: [PATCH] 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 --- LustreProgrammingInterfaces.xml | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) 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 + + -- 1.8.3.1