5.2.3 User-defined file for setting the request distribution method (When the Smart Composer functionality is not used)
To distribute requests, edit the following user-defined files in a text editor and specify workers, mapping between the URL pattern and workers, and the redirector operations.
The files to be setup depend on the used Web server. The common user-defined files and the user-defined files for each Web server are separately described here. For details on the user-defined file httpsd.conf, see the manual uCosminexus Application Server HTTP Server User Guide. For details on other user definition files, see Part 3 Reference (V9 Compatibility Mode).
- Organization of this subsection
(1) Common user-defined files
The common user-defined files for Cosminexus HTTP Server and Microsoft IIS are as follows:
-
workers.properties (worker definition file)
Specify the worker definitions and the parameters for each worker.
The storage location of this file is as follows:
-
In Windows
Cosminexus-installation-directory\CC\web\redirector\workers.properties
-
In UNIX
/opt/Cosminexus/CC/web/redirector/workers.properties
-
-
usrconf.properties (user property file)
Set the communication timeout when the Web container receives a request from the redirector.
The storage location of this file is as follows:
-
In Windows
Cosminexus-installation-directory\CC\server\usrconf\ejbs\server-name\usrconf.properties
-
In UNIX
/opt/Cosminexus/CC/server/usrconf/ejb/server-name/usrconf.properties
-
(2) User-defined files for Cosminexus HTTP Server
The user-defined files for Cosminexus HTTP Server are as follows:
-
mod_jk.conf (redirector action definition file)
Specify the redirector operations for Cosminexus HTTP Server.
The storage location of this file is as follows:
-
In Windows
Cosminexus-installation-directory\CC\web\redirector\mod_jk.conf
-
In UNIX
/opt/Cosminexus/CC/web/redirector/mod_jk.conf
-
-
httpsd.conf (Cosminexus HTTP Server Definition file)
Specify the directive (parameter that defines the execution environment of the Web server) for defining the operating environment of Cosminexus HTTP Server.
The storage location of this file is as follows:
-
In Windows
Cosminexus-installation-directory\httpsd\conf\httpsd.conf
-
In UNIX
/opt/hitachi/httpsd/conf/httpsd.conf
-
(3) User-defined files for Microsoft IIS
The user-defined files for Microsoft IIS are as follows:
-
uriworkermap.properties (mapping definition file)
Specifies the mapping between the URL pattern and worker in Microsoft IIS.
The storage location of this file is as follows:
Cosminexus-installation-directory\CC\web\redirector\uriworkermap.properties
-
isapi_redirect.conf (redirector action definition file)
Specify the redirector operations for Microsoft IIS.
The storage location of this file is as follows:
Cosminexus-installation-directory\CC\web\redirector\isapi_redirect.conf
(4) Notes
The followings are the notes related to the user-defined files:
-
During the overwrite installation, the user-defined file is not overwritten.
-
For the processing of the worker definition file and the Web server definition file when performing the upgrade installation, see 10. Migrating from Application Server of Earlier Versions (In the J2EE Server Mode) in the uCosminexus Application Server Maintenance and Migration Guide.
-
The maximum number of characters in one line of the redirector definition file is 1,023. Specify settings within this character count.
-
In the following user-defined files, if several parameters are specified with the same name, the value of the parameter specified first is used for operations:
-
isapi_redirect.conf
-
workers.properties
-
uriworkermap.properties
-