1029 lines
69 KiB
HTML
1029 lines
69 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html lang="en-us" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow" />
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<meta name="DC.Type" content="topic" />
|
|
<meta name="DC.Title" content="Module mod_as_cache" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 2002,2006" />
|
|
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2002,2006" />
|
|
<meta name="DC.Format" content="XHTML" />
|
|
<meta name="DC.Identifier" content="rzaiemod_as_cache" />
|
|
<meta name="DC.Language" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
|
|
<link rel="stylesheet" type="text/css" href="./ic.css" />
|
|
<title>Module mod_as_cache</title>
|
|
</head>
|
|
<body id="rzaiemod_as_cache"><a name="rzaiemod_as_cache"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<!--Java sync-link--><h1 class="topictitle1">Module mod_as_cache</h1>
|
|
<div><div class="important"><span class="importanttitle">Important:</span> Information
|
|
for this topic supports the latest PTF levels for HTTP Server for i5/OS .
|
|
It is recommended that you install the latest PTFs to upgrade to the latest
|
|
level of the HTTP Server for i5/OS. Some of the topics documented here are
|
|
not available prior to this update. See <a href="http://www-03.ibm.com/servers/eserver/iseries/software/http/services/service.html" target="_blank">http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm</a> <img src="www.gif" alt="Link outside Information Center" /> for more information. </div>
|
|
<p><strong>Summary</strong></p>
|
|
<p>The module mod_as_cache provides support for caching frequently referenced
|
|
files. It can be used to cache file content, file descriptors or both, or
|
|
mmap the file. </p>
|
|
<p><strong>Directives</strong></p>
|
|
<ul><li><a href="#cachelocalfd">CacheLocalFD</a></li>
|
|
<li><a href="#cachelocalfile">CacheLocalFile</a></li>
|
|
<li><a href="#cachelocalfilemmap">CacheLocalFileMmap</a></li>
|
|
<li><a href="#cachelocalfilepublic">CacheLocalFilePublic</a></li>
|
|
<li><a href="#cachelocalfilesizelimit">CacheLocalFileSizeLimit</a></li>
|
|
<li><a href="#cachelocalsizelimit">CacheLocalSizeLimit</a></li>
|
|
<li><a href="#dynamiccache">DynamicCache</a></li>
|
|
<li><a href="#frcacachelocalfileruntime">FRCACacheLocalFileRunTime</a></li>
|
|
<li><a href="#frcacachelocalfilesizelimit">FRCACacheLocalFileSizeLimit</a></li>
|
|
<li><a href="#frcacachelocalfilestartup">FRCACacheLocalFileStartUp</a></li>
|
|
<li><a href="#frcacachelocalsizelimit">FRCACacheLocalSizeLimit</a></li>
|
|
<li><a href="#frcacookieaware">FRCACookieAware</a></li>
|
|
<li><a href="#frcaenablefilecache">FRCAEnableFileCache</a></li>
|
|
<li><a href="#frcaenableproxy">FRCAEnableProxy</a></li>
|
|
<li><a href="#frcaendofurlmarker">FRCAEndofURLMarker</a></li>
|
|
<li><a href="#frcamaxcommbuffersize">FRCAMaxCommBufferSize</a></li>
|
|
<li><a href="#frcamaxcommtime">FRCAMaxCommTime</a></li>
|
|
<li><a href="#frcaproxycacheentitysizelimit">FRCAProxyCacheEntitySizeLimit</a></li>
|
|
<li><a href="#frcaproxycacheexpirylimit">FRCAProxyCacheExpiryLimit</a></li>
|
|
<li><a href="#frcaproxycacherefreshinterval">FRCAProxyCacheRefreshInterval</a></li>
|
|
<li><a href="#frcaproxycachesizelimit">FRCAProxyCacheSizeLimit</a></li>
|
|
<li><a href="#frcaproxypass">FRCAProxyPass</a></li>
|
|
<li><a href="#frcarandomizeresponse">FRCARandomizeResponse</a></li>
|
|
<li><a href="#livelocalcache">LiveLocalCache</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="hr" id="cachelocalfd"><a name="cachelocalfd"><!-- --></a><h2 class="topictitle2">CacheLocalFD</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalFD <em>filename</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="cachelocalfd__cachelocalfd_context"><a name="cachelocalfd__cachelocalfd_context"><!-- --></a>server config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="cachelocalfd__cachelocalfd_origin"><a name="cachelocalfd__cachelocalfd_origin"><!-- --></a>iSeries™ </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalFD some_image.gif </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The CacheLocalFD directive is used to specify the names of ASCII/BINARY
|
|
stream files whose descriptors you want to cache at server startup. The file
|
|
is opened (share read) and remains open while the server is active. The configuration
|
|
file can contain multiple directive occurrences. Include a separate directive
|
|
for each file that you want to remain open. By keeping your most frequently
|
|
requested files/images opened at server startup, you can improve your server's
|
|
response time for those files. For example, if you open your server's welcome
|
|
page files at startup, the server can handle requests for the page much more
|
|
quickly than if it had to open the files each time they are requested. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>filename </em></dt>
|
|
<dd><ul><li>The <em>filename</em> parameter specifies the names of ASCII/BINARY stream
|
|
files whose descriptors are cached at server startup.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>The advantage of using CacheLocalFD directive over CacheLocalFile is that
|
|
it does not cache the content of the file, and therefore does not allocate
|
|
a large amount of memory, yet provides similar performance. The disadvantage
|
|
of using CacheLocalFD directive over CacheLocalFile is that it only caches
|
|
the file descriptors of ASCII/BINARY stream files and it keeps the file open
|
|
(share read) while the server is active.</p>
|
|
<p>The LiveLocalCache directive setting does not apply to this directive and
|
|
if a cached file is updated, the cached entity is discarded and the updated
|
|
file is served from the file system. If a cached file is modified while at
|
|
the same time being served, the content of the response body is unpredictable.</p>
|
|
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk ('*') as a wildcard character on the file names
|
|
(for example, CacheLocalFD *.gif). File name matching is not recursive through
|
|
subdirectories. The server will only cache files in the specified directory.
|
|
No files in subdirectories are affected.</div>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="cachelocalfile"><a name="cachelocalfile"><!-- --></a><h2 class="topictitle2">CacheLocalFile</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalFile <em>filename</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="cachelocalfile__cachelocalfile_context"><a name="cachelocalfile__cachelocalfile_context"><!-- --></a>server
|
|
config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="cachelocalfile__cachelocalfile_origin"><a name="cachelocalfile__cachelocalfile_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalFile bobwelcome.html </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The CacheLocalFile directive is used to specify the names of files that
|
|
you want to load into the server's memory each time that you start the server,
|
|
and is the recommended file cache method. You can have multiple occurrences
|
|
of this directive in the configuration file. Include a separate directive
|
|
for each file that you want to load into memory. By keeping your most frequently
|
|
requested files loaded in the server's memory, you can improve your server's
|
|
response time for those files. For example, if you load your server's welcome
|
|
page into memory at startup, the server can handle requests for the page much
|
|
more quickly than if it had to read the file from the file system. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>filename </em></dt>
|
|
<dd><ul><li>The <em>filename</em> parameter specifies the names of files that you want
|
|
to load into the server's memory each time that you start the server.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk ('*') as a wildcard character on the file names
|
|
(for example, CacheLocalFile *.html). File name matching is not recursive
|
|
through subdirectories. The server will only cache files in the specified
|
|
directory. No files in subdirectories are affected. </div>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="cachelocalfilemmap"><a name="cachelocalfilemmap"><!-- --></a><h2 class="topictitle2">CacheLocalFileMmap</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalFileMmap <em>filename</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="cachelocalfilemmap__cachelocalfilemmap_context"><a name="cachelocalfilemmap__cachelocalfilemmap_context"><!-- --></a>server
|
|
config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="cachelocalfilemmap__cachelocalfilemmap_origin"><a name="cachelocalfilemmap__cachelocalfilemmap_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalFileMmap bobwelcome.html </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The CacheLocalFileMmap directive is used to specify the names of files
|
|
that you want to map to the server's memory each time that you start the server.
|
|
This directive is similar to the CacheLocalFile directive. Whereas CacheLocalFile
|
|
allocates storage and copies (read/write) the content of the file to the allocated
|
|
storage, CacheLocalFileMmap maps the file content to the process storage space
|
|
without actually allocating storage.</p>
|
|
<p>The LiveLocalCache directive setting does not apply to this directive and
|
|
if a cached file is updated, the cached entity is discarded and the updated
|
|
file is served from the file system. If a cached file is modified while at
|
|
the same time being served, the content of the response body is unpredictable. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>filename </em></dt>
|
|
<dd><ul><li>The <em>filename</em> parameter specifies the names of files that you want
|
|
to map to the server's memory each time that you start the server. </li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>You can have multiple occurrences of this directive in the configuration
|
|
file. Include a separate directive for each file that you want to load into
|
|
memory. By keeping your most frequently requested files mapped in the server's
|
|
address space, you can improve your server's response time for those files.
|
|
For example, if you map your server's welcome at startup, the server can handle
|
|
requests for the page much more quickly than if it had to read the file from
|
|
the file system. </p>
|
|
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk (*) as a wildcard character on the file names
|
|
(for example, CacheLocalFileMmap *.html). File name matching is not recursive
|
|
through subdirectories. The server will only cache files in the specified
|
|
directory. No files in subdirectories are affected. The relative/absolute
|
|
path rules apply to this directive, meaning that a path that begins without
|
|
a leading (/) character is considered to be absolute. Otherwise, the path
|
|
is based on the server's document root.</div>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="cachelocalfilepublic"><a name="cachelocalfilepublic"><!-- --></a><h2 class="topictitle2">CacheLocalFilePublic</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalFilePublic <var class="varname">filename</var></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: server</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: iSeries</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalFilePublic bobwelcome.html</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p> The CacheLocalFilePublic directive is used to specify the names of files
|
|
that you want to load into the server's memory each time that you start the
|
|
server. The files cached here are files that are served without any server
|
|
authentication. This directive is used by SSL sites which have pages that
|
|
are publicly available. This simulates the FRCA function completed by the
|
|
server for non-SSL publicly available files. You can have multiple occurrences
|
|
of this directive in the configuration file. Include a separate directive
|
|
for each file that you want to load into memory. By keeping your most frequently
|
|
requested public files loaded in the server's memory, you can improve your
|
|
server's response time for those files. For example, if you load your server's
|
|
welcome page into memory at startup, the server can handle requests for the
|
|
page much more quickly than if it had to read the file from the file system.</p>
|
|
<p><strong>Note:</strong> You can use an asterisk (''*'') as a wildcard character on
|
|
the file names, (for example, CacheLocalFile *.html).</p>
|
|
<p>File name matching is not recursive through subdirectories. The server
|
|
only caches files in the specified directory. No files in subdirectories
|
|
are affected. There is no authentication or authorization done before any
|
|
files in this cache are served. </p>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="cachelocalfilesizelimit"><a name="cachelocalfilesizelimit"><!-- --></a><h2 class="topictitle2">CacheLocalFileSizeLimit</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalFileSizeLimit <em>size</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: CacheLocalFileSizeLimit 90000 </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="cachelocalfilesizelimit__cachelocalsizelimit_context"><a name="cachelocalfilesizelimit__cachelocalsizelimit_context"><!-- --></a>server
|
|
config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="cachelocalfilesizelimit__cachelocalsizelimit_origin"><a name="cachelocalfilesizelimit__cachelocalsizelimit_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalFileSizeLimit 5000000 </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The CacheLocalFileSizeLimit directive is used to specify, in bytes, the
|
|
largest file that will be placed in the local memory cache. A file larger
|
|
than the value specified for CacheLocalFileSizeLimit will not be placed in
|
|
the cache. This prevents the cache from being filled by only a small number
|
|
of very large files. The upper limit for this directive is capped at 16,000,000.
|
|
If you specify a larger value the value 16,000,000 will be used. </p>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="cachelocalsizelimit"><a name="cachelocalsizelimit"><!-- --></a><h2 class="topictitle2">CacheLocalSizeLimit</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: CacheLocalSizeLimit <em>size</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: CacheLocalSizeLimit 2000 </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="cachelocalsizelimit__cachelocalsizelimit_context"><a name="cachelocalsizelimit__cachelocalsizelimit_context"><!-- --></a>server
|
|
config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="cachelocalsizelimit__cachelocalsizelimit_origin"><a name="cachelocalsizelimit__cachelocalsizelimit_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: CacheLocalSizeLimit 25000 </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The CacheLocalSizeLimit directive is used to specify the maximum amount
|
|
of memory, in kilobytes, that you want to allow for file caching. You must
|
|
specify the files that you want cached with the CacheLocalFile directive or
|
|
by setting DynamicCache to on. The number you specify is the upper limit (the
|
|
maximum upper limits 93 gigabytes (100,000,000,000 bytes)); the storage is
|
|
allocated as a file is cached. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>size</em></dt>
|
|
<dd><ul><li>The <em>size</em> parameter specifies the maximum amount of memory, in kilobytes,
|
|
that you want to allow for file caching. </li>
|
|
</ul>
|
|
<p><strong>Note:</strong> CacheLocalSizeLimit can help limit your cache size when
|
|
you are using the wildcard character to specify the files on the CacheLocalFile
|
|
directive.</p>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="dynamiccache"><a name="dynamiccache"><!-- --></a><h2 class="topictitle2">DynamicCache</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: DynamicCache <em>on | off </em></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: DynamicCache off </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="dynamiccache__dynamiccache_context"><a name="dynamiccache__dynamiccache_context"><!-- --></a>server config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="dynamiccache__dynamiccache_origin"><a name="dynamiccache__dynamiccache_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: DynamicCache on </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The DynamicCache directive is used to specify if you want the server to
|
|
dynamically cache frequently accessed files. Setting the dynamic cache directive
|
|
to "on" instructs the server to cache the most frequently accessed files.
|
|
This results in better performance and system throughput. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>on | off </em></dt>
|
|
<dd><ul><li>If the parameter is set to <em>on</em> the server will dynamically cache
|
|
frequently accessed files.</li>
|
|
<li>If the parameter is set to <em>off</em> the server will not dynamically
|
|
cache frequently accessed files.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<div class="note"><span class="notetitle">Note:</span> Note requires links.If you know the files that are frequently accessed
|
|
or you have a large number of files, then it is better to use CacheLocalFile
|
|
, CacheLocalFD, or CacheLocalFileMmap to cache them at server startup. </div>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcacachelocalfileruntime"><a name="frcacachelocalfileruntime"><!-- --></a><h2 class="topictitle2">FRCACacheLocalFileRunTime</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCACacheLocalFileRunTime <em>filename</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcacachelocalfileruntime__frcacachelocalfileruntime_context"><a name="frcacachelocalfileruntime__frcacachelocalfileruntime_context"><!-- --></a>server
|
|
config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcacachelocalfileruntime__frcacachelocalfileruntime_origin"><a name="frcacachelocalfileruntime__frcacachelocalfileruntime_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCACacheLocalFileRunTime /www/html/index.html</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCACacheLocalFileRunTime directive specifies the name of a file that
|
|
you want to load into the SLIC NFC during server run time if and when it is
|
|
requested by a client. The configuration file can contain multiple directive
|
|
occurrences. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>filename </em></dt>
|
|
<dd><ul><li>The <em>filename</em> parameter value specifies the name of a file that
|
|
you want to load into the SLIC NFC during server run time if and when it is
|
|
requested by a client.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>During server run time, the below example caches the specified file in
|
|
FRCA NFC if it is requested by a client.</p>
|
|
<pre class="block">FRCACacheLocalFileRunTime /www/html/index.html</pre>
|
|
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk (*) as a wild card character on the file name.
|
|
Filename matching is not recursive through subdirectories. The server only
|
|
caches files in the specified directory. No files in other sub directories
|
|
are affected.</div>
|
|
<p>During server run time, the below example caches in the FRCA NFC any .gif
|
|
file in the /www/images directory that is requested by a client. For example, </p>
|
|
<pre class="block">FRCACacheLocalFileRunTime /www/images/*.gif</pre>
|
|
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk (*) as a wild card character on the file name.
|
|
Filename matching is not recursive through subdirectories. The server will
|
|
only cache files in the specified directory and its subdirectories.</div>
|
|
<p>During server run time, the below example will dynamically cache in the
|
|
SLIC NFC (based on the file usage) any file that is in a directory path that
|
|
starts with /www/imag and its subdirectories. For example, </p>
|
|
<pre class="block">FRCACacheLocalFileRunTime /www/imag*</pre>
|
|
<div class="note"><span class="notetitle">Note:</span> If directory name begins with / it is absolute, otherwise it is relative
|
|
to the server's document root.</div>
|
|
<p>During server run time, the below example will dynamically cache in the
|
|
SLIC NFC (based on the file usage) any file in any directory.</p>
|
|
<pre class="block">FRCACacheLocalFileRunTime /*</pre>
|
|
<div class="note"><span class="notetitle">Note:</span> If a directory name begins with / it is absolute, otherwise it is relative
|
|
to the server's document root.</div>
|
|
<p>For caching files at the server run time, only specify the path name of
|
|
the files that are intended for public viewing. That is, do not specify or
|
|
configure file names containing sensitive information which is not intended
|
|
for general users. FRCACacheLocalFileRunTime only caches files that do not
|
|
require conversion. (IFS binary or ASCII files).</p>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcacachelocalfilesizelimit"><a name="frcacachelocalfilesizelimit"><!-- --></a><h2 class="topictitle2">FRCACacheLocalFileSizeLimit</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCACacheLocalFileSizeLimit <em>size</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCACacheLocalFileSizeLimit 92160 </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcacachelocalfilesizelimit__frcacachelocalfilesizelimit_context"><a name="frcacachelocalfilesizelimit__frcacachelocalfilesizelimit_context"><!-- --></a>server
|
|
config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcacachelocalfilesizelimit__frcacachelocalfilesizelimit_origin"><a name="frcacachelocalfilesizelimit__frcacachelocalfilesizelimit_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCACacheLocalFileSizeLimit 32000 </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCACacheLocalFileSizeLimit directive specifies the maximum file size
|
|
(in bytes) that you want to allow for file caching. The directive can control
|
|
cache storage for a number of smaller files when using wild card characters
|
|
to specify files in the FRCACacheLocalFileStartUp and FRCACacheLocalFileDynamic
|
|
directives</p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>size </em></dt>
|
|
<dd><ul><li>The <em>size</em> parameter value specifies the maximum file size (in bytes)
|
|
that you want to allow for file caching.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>The below example allows only caching of files that are equal to or less
|
|
than 32000 bytes. Files greater than 32000 bytes are not cached.</p>
|
|
<pre class="block">FRCACacheLocalFileSizeLimit 32000</pre>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcacachelocalfilestartup"><a name="frcacachelocalfilestartup"><!-- --></a><h2 class="topictitle2">FRCACacheLocalFileStartUp</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCACacheLocalFileStartUp <em>filename</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcacachelocalfilestartup__frcacachelocalfilestartup_context"><a name="frcacachelocalfilestartup__frcacachelocalfilestartup_context"><!-- --></a>server
|
|
config</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcacachelocalfilestartup__frcacachelocalfilestartup_origin"><a name="frcacachelocalfilestartup__frcacachelocalfilestartup_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCACacheLocalFileStartUp /www/html/index.html </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCACacheLocalFileStartUp directive specifies the file name that you
|
|
want to load into the SLIC NFC each time you start the server. The configuration
|
|
file can contain multiple directive occurrences. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>filename </em></dt>
|
|
<dd><ul><li>The <em>filename</em> parameter value specifies the file name that you want
|
|
to load into the SLIC NFC each time you start the server.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>The below example caches a specific file. </p>
|
|
<pre class="block">FRCACacheLocalFileStartUp /www/html/index.html</pre>
|
|
<div class="note"><span class="notetitle">Note:</span> You can use an asterisk (*) as a wild card character on the file name.
|
|
Filename matching is not recursive through subdirectories. The server only
|
|
caches files in the specified directory. No files in other sub directories
|
|
are affected.</div>
|
|
<p>The below example caches all .gif files in the /www/images directory. </p>
|
|
<pre class="block">FRCACacheLocalFileStartUp /www/images/*.gif</pre>
|
|
<div class="note"><span class="notetitle">Note:</span> If a directory name begins with / it is absolute, otherwise it is relative
|
|
to the server's document root.</div>
|
|
<p>FRCACacheLocalFileStartUp only caches files that do not require conversion.
|
|
(IFS binary or ASCII files). FRCA Proxy does not perform authentication or
|
|
authorization checking. Therefore, do not specify or configure file names
|
|
containing sensitive information that is not intended for public viewing. </p>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcacachelocalsizelimit"><a name="frcacachelocalsizelimit"><!-- --></a><h2 class="topictitle2">FRCACacheLocalSizeLimit</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCACacheLocalSizeLimit <em>size</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCACacheLocalSizeLimit 2000 </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcacachelocalsizelimit__frcacachelocalsizelimit_context"><a name="frcacachelocalsizelimit__frcacachelocalsizelimit_context"><!-- --></a>server
|
|
config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcacachelocalsizelimit__frcacachelocalsizelimit_origin"><a name="frcacachelocalsizelimit__frcacachelocalsizelimit_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCACacheLocalSizeLimit 5000 </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCACacheLocalSizeLimit directive specifies the maximum amount of storage
|
|
(in kilobytes) that you want to allow for FRCA file caching. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>size</em></dt>
|
|
<dd><ul><li>The <em>size</em> parameter value specifies the maximum amount of storage
|
|
(in kilobytes) that you want to allow for FRCA file caching.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>The below example caches files until the accumulated size reaches 5000
|
|
kilobytes. </p>
|
|
<pre class="block">FRCACacheLocalSizeLimit 5000</pre>
|
|
<div class="note"><span class="notetitle">Note:</span> The specified value is the upper limit, the actual amount of allocated
|
|
storage is the accumulated size of the cached files. This directive can limit
|
|
the cache size when using wild card character to specify the files in the
|
|
FRCACacheLocalFileStartUp directive. </div>
|
|
<p>If the specified directive size is greater than the amount of available
|
|
storage in the FRCA network file cache, the FRCA network file only caches
|
|
as many files as it has space for. </p>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcacookieaware"><a name="frcacookieaware"><!-- --></a><h2 class="topictitle2">FRCACookieAware</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCACookieAware <em><path></em></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcacookieaware__frcacookieaware_context"><a name="frcacookieaware__frcacookieaware_context"><!-- --></a>server
|
|
config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcacookieaware__frcacookieaware_origin"><a name="frcacookieaware__frcacookieaware_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCACookieAware /some_path_segment </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>This FRCACookieAware directive indicates URL prefix for which the cookie
|
|
should be included in cache lookup. This directive makes it possible to serve
|
|
a cached entity only for the requests with the same cookie</p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em><path></em></dt>
|
|
<dd><ul><li>The <em><path></em> parameter value specifies a valid path name.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcaenablefilecache"><a name="frcaenablefilecache"><!-- --></a><h2 class="topictitle2">FRCAEnableFileCache</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAEnableFileCache <em>on | off </em></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAEnableFileCache off </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaenablefilecache__frcaenablefilecache_context"><a name="frcaenablefilecache__frcaenablefilecache_context"><!-- --></a>server
|
|
config</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaenablefilecache__frcaenablefilecache_origin"><a name="frcaenablefilecache__frcaenablefilecache_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAEnableFileCache on </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCAEnableFileCache directive enables or disables FRCA file caching
|
|
support for the specified server. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>on | off </em></dt>
|
|
<dd><ul><li>If the parameter value is <em>on</em>, FRCA file caching support is enabled
|
|
for the specified server. </li>
|
|
<li>If the parameter value is <em>off</em>, all other FRCA file cache related
|
|
directives in the configuration file are ignored.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<div class="note"><span class="notetitle">Note:</span> FRCA does not perform authentication or authorization checking for the
|
|
HTTP requests that are served from the FRCA cache.</div>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcaenableproxy"><a name="frcaenableproxy"><!-- --></a><h2 class="topictitle2">FRCAEnableProxy</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAEnableProxy <em>on | off </em></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAEnableProxy off</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaenableproxy__frcaenableproxy_context"><a name="frcaenableproxy__frcaenableproxy_context"><!-- --></a>server
|
|
config, virtual host</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaenableproxy__frcaenableproxy_origin"><a name="frcaenableproxy__frcaenableproxy_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAEnableProxy on </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCAEnableFileCache directive enables or disables FRCA proxy support. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>on | off </em></dt>
|
|
<dd><ul><li>If the parameter value is <em>on</em>, FRCA proxy support is enabled for
|
|
the specified container. </li>
|
|
<li>If the parameter value is <em>off</em>, only FRCA directives in the server
|
|
configuration section are ignored. If FRCAEnableProxy is set to off in a virtual
|
|
host container, only FRCA directives in that virtual host container are ignored.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>FRCA proxy does not perform authentication or authorization checking for
|
|
the HTTP requests that are served by the FRCA Proxy support. </p>
|
|
<div class="note"><span class="notetitle">Note:</span> Virtual host containers do not inherit the FRCAEnableProxy setting from
|
|
the server configuration.</div>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcaendofurlmarker"><a name="frcaendofurlmarker"><!-- --></a><h2 class="topictitle2">FRCAEndofURLMarker</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAEndofURLMarker <em><string></em></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaendofurlmarker__frcaendofurlmarker_context"><a name="frcaendofurlmarker__frcaendofurlmarker_context"><!-- --></a>server
|
|
config</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaendofurlmarker__frcaendofurlmarker_origin"><a name="frcaendofurlmarker__frcaendofurlmarker_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAEndofURLMarker ###"</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAEndofURLMarker eou</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAEndofURLMarker #eou#</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCAEndofURLMarker directive specifies the unique string that identifies
|
|
the end of URLs. Suppose a link in an html page is http://some.org/some_path/some_parms###.
|
|
Before the client sends this request to the server, it may pad the URL with
|
|
data such as client_padded_data. The some.org server will receive the path
|
|
/some_path/some_parms###client_padded_data.</p>
|
|
<p>By specifying FRCAEndofURLMarker ###", FRCA support can identify the end
|
|
of the original URL (link) before it was modified or padded by the client.
|
|
</p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em><string></em></dt>
|
|
<dd><ul><li>The <em><string></em> parameter value specifies a string of one or more
|
|
characters including #, $.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcamaxcommbuffersize"><a name="frcamaxcommbuffersize"><!-- --></a><h2 class="topictitle2">FRCAMaxCommBufferSize</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAMaxCommBufferSize <em>size</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAMaxCommBufferSize 8000 </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcamaxcommbuffersize__frcamaxcommbuffersize_context"><a name="frcamaxcommbuffersize__frcamaxcommbuffersize_context"><!-- --></a>server
|
|
config</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcamaxcommbuffersize__frcamaxcommbuffersize_origin"><a name="frcamaxcommbuffersize__frcamaxcommbuffersize_origin"><!-- --></a>Apache </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAMaxCommBufferSize 4000000 </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCAMaxCommBufferSize directive sets the communication buffer size
|
|
(in bytes) in FRCA for performance. The data being sent to HTTP Server (powered
|
|
by Apache) consists of log data, message data, and collection services data.
|
|
FRCA will buffer the size of data specified until the buffer is full. Once
|
|
the buffer is full, the data will be transmitted to Apache for processing. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>size</em></dt>
|
|
<dd><ul><li>The <em>size</em> parameter value sets the communication buffer size (in
|
|
bytes) in FRCA for performance.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcamaxcommtime"><a name="frcamaxcommtime"><!-- --></a><h2 class="topictitle2">FRCAMaxCommTime</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAMaxCommTime <em>time</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAMaxCommTime 120 </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcamaxcommtime__frcamaxcommtime_context"><a name="frcamaxcommtime__frcamaxcommtime_context"><!-- --></a>server
|
|
config</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcamaxcommtime__frcamaxcommtime_origin"><a name="frcamaxcommtime__frcamaxcommtime_origin"><!-- --></a>Apache </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAMaxCommTime 240 </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCAMaxCommTime directive sets the maximum number of seconds to wait
|
|
before the data buffer is sent from FRCA to HTTP Server (powered by Apache).
|
|
The data being sent to HTTP Server consists of log data, message data, and
|
|
collection services data. Once the time limit has been reached, the data will
|
|
be transmitted to HTTP Server for processing. Valid values include integers
|
|
0 through 65,535. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>time </em></dt>
|
|
<dd><ul><li>The <em>time</em> parameter value sets the maximum number of seconds to
|
|
wait before the data buffer is sent from FRCA to HTTP Server (powered by Apache).</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcaproxycacheentitysizelimit"><a name="frcaproxycacheentitysizelimit"><!-- --></a><h2 class="topictitle2">FRCAProxyCacheEntitySizeLimit</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAProxyCacheEntitySizeLimit <em>size</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAProxyCacheEntitySizeLimit 92160 </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaproxycacheentitysizelimit__frcaproxycacheentitysizelimit_context"><a name="frcaproxycacheentitysizelimit__frcaproxycacheentitysizelimit_context"><!-- --></a>server
|
|
config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaproxycacheentitysizelimit__frcaproxycacheentitysizelimit_origin"><a name="frcaproxycacheentitysizelimit__frcaproxycacheentitysizelimit_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAProxyCacheEntitySizeLimit 8000 </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCAProxyCacheEntitySizeLimit directive specifies the maximum proxy
|
|
response entity size (in bytes) for FRCA to cache. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>size </em></dt>
|
|
<dd><ul><li>The <em>size</em> parameter value specifies the maximum proxy response entity
|
|
size (in bytes) for FRCA to cache.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>The below example only allows caching of proxy responses that are equal
|
|
to, or less than, 8000 bytes. </p>
|
|
<pre class="block">FRCAProxyCacheEntitySizeLimit 8000</pre>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcaproxycacheexpirylimit"><a name="frcaproxycacheexpirylimit"><!-- --></a><h2 class="topictitle2">FRCAProxyCacheExpiryLimit</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAProxyCacheExpiryLimit <em><time></em></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAProxyCacheExpiryLimit 86400</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaproxycacheexpirylimit__frcaproxycacheexpirylimit_context"><a name="frcaproxycacheexpirylimit__frcaproxycacheexpirylimit_context"><!-- --></a>server
|
|
config</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaproxycacheexpirylimit__frcaproxycacheexpirylimit_origin"><a name="frcaproxycacheexpirylimit__frcaproxycacheexpirylimit_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAProxyCacheExpiryLimit 3600</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCAProxyCacheExpiryLimit directive sets the expiration (in seconds)
|
|
for FRCA proxy cached HTTP documents. Expiry time for FRCA proxy cached HTTP
|
|
documents will be set to at most <em>nnn</em> number of seconds into the future.
|
|
FRCA proxy cached HTTP documents can be at most <em>nnn</em> seconds out of
|
|
date. If the expire header is present with the document in the response, then
|
|
the lower of the two values is used. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em><time></em></dt>
|
|
<dd><ul><li>The <em><time></em> parameter value sets the expiration (in seconds)
|
|
for FRCA proxy cached HTTP documents.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>FRCA proxy cached HTTP documents are limited by the specified time interval
|
|
(in seconds). This restriction is enforced even if an expiration date is supplied
|
|
with the HTTP document. </p>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcaproxycacherefreshinterval"><a name="frcaproxycacherefreshinterval"><!-- --></a><h2 class="topictitle2">FRCAProxyCacheRefreshInterval</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAProxyCacheRefreshInterval <em><proxy> <time></em></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaproxycacherefreshinterval__frcaproxycacherefreshinterval_context"><a name="frcaproxycacherefreshinterval__frcaproxycacherefreshinterval_context"><!-- --></a>server
|
|
config, virtual host </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaproxycacherefreshinterval__frcaproxycacherefreshinterval_origin"><a name="frcaproxycacherefreshinterval__frcaproxycacherefreshinterval_origin"><!-- --></a>iSeries</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAProxyCacheRefreshInterval /mirror/ibm/test
|
|
30 </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCAProxyCacehRefreshInterval directive sets the time period (in seconds)
|
|
to use each cached entity, for the specified URI, before refreshing the cache.</p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter One</strong>: <em><path></em></dt>
|
|
<dd><ul><li>The <em><path></em> parameter value specifies the URI associated with
|
|
cached entity.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter Two</strong>: <em><time></em></dt>
|
|
<dd><ul><li>The <em><time></em> parameter value sets the time period (in seconds)
|
|
to use each cached entity, for the specified URI, before refreshing the cache.
|
|
Possible values include integers 0 through 2,147,483,647.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<div class="note"><span class="notetitle">Note:</span> If the value specified for <em><time></em> is zero, then the document
|
|
for the specified path are always current. That is the document is not cached. </div>
|
|
<p>FRCA proxy cached HTTP documents are limited by the specified interval
|
|
(in seconds). This restriction is enforced even if an expiration date is supplied
|
|
with the HTTP document. </p>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcaproxycachesizelimit"><a name="frcaproxycachesizelimit"><!-- --></a><h2 class="topictitle2">FRCAProxyCacheSizeLimit</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAProxyCacheSizeLimit <em>size</em> </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: FRCAProxyCacheSizeLimit 2000 </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaproxycachesizelimit__frcaproxycachesizelimit_context"><a name="frcaproxycachesizelimit__frcaproxycachesizelimit_context"><!-- --></a>server
|
|
config</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaproxycachesizelimit__frcaproxycachesizelimit_origin"><a name="frcaproxycachesizelimit__frcaproxycachesizelimit_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAProxyCacheSizeLimit 5000 </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCAProxyCacheSizeLimit directive specifies the maximum amount of storage
|
|
(in kilobytes) that FRCA proxy caching uses for the specified server. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter One</strong>: <em>size </em></dt>
|
|
<dd><ul><li>The <em>size</em> parameter value specifies the maximum amount of storage
|
|
(in kilobytes) that FRCA proxy caching uses for the specified server.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>The below example caches proxy response entities until the accumulated
|
|
size reaches 5000 kilobytes.</p>
|
|
<pre class="block">FRCAProxyCacheSizeLimit 5000</pre>
|
|
<div class="note"><span class="notetitle">Note:</span> The specified value is the upper limit; the actual amount of allocated
|
|
storage is the accumulated proxy entity cache size.</div>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcaproxypass"><a name="frcaproxypass"><!-- --></a><h2 class="topictitle2">FRCAProxyPass</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCAProxyPass <em><path> <URL></em></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcaproxypass__frcaproxypass_context"><a name="frcaproxypass__frcaproxypass_context"><!-- --></a>server config,
|
|
virtual host </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcaproxypass__frcaproxypass_origin"><a name="frcaproxypass__frcaproxypass_origin"><!-- --></a>iSeries</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCAProxyPass /mirror/foo/ http://foo.com/ </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCAProxyPass directive allows remote servers to map into the local
|
|
server space. The local server does not act as a proxy in the conventional
|
|
sense; it acts a mirror of the remote server. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter One</strong>: <em><path></em></dt>
|
|
<dd><ul><li>The <em><path></em> parameter value specifies the name of a local virtual
|
|
path. The value is case sensitive.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter Two</strong>: <em><URL></em></dt>
|
|
<dd><ul><li>The <em><URL></em> parameter value specifies the partial URL for the
|
|
remote server.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<p>If the local server address is <tt>http://ibm.com/ then FRCAProxyPass /mirror/ibm1/
|
|
http://ibm1.com/</tt> causes a local request for the <tt>http://ibm.com/mirror/ibm1/location</tt> to
|
|
be internally converted into a proxy request of <tt>http://ibm1.com/location</tt>.</p>
|
|
<div class="note"><span class="notetitle">Note:</span> FRCA Proxy does not perform authentication or authorization checking.
|
|
Therefore, do not specify or configure paths or URLs that would result in
|
|
responses with sensitive information that is not intended for public viewing.</div>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="frcarandomizeresponse"><a name="frcarandomizeresponse"><!-- --></a><h2 class="topictitle2">FRCARandomizeResponse</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: FRCARandomizeResponse <em><path> <string> <nnn> <mmm></em></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="frcarandomizeresponse__frcarandomizeresponse_context"><a name="frcarandomizeresponse__frcarandomizeresponse_context"><!-- --></a>server
|
|
config</span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="frcarandomizeresponse__frcarandomizeresponse_origin"><a name="frcarandomizeresponse__frcarandomizeresponse_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCARandomizeResponse /some_path/fileNNN.html
|
|
NNN 1 1000</td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: FRCARandomizeResponse /some_path/fileXXX.html
|
|
XXX 200 300</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The FRCARandomizeResponse directive specifies the path template, the replacement
|
|
string marker, and the random number range that you would like FRCA to randomly
|
|
use when selecting and serving files of that template. For example, if you
|
|
have 1000 files with names <em>file1.html</em> through <em>file1000.html</em>.
|
|
By configuring <tt>FRCARandomizeResponse /document_root_alias_path/fileNNN.html
|
|
NNN 1 1000</tt> and requesting the URL <tt>http://some_host:port/dirpath/fileNNN.html</tt>,
|
|
FRCA will randomly select and serve one of the 1000 files. </p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter One</strong>: <em><path></em></dt>
|
|
<dd><ul><li>The <em><path></em> parameter value specifies valid paths in the form
|
|
of /some_path_segment/some_partial_file_name#.ext where "#" is replaced with
|
|
a randomly generated number by FRCA before serving the response. <div class="note"><span class="notetitle">Note:</span> the
|
|
path must begin with '/'. It cannot be a relative path. </div>
|
|
</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter Two</strong>: <em><string> </em></dt>
|
|
<dd><ul><li>Text <em><string></em> parameter value specifies the replacement string
|
|
marker ("NNN") in the path. </li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter Three</strong>: <em><nnn></em></dt>
|
|
<dd><ul><li>The <em><nnn></em> parameter value specifies the lower limit for random
|
|
numbers. </li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter Four</strong>: <em><mmm></em></dt>
|
|
<dd><ul><li>The <em><mmm></em> parameter value specifies the upper limit for random
|
|
numbers.</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
<div class="hr" id="livelocalcache"><a name="livelocalcache"><!-- --></a><h2 class="topictitle2">LiveLocalCache</h2>
|
|
<div>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="void" border="0" rules="none"><tbody><tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Module">Module</a></strong>: mod_as_cache </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Syntax">Syntax</a></strong>: LiveLocalCache <em>on | off </em></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Default">Default</a></strong>: LiveLocalCache on </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Context">Context</a></strong>: <span id="livelocalcache__livelocalcache_context"><a name="livelocalcache__livelocalcache_context"><!-- --></a>server
|
|
config </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Override">Override</a></strong>: none </td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Origin">Origin</a></strong>: <span id="livelocalcache__livelocalcache_origin"><a name="livelocalcache__livelocalcache_origin"><!-- --></a>iSeries </span></td>
|
|
</tr>
|
|
<tr><td colspan="2" valign="top"><strong><a href="rzaiedirective-dict.htm#rzaiedirective-dict__Example">Example</a></strong>: LiveLocalCache off </td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>The LiveLocalCache directive is used to specify if the cache is updated
|
|
when a cached file is modified. Set this directive to "on" if you want users,
|
|
requesting a cached file, to receive the file with the latest updates. Setting
|
|
this directive to "off" is the optimum setting for performance. When LiveLocalCache
|
|
directive is set to "on", before responding to a request for a file that is
|
|
stored in memory, the server checks to see if the file has changed since the
|
|
server was started. If the file has changed, the server responds to this request
|
|
with the updated file. The server then deletes the older file version from
|
|
memory. Restart the server to load the new file into memory.</p>
|
|
<dl class="block"><dt class="dlterm"><strong>Parameter</strong>: <em>on | off </em></dt>
|
|
<dd><ul><li>If the parameter value is set to <em>on</em>, the cache is updated when
|
|
a cached file is modified. </li>
|
|
<li>If the parameter value is set to <em>off</em>, the cache is not updated
|
|
when a cached file is modified. </li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
|
|
</body>
|
|
</html> |