vserver services name-service cache hosts settings modify

Modify Hosts Cache Configuration

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

Description

The vserver services name-service cache hosts settings modify command modifies the hosts cache configuration of the specified Vserver.

Parameters

-vserver <vserver name> - Vserver
Use this parameter to specify the Vserver for which the hosts cache settings need to be modified.
[-is-enabled {true|false}] - Is Cache Enabled?
Use this parameter to specify if the cache needs to be enabled for the hosts 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?
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 hosts database and the lookup 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>h][<integer>m][<integer>s]>] - Time to Live
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 hosts database and the lookup succeeds. The default value is 24 hours.
[-negative-ttl <[<integer>h][<integer>m][<integer>s]>] - Negative Time to Live
Use this parameter to specify the time for which the negative entries need to be cached. The default value is 1 minute.
[-is-dns-ttl-enabled {true|false}] - Is TTL Taken from DNS
Specifies whether TTL is taken from DNS or host settings. If this parameter is true, TTL is based on the DNS setting. If false, TTL is based on the host setting. The default value is true.

Examples

The following example modifies the hosts cache configuration settings for Vserver vs0:
cluster1::> vserver services name-service cache hosts settings modify -vserver vs0 -ttl 600 -negative-ttl 300

The following example disables the cache for Vserver vs0:

cluster1::> vserver services name-service cache hosts settings modify -vserver vs0 -is-enabled false