Fortinet white logo
Fortinet white logo

CLI Reference

config webcache settings

config webcache settings

Configure global Web cache settings.

config webcache settings
    Description: Configure global Web cache settings.
    set max-object-size {integer}
    set neg-resp-time {integer}
    set fresh-factor {integer}
    set max-ttl {integer}
    set min-ttl {integer}
    set default-ttl {integer}
    set ignore-ims [enable|disable]
    set ignore-conditional [enable|disable]
    set ignore-pnc [enable|disable]
    set ignore-ie-reload [enable|disable]
    set cache-expired [enable|disable]
    set cache-cookie [enable|disable]
    set reval-pnc [enable|disable]
    set always-revalidate [enable|disable]
    set cache-by-default [enable|disable]
    set host-validate [enable|disable]
    set add-x-cache [enable|disable]
    set x-cache-message {string}
    set external [enable|disable]
    set crawler-user-agent {string}
end

config webcache settings

Parameter

Description

Type

Size

max-object-size

Maximum cacheable object size in kB . All objects that exceed this are delivered to the client but not stored in the web cache.

integer

Minimum value: 1 Maximum value: 2147483

neg-resp-time

Time in minutes to cache negative responses or errors .

integer

Minimum value: 0 Maximum value: 4294967295

fresh-factor

Frequency that the server is checked to see if any objects have expired . The higher the fresh factor, the less often the checks occur.

integer

Minimum value: 1 Maximum value: 100

max-ttl

Maximum time an object can stay in the web cache without checking to see if it has expired on the server .

integer

Minimum value: 1 Maximum value: 5256000

min-ttl

Minimum time an object can stay in the web cache without checking to see if it has expired on the server .

integer

Minimum value: 1 Maximum value: 5256000

default-ttl

Default object expiry time . This only applies to those objects that do not have an expiry time set by the web server.

integer

Minimum value: 1 Maximum value: 5256000

ignore-ims

Enable/disable ignoring the if-modified-since (IMS) header.

option

-

Option

Description

enable

Enable ignoring the if-modified-since (IMS) header.

disable

Disable ignoring the if-modified-since (IMS) header.

ignore-conditional

Enable/disable controlling the behavior of cache-control HTTP 1.1 header values.

option

-

Option

Description

enable

Enable ignoring cache-control HTTP 1.1 header values.

disable

Disable ignoring cache-control HTTP 1.1 header values.

ignore-pnc

Enable/disable ignoring the pragma no-cache (PNC) header.

option

-

Option

Description

enable

Enable ignoring the pragma no-cache (PNC) header.

disable

Disable ignoring the pragma no-cache (PNC) header.

ignore-ie-reload

Enable/disable ignoring the PNC-interpretation of Internet Explorer's Accept: / header.

option

-

Option

Description

enable

Enable ignoring the PNC-interpretation of Internet Explorer's Accept: / header.

disable

Disable ignoring the PNC-interpretation of Internet Explorer's Accept: / header.

cache-expired

Enable/disable caching type-1 objects that are already expired on arrival.

option

-

Option

Description

enable

Enable caching type-1 objects that have expired.

disable

Disable caching type-1 objects that have expired.

cache-cookie

Enable/disable caching cookies. Since cookies contain information for or about individual users, they not usually cached..

option

-

Option

Description

enable

Cache cookies.

disable

Do not cache cookies.

reval-pnc

Enable/disable revalidation of pragma-no-cache (PNC) to address bandwidth concerns.

option

-

Option

Description

enable

Enable revalidation of pragma-no-cache (PNC).

disable

Disable revalidation of pragma-no-cache (PNC).

always-revalidate

Enable/disable revalidation of requested cached objects, which have content on the server, before serving it to the client.

option

-

Option

Description

enable

Enable revalidation of requested cached objects.

disable

Disable revalidation of requested cached objects.

cache-by-default

Enable/disable caching content that lacks explicit caching policies from the server.

option

-

Option

Description

enable

Enable caching content that lacks explicit caching policies.

disable

Disable caching content that lacks explicit caching policies.

host-validate

Enable/disable validating "Host:" with original server IP.

option

-

Option

Description

enable

Enable validating "Host:" with original server IP.

disable

Disable validating "Host:" with original server IP.

add-x-cache

Enable/disable appending local "X-Cache: HIT/MISS" information when http-request is cacheable.

option

-

Option

Description

enable

Enable setting.

disable

Disable setting.

x-cache-message

Config customized x-cache header message .

string

Maximum length: 400

external

Enable/disable external Web caching.

option

-

Option

Description

enable

Enable external Web caching

disable

Disable external Web caching

crawler-user-agent

The user agent that the web crawler will use.

string

Maximum length: 255

config webcache settings

config webcache settings

Configure global Web cache settings.

config webcache settings
    Description: Configure global Web cache settings.
    set max-object-size {integer}
    set neg-resp-time {integer}
    set fresh-factor {integer}
    set max-ttl {integer}
    set min-ttl {integer}
    set default-ttl {integer}
    set ignore-ims [enable|disable]
    set ignore-conditional [enable|disable]
    set ignore-pnc [enable|disable]
    set ignore-ie-reload [enable|disable]
    set cache-expired [enable|disable]
    set cache-cookie [enable|disable]
    set reval-pnc [enable|disable]
    set always-revalidate [enable|disable]
    set cache-by-default [enable|disable]
    set host-validate [enable|disable]
    set add-x-cache [enable|disable]
    set x-cache-message {string}
    set external [enable|disable]
    set crawler-user-agent {string}
end

config webcache settings

Parameter

Description

Type

Size

max-object-size

Maximum cacheable object size in kB . All objects that exceed this are delivered to the client but not stored in the web cache.

integer

Minimum value: 1 Maximum value: 2147483

neg-resp-time

Time in minutes to cache negative responses or errors .

integer

Minimum value: 0 Maximum value: 4294967295

fresh-factor

Frequency that the server is checked to see if any objects have expired . The higher the fresh factor, the less often the checks occur.

integer

Minimum value: 1 Maximum value: 100

max-ttl

Maximum time an object can stay in the web cache without checking to see if it has expired on the server .

integer

Minimum value: 1 Maximum value: 5256000

min-ttl

Minimum time an object can stay in the web cache without checking to see if it has expired on the server .

integer

Minimum value: 1 Maximum value: 5256000

default-ttl

Default object expiry time . This only applies to those objects that do not have an expiry time set by the web server.

integer

Minimum value: 1 Maximum value: 5256000

ignore-ims

Enable/disable ignoring the if-modified-since (IMS) header.

option

-

Option

Description

enable

Enable ignoring the if-modified-since (IMS) header.

disable

Disable ignoring the if-modified-since (IMS) header.

ignore-conditional

Enable/disable controlling the behavior of cache-control HTTP 1.1 header values.

option

-

Option

Description

enable

Enable ignoring cache-control HTTP 1.1 header values.

disable

Disable ignoring cache-control HTTP 1.1 header values.

ignore-pnc

Enable/disable ignoring the pragma no-cache (PNC) header.

option

-

Option

Description

enable

Enable ignoring the pragma no-cache (PNC) header.

disable

Disable ignoring the pragma no-cache (PNC) header.

ignore-ie-reload

Enable/disable ignoring the PNC-interpretation of Internet Explorer's Accept: / header.

option

-

Option

Description

enable

Enable ignoring the PNC-interpretation of Internet Explorer's Accept: / header.

disable

Disable ignoring the PNC-interpretation of Internet Explorer's Accept: / header.

cache-expired

Enable/disable caching type-1 objects that are already expired on arrival.

option

-

Option

Description

enable

Enable caching type-1 objects that have expired.

disable

Disable caching type-1 objects that have expired.

cache-cookie

Enable/disable caching cookies. Since cookies contain information for or about individual users, they not usually cached..

option

-

Option

Description

enable

Cache cookies.

disable

Do not cache cookies.

reval-pnc

Enable/disable revalidation of pragma-no-cache (PNC) to address bandwidth concerns.

option

-

Option

Description

enable

Enable revalidation of pragma-no-cache (PNC).

disable

Disable revalidation of pragma-no-cache (PNC).

always-revalidate

Enable/disable revalidation of requested cached objects, which have content on the server, before serving it to the client.

option

-

Option

Description

enable

Enable revalidation of requested cached objects.

disable

Disable revalidation of requested cached objects.

cache-by-default

Enable/disable caching content that lacks explicit caching policies from the server.

option

-

Option

Description

enable

Enable caching content that lacks explicit caching policies.

disable

Disable caching content that lacks explicit caching policies.

host-validate

Enable/disable validating "Host:" with original server IP.

option

-

Option

Description

enable

Enable validating "Host:" with original server IP.

disable

Disable validating "Host:" with original server IP.

add-x-cache

Enable/disable appending local "X-Cache: HIT/MISS" information when http-request is cacheable.

option

-

Option

Description

enable

Enable setting.

disable

Disable setting.

x-cache-message

Config customized x-cache header message .

string

Maximum length: 400

external

Enable/disable external Web caching.

option

-

Option

Description

enable

Enable external Web caching

disable

Disable external Web caching

crawler-user-agent

The user agent that the web crawler will use.

string

Maximum length: 255