Global Attributes
WAX has many configuration settings that apply at a global level and affect the basic behavior of the accelerator. These settings may only be used on the root wax:configuration element:
enabled [required]
True - WAX optimization is enabled
False - WAX optimization is disabled
runMode [required]
Development - Instructs the Website Accelerator to provide verbose message logging, and to display optimizer info in the debug overlay (the Aptimize logo in the top left of the page).
Production - Configures the Website Accelerator for maximum production performance and reduces log output to critical errors only. (Note: a valid license is installed to switch to Production mode).
httpFetchTimeout: [optional]
The timeout value in milliseconds for internal WAX HTTP requests. [default = 3000]
loopbackPort [optional]
The integer port number (1-65535) that all requests should be proxied to. This is used in the configuration of WAX as a proxy.
Auto Versioning
autoVersionUrls [optional]
True - All URL’s that appear in link, script, or img tags in the HTML page will be automatically rewritten to include a version specific identifier. This allows aggressive client caching, with currency of resource changes.
False - URL’s will not be automatically versioned.
useAlternateAutoVersionUrlFormat [optional]
True - The automatic versioning scheme will be path based.
False - The automatic versioning scheme will be query string based.
Caching
diskCacheCleanupInterval [optional]
An integer value that represents the interval at which the disk cache cleanup process is run, in seconds. [minimum = 60, default = 60]
memoryCacheCleanupInterval [optional]
An integer value the represents the interval at which the memory cache cleanup process is run, in seconds. [minimum = 1, default = 1]
cacheMaxMemory [optional]
An integer value representing the maximum allowable use of memory for resource caching purposes in megabytes. [default = 100]
resourceSetCacheMaxAge [optional]
The maximum duration in seconds that sets composed of CSS or JS resources should be retained on disk before being removed. [default = 172800, i.e. 48 hours]
pageSpriteCacheMaxAge [optional]
The maximum duration in seconds that sets composed of HTML image resources should be retained on disk before being removed. [default = 2880, i.e. 8 hours]
cachePath [optional]
Any local or UNC path can be used to cache combined resources to disk when running in a single server or load balanced web server configuration.
Please refer to the section on production deployment for more information on how to use this setting.
resourceRecheckInterval [optional]
An integer number that defines the interval in seconds at which resources will be rechecked for changes when requested by a browser. (Note: the recheck is done in the background, so changes will sometimes take 2x this interval to show on the client) [default = 60, minimum = 1]
resourceClientCacheDuration [optional]
An integer number in seconds that defines how long resources at this location will be cached for on the client using the Expires header. [default = 7776000, i.e. 90 days; max = 31556926, i.e. 1 year]
Debugging
logInfoLevel [optional]
None – No logging will be performed (not recommended)
Error – Only errors that may impact the user experience of the site will be logged
Warning – Issues that are not critical, but may cause sub-optimal performance are logged
Trace – Detailed trace information is logged for the purposes of debugging
maxOptimizationsPerSecond [optional]
An integer number that defines the maximum number of optimizations the WAX should perform per second. This only includes pages that are accelerated by WAX - images and other cacheable resources do not count against this number. [default = 50]
virtualRoot [optional]
The virtual root path that resources the WAX serves should appear to come from – this will prefix the /wax.axd component of WAX resource URLs. Useful in situations where Layer 7 routing is used to direct traffic to specific sub-cluster in large clustered environments.
defaultCharset [optional]
The default character set to use when processing text content. Note: this is only used when the charset is not explicitly set in the Content-Type header of the response.
includeOriginalImageUrl [optional]
True – WAX will add a new attribute called waxsrc to each HTML image that is combined into an image set containing the original image URL, which can be referenced from script.
False – The original image URL will not be available via the waxsrc attribute.
includeFromDomains [optional]
ThisDomain – Any resource on the root domain of the request will be optimized.
SubDomain – Resources only on the exact sub-domain of the request will be optimized.
SpecifiedDomains – Resources on specified domains only will be optimized.
AllDomains – Resources on any domain will be optimized.
suppressedErrorCodes [optional]
A comma separated list of WAX error codes that should be suppressed at this location.