uCosminexus Application Server, System Setup and Operation Guide

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

4.8.2 Notes on setting Easy Setup definition file (when using other functionality)

This subsection describes the notes on setting a system for using the following functions of Application Server in Easy Setup definition file by using the Smart Composer functionality.

Organization of this subsection
(1) When using CTM based Scheduling functionality in the system for executing J2EE applications
(2) When using in-process HTTP server
(3) When using memory session failover functionality
(4) Notes common for each functionality

(1) When using CTM based Scheduling functionality in the system for executing J2EE applications

If the system uses CTM, you must define a client that sends requests to CTM. Besides Web front system that is set up by using the Smart Composer functionality or the management portal, you can use EJB client, or a unique user-defined Web system, as a client.

You must define the integrated naming scheduler server and Application Server with the Easy Setup definition file when you use the integrated naming scheduler server (host to which the global CORBA Naming Service is allocated) to set up a system with the integrated naming scheduler server model. Define the integrated naming scheduler server and Application Server respectively on different Web systems. Also, if you want to use a Web front system set up by using the Smart Composer functionality, as a system for sending the requests to CTM; you must define a Web system different from the Web system used in the scheduling functionality.

You must define the following items in Easy Setup definition file for each Web system.

(a) Web system for Application Server (CTM)

This Web system defines Application Server.

(b) Web system for integrated naming scheduler server

This Web system is required when you set up a system with the integrated naming scheduler server model. This Web system defines the integrated naming scheduler server (computer to which the global CORBA Naming Service is allocated).

(2) When using in-process HTTP server

You must define the following items in Easy Setup definition file. Note that you cannot use the load balancer in the j2ee-tier. Therefore, delete the load balancer definition. If you want to use the load balancer, use the management portal to set up the system.

(3) When using memory session failover functionality

You must define the following items in Easy Setup definition file. Note that the memory session failover functionality is the compatibility functionality.

(4) Notes common for each functionality

You can allocate multiple service units to a single host when using any of the functionalities. You however cannot allocate multiple service units of the same CTM domain to the same host. Following are the notes on allocating multiple service units to a single host:

(a) Notes on logical server settings

If you allocate multiple service units to a single host, multiple logical servers of the same type exist within the same host. Therefore, while creating Easy Setup definition file, do not specify a duplicate value for the following items in the configuration of each logical server.

Table 4-41 Items to be set without duplicating the values for each logical server

Logical server type Item param-name specification value
Web server http port number Listen
J2EE server Port number of the management server ejbserver.http.port
Port number of ajp13 webserver.connector.ajp13.port
https port number webserver.connector.redirect_https.port
Port number of in-process naming service ejbserver.naming.port
Port number of in-process HTTP server webserver.connector.inprocess_http.port
Fixed port number of JTA recovery ejbserver.distributedtx.recovery.port
Port number of RMI registry ejbserver.rmi.naming.port
Performance Tracer PRF identifier PRFID
SFO server Port number of the management server ejbserver.http.port
Port number of ajp13 webserver.connector.ajp13.port
Port number of in-process naming service ejbserver.naming.port
Port number of RMI registry ejbserver.rmi.naming.port
Smart agent Port number monitored by the smart agent smartagent.port
CTM domain manager CTM domain name to which the CTM domain manager belongs ctmdomname
CTM execution environment directory ctmspool
Port number used by CTM domain manager to exchange CTM domain configuration information cdm.port
CTM CTM identifier ctmid#
Port number used by CTM ctm.port
Port number of the naming service corresponding to CTM ctm.ns.port

#
You can opt not to set ctmid. If you do not set ctmid, Management Server automatically sets a value that is unique across the hosts.

Reference note
You can set the same value to the same type of the logical server in each service unit, when you do not want to concurrently run multiple service units on a single host.

The definition configuration of setting items differs depending on the Web system to which the service unit allocated to the host belongs.

(b) Notes on the port numbers of Web server

When you allocate multiple service units to a service machine, there are following limitations for changing the port numbers of the Web server. Note that these limitations are equally applicable when multiple service units exist on the same Web system or on different Web systems.

When same port number is set for Web servers of multiple service units

You can set the same port number for Web servers of each service unit, when you do not want to concurrently run multiple service units on a single server machine.

Use any of the following procedures to do the changes:

 
Note
If you change the port numbers of Web servers of some service units, the port numbers of other service units get deleted, and you can no more use those Web servers. Be sure to change the port numbers of Web servers of other service units later.
When different port numbers are set for the Web servers of multiple service units

In the following example, the port number of the Web server of service unit 1 (unit1) is 80, while that of service unit 2 (unit2) is 81. The following table describes how to change the settings of a port number and also the possibility of doing the changes:

Table 4-42 How to change a port number, and the possibility of doing the changes

Method to change the port number Settings to be done in the Configuration Change definition file used for changing the parameters of the logical server Changed port number of the Web server Change possibility (Y/N)
unit1 unit2
Changing the port number of the Web server of each service unit to the same number Set port number 81 in the Web server of service unit 1. 81 81 Y
Set port number 80 in the Web server of service unit 2. 80 80 Y
Replacing the port number of the Web server of each service unit Set port number 81 in the Web server of service unit 1 and 80 in the Web server of service unit 2. 81 80 N
Changing the port number of the Web server of one service unit to the port number of the other service unit, and changing the Web server of the other service unit to the unused port number (example: 82) Set port number 81 in the Web server of service unit 1 and 82 in the Web server of service unit 2. 81 82 N
Set port number 82 in the Web server of service unit 1 and 80 in the Web server of service unit 2. 82 80 N
Change the port number of the Web server of a service unit to an unused port number (example: 82) Set port number 82 in the Web server of service unit 1. 82 81 Y
Set port number 82 in the Web server of service unit 2. 80 82 Y

Legend:
Y: Change is possible
N: Change is not possible

Reference note
You cannot change the preset port number with a single operation. You must execute a set of operations such as setting an unused port number once and then switching to the preset number, and changing the port number in multiple steps.