Skip to main content

vserver cifs cache settings modify

Contributors
Suggest changes

Modify CIFS Cache Configuration

Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

Description

The vserver cifs cache settings modify command modifies the Windows users cache configuration of the specified Vserver.

Parameters

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

Use this parameter to specify the Vserver for which the Windows 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 Windows 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 false .

[-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 Windows 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 Windows 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 user entries need to be propagated to the sid-to-name cache. The default value is true . Specify false to disable propagation.

Examples

The following example shows how to modify the Windows users cache configuration settings for Vserver vs0:

cluster1::> vserver cifs cache settings modify -vserver vs0 -ttl 600 -negative-ttl 300

The following example shows how to disable the Windows users cache for Vserver vs0:

cluster1::> vserver cifs cache settings modify -vserver vs0 -is-enabled false