vserver services name-service cache unix-group settings modify
Modify UNIX Group Cache Configuration
Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.
Description
The vserver services name-service cache unix-group settings modify
command modifies the groups cache configuration of the specified Vserver.
Parameters
-vserver <vserver name>
- Vserver (privilege: advanced)-
Use this parameter to specify the Vserver for which the groups cache settings need to be modified.
[-is-enabled {true|false}]
- Is Cache Enabled? (privilege: advanced)-
Use this parameter to specify if the cache needs to be enabled for the groups database. The value
true
means the cache is enabled and the valuefalse
means the cache is disabled. The default value for this parameter istrue
. [-is-negative-cache-enabled {true|false}]
- Is Negative Cache Enabled? (privilege: advanced)-
Use this parameter to specify if the cache needs to be enabled for the negative entries. Negative entries means the entries which are not present in the groups database and the lookup fails. The default value for this parameter is
true
. Negative cache is disabled by default if the parameteris-enabled
is set tofalse
. [-ttl <[<integer>d][<integer>h][<integer>m][<integer>s]>]
- Time to Live (privilege: advanced)-
Use this parameter to specify the time(in hours, minutes and seconds) for which the positive entries need to be cached. The positive entries means the entries which are present in the groups database and the lookup succeeds. The default value is 24 hours.
[-negative-ttl <[<integer>d][<integer>h][<integer>m][<integer>s]>]
- Negative Time to Live (privilege: advanced)-
Use this parameter to specify the time(in hours, minutes and seconds) for which the negative entries need to be cached. The default value is 5 minutes.
[-is-propagation-enabled {true|false}]
- Is Propagation Enabled? (privilege: advanced)-
Use this parameter to specify whether the cached groups entries need to be propagated to the group by the group identifier or GID cache. The default value is
true
. Specifyfalse
to disable propagation.
Examples
The following example modifies the groups cache configuration settings for Vserver vs0:
cluster1::> vserver services name-service cache unix-group settings modify -vserver vs0 -ttl 600 -negative-ttl 300
The following example disables the cache for Vserver vs0:
cluster1::> vserver services name-service cache unix-group settings modify -vserver vs0 -is-enabled false