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