Skip to main content

vserver services name-service cache unix-user settings modify

Contributors
Suggest changes

Modify UNIX users 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-user settings modify command modifies the users cache configuration of the specified Vserver.

Parameters

-vserver <vserver name> - Vserver (privilege: advanced)

Use this parameter to specify the Vserver for which the users 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 users database.The value true means the cache is enabled and the value false means the cache is disabled. The default value for this parameter is true .

[-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 users database and the look-up fails. The default value for this parameter is true . Negative cache is disabled by default if the parameter is-enabled is set to false .

[-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 users database and the look-up 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 users entries need to be propagated to the users by id cache. The default value is true . Specify false to disable propagation.

Examples

The following example modifies the users cache configuration settings for Vserver vs0:

cluster1::> vserver services name-service cache unix-user 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-user settings modify -vserver vs0 -is-enabled false