8.7.4 Tuning parameters for optimizing the operations of the Web application

This section explains how to set up the tuning parameters used for optimizing the operations of a Web application.

Organization of this subsection
(1) Tuning parameter for separating the deployment of the static contents and the Web application
(2) Tuning parameters for caching static contents
(3) Tuning parameters for distributing the requests using a redirector

(1) Tuning parameter for separating the deployment of the static contents and the Web application

Specify the separation of the deployment of the static contents and the Web application as the parameter of the file that defines the operations of the Web server. The setup locations, files and parameters differ depending on the type of Web server used.

When you use Cosminexus HTTP Server for a Web server integration, you use the redirector module for separation. When you use an in-process HTTP server, use the reverse proxy module deployed in the reverse proxy server (Cosminexus HTTP Server) for separation.

The following table explains the method and location of setup:

Table 8-41 Tuning parameters for separating the deployment of the static contents and the Web application

Web server to be usedMethod of setupLocation of setup
Cosminexus HTTP Server (separation using the redirector module)#1Smart Composer functionality
Definition file
Easy Setup definition file
Setup target
Logical Web server (web-server)
Parameter name
JkMount
In-process HTTP server
(separation using the reverse proxy module)
Edit file
Definition file
httpsd.conf
Setup target
Reverse proxy server
Parameter name
ProxyPass directive#2
#1
Specify in uriworkermap.properties, if you are using Microsoft IIS as a Web server.
#2
For details about httpsd.conf, see the uCosminexus Application Server HTTP Server User Guide.(3)

(2) Tuning parameters for caching static contents

The tuning parameters for cache of static contents are explained below. These tuning parameters are set for each Web container or Web application.

The following table describes how to set up the tuning parameters for each Web container. You specify these items using the Smart Composer functionality.

Table 8-42 Tuning parameter for caching static contents (items to be set for each Web container)

Setup itemsLocations of setup
Select whether static contents cache is to be used
Definition file
Easy Setup definition file
Setup target
Logical J2EE server (j2ee-server)
Parameter name
webserver.static_content.cache.enabled
Setup of maximum memory size for each Web application
Definition file
Easy Setup definition file
Setup target
Logical J2EE server (j2ee-server)
Parameter name
webserver.static_content.cache.size
Setup of maximum file size of the static contents for cache
Definition file
Easy Setup definition file
Setup target
Logical J2EE server (j2ee-server)
Parameter name
webserver.static_content.cache.filesize.threshold

The tuning parameters to be set for each Web application are described below. Set the items in the Web application either directly by editing web.xml or using the server management commands. Edit web.xml for setting the items in the Web application before deployment. You use the server management command (cjsetappprop) for setting the items in the Web application after deployment.

The following table describes the settings:

Table 8-43 Tuning parameters for caching of static contents (items to be set for each Web application)

Setup itemsSettings#
Select whether to use the cache of static contents
param-name tag
com.hitachi.software.web.static_content.cache.enabled
param-value tag
(Setup value)
Setup of maximum size of memory for each Web application
param-name tag
com.hitachi.software.web.static_content.cache.size
param-value tag
(Setup value)
Setup of maximum file size of the static contents for caching
param-name tag
com.hitachi.software.web.static_content.cache.filesize.threshold
param-value tag
(Setup value)
Note
For details about the values that can be specified in (setup value), see 2.21.2 Definitions in DD (Settings for each Web application) in the uCosminexus Application Server Web Container Functionality Guide.
#
For directly editing web.xml, add <context-param> tag within the <web-app> tag and add the <param-name> and <param-value> tags within the <context-param> tag.
To use the server management commands, add <context-param> tag within the <hitachi-war-property> tag of the WAR property file and add <context-param> and <param-value> tags within the <context-param> tag.

(3) Tuning parameters for distributing the requests using a redirector

Specify the tuning parameters for distributing the requests using a redirector as the parameters of the file that defines the operations of the Web server.

You can specify this definition only when integrating with a Web server. You cannot specify this definition when you are using an in-process HTTP server.

The following table describes the method and location of setup:

Table 8-44 Tuning parameters for distributing the requests by using a redirector

Setup itemsMethod of setupLocation of setup
Mapping definition of URL pattern#Smart Composer functionality
Definition file
Easy Setup definition file
Setup target
Logical J2EE server (j2ee-server)
Parameter name
JkMount
#
When you are using Microsoft IIS as the Web server, specify in uriworkermap.properties.