uCosminexus Application Server, System Design Guide

[Contents][Glossary][Index][Back][Next]

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 used Method of setup Location of setup
Cosminexus HTTP Server (separation using the redirector module)#1 Smart 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 items Locations 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 items Settings#
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 items Method of setup Location 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.