Hitachi

uCosminexus Application Server Compatibility Guide


5.9.3 Execution environment settings (When the Smart Composer functionality is not used)

This section describes the settings for viewing the top page by specifying the domain name.

When accessing a deployed Web application merely by specifying the domain name in the URL, the top pages of Web applications, such as index.html and index.jsp can be displayed.

Organization of this subsection

(1) How to set

To view the top page by specifying the domain name:

  1. Specify the root context.

    The root context is a context in which the name is not specified for the context root. The specification of the root context differs according to the operation mode.

    Use the server management commands to specify the root context when you define the J2EE application properties. To set the root context as the context root, specify a null character. For defining the context root for the J2EE application, see 9.11.1 Defining the context root of a J2EE application in the uCosminexus Application Server Application Setup Guide.

  2. Specify distribution of requests to the root context in the redirector.

    Specify the distribution of requests to the root context in mod_jk.conf when using Cosminexus HTTP Server as the Web server and in uriworkermap.properties when using Microsoft IIS as the Web server.

    For details on mod_jk.conf (redirector operation definition file for HTTP Server), see 14.2.2 mod_jk.conf (Redirector action definition file for Cosminexus HTTP Server).

    For details on uriworkermap.properties (mapping definition file for Microsoft IIS), see 14.2.3 uriworkermap.properties (Mapping definition file for Microsoft IIS).

(2) Example settings

An example of settings for distributing requests to the root context is as follows.

To view the top page of a Web application by specifying only the domain name in the URL, specify settings in the URL mapping definition of the redirector in such a way so that the requests are distributed to the root context. For example, to distribute root context to worker1 and /examples to worker2, specify as follows:

Example of mod_jk.conf (in Cosminexus HTTP Server)
JkMount /* worker1
JkMount /examples/* worker2
Example of uriworkermap.properties (In Microsoft IIS)
/*=worker1
/examples/*=worker2