3.5.1 Configuring Cache Options

Cache Options enable you to control how Access Gateway caches objects.

  1. Click Access Gateways > Edit > Cache Options.

  2. To disable caching of all web server content, select Disable Caching.

  3. Configure the Cache Management options:

    Field

    Description

    Enable Caching of Objects with a Question Mark

    If this option is selected, a cacheable object is cached if it has a question mark in the URL.

    Enable Caching of Objects with CGI in the Path

    If this option is selected, a cacheable object is cached if it has /cgi in its URL.

    Objects that meet these criteria are cached if they are cacheable objects. Web server administrators can mark objects as non-cacheable. When so marked, these objects are not cached, even when the above options are selected.

    If you disable both of these options, it does not mean that objects with question marks or cgi in their paths cannot be cached. These objects can match some other criteria and be cached.

  4. (Access Gateway Appliance) Configure Cache Tuning.

    These options restrict or enable functionality that affects resources protected by Access Gateway.

    Refresh Requests from Browser: When a user clicks Refresh or Reload in the browser, this action sends a new request to the web server. Select one of the following options to control how Access Gateway handles the request:

    • Refill: Causes the proxy service to send the request to the web server.

    • Ignore: Causes the proxy service to ignore the request and send the data from cache without checking to see if the cached data is valid.

  5. Modify the Cache Freshness settings.

    These options govern when the proxy service revalidates requested cached objects against those on their respective origin web servers. If the objects have changed, the proxy service re-caches them.

    IMPORTANT:Specify whole number values. Decimal values (2.5) are not supported and generate an XML validation error.

    Option

    Description

    HTTP Maximum

    Specifies the maximum time the proxy service serves HTTP data from cache before revalidating it against content on the origin web server. No object is served from cache after this value expires without being revalidated.

    This overrides a freshness or Time to Expire directive specified by the Webmasters if they specified a longer time.

    You use this value to reduce the maximum time the proxy service waits before checking whether requested objects need to be refreshed. The default is 6 hours.

    HTTP Default

    Specifies the maximum time the proxy service serves HTTP data for which Webmasters have not specified a freshness or Time to Expire directive. The default is 2 hours.

    HTTP Minimum

    (Access Gateway Appliance) Specifies the minimum time the proxy service serves HTTP data from cache before revalidating it against content on the origin web server. No requested object is revalidated sooner than specified by this value.

    This overrides the freshness or Time to Expire directive specified by the Webmasters if they specified a shorter time.

    You can use this value to increase the minimum time the proxy service waits before checking whether requested objects need to be refreshed. This parameter does not override No Cache or Must Revalidate directives from the origin web server.

    The default value is 0, which allows a proxy service to honor the Time To Expire directive of each object (unless it is longer than HTTP Maximum). If the HTTP Minimum option is set to a value other than 0, the value overrides any object’s Time to Expire directive that is shorter than the value set.

    Continue Fill Time

    (Access Gateway Appliance) Specifies the how long the proxy service ignores browser request cancellations and continues downloading objects from the target web server until the download is complete. The default is 1 second.

    HTTP Retries

    (Access Gateway Appliance) Specifies the number of retry requests to issue to a web server. The default is 4 retries.

    NOTE:The time you specify is the hard limit. For example, If you have specified 6 hours in HTTP Maximum, and Access Manager caches details at 10:00 a.m. Then, Access Manager revalidates the cache at 4:00 p.m., even if user accesses something else in between this duration.

  6. Click OK.

  7. To apply the changes, click the Access Gateways link, and then click Update > OK.