uCosminexus Application Server, Expansion Guide

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

7.6.1 Setting up the EADs server environment

With setting up the EADs server environment, place the JAR file used for setup of the EADs server and EADs session failover.

Organization of this subsection
(1) Setup of the EADs server
(2) Placing JAR file for EADs session failover

(1) Setup of the EADs server

Set the server definition file, cluster definition file, and startup configuration file provided by EADs. The table below describes the EADs parameters to be set, default values, and recommended values for each definition file. In the EADs parameters described in the table, set values by considering that the EADs server is used only in the EADs session failover functionality, as a prerequisite.

For details on setup procedures, see the Elastic Application Data store User Guide.

Server definition file

The following table describes the properties in the server definition file provided by EADs:

Table 7-29 EADs server settings recommended for the EADs session failover functionality (server definition file)

No. Properties of EADs Recommended values and operation of the EADs session failover functionality
Parameter name Contents Default value Recommended value Operation performed if you specify a value other than recommended value
1 eads.server.address Specify the IP address or host name of the EADs server. Make sure to specify this parameter.
The value to be specified must match with the IP address or host name specified in the webserver.eadssfo.eads.client.connection-destination-EADs-server-name.address key, which is set in the Easy Setup definition file. If you specify a different value, you cannot connect to the EADs server from the EADs client. As a result, initialization of the EADS client fails.
None -- None
2 eads.server.port Specify the port number to be used to communicate with EADs clients.
The value to be specified must match with the port number specified in the webserver.eadssfo.eads.client.connection-destination-EADs-server-name.port key, which is set in the Easy Setup definition file. If you specify a different value, you cannot connect to the EADs server from the EADs client. As a result, initialization of the EADS client fails.
24600 -- None
3 eads.server.max_connections Specify the number of maximum concurrent connections to the EADs server. 10 For details on recommended values, see 7.2.3 Setting up number of concurrent connections, number of concurrent executions, and connection pool size. None
4 eads.server.cache.max_execute_threads Specify the number of maximum concurrent executions of cache operation. Value of eads.server.max_connections For details on recommended values, see 7.2.3 Setting up number of concurrent connections, number of concurrent executions, and connection pool size. None
5 eads.server.function_container.max_execute_threads Specify the number of maximum concurrent executions of all user functions. Value of eads.server.max_connections For details on recommended values, see 7.2.3 Setting up number of concurrent connections, number of concurrent executions, and connection pool size. None
6 eads.prf.enable Specify whether to output to the performance analysis trace.
true: Output.
false: Do not output.
false true If you specify false, the performance analysis trace of the EADs server is not output. As a result, you cannot check a series of access from EADs session failover functionality to the EADs server.
7 eads.prf.keyInfo.enable Specify whether to include key information in the performance analysis trace.
true: Include.
false: Do not include.
false true If you specify false, key information is not output to the performance analysis trace of the EADs server. As a result, you cannot check whether correct key information is inherited on the EADs server.
8 eads.connection.buffersize Specify the read and write buffer size (bytes) of connection. 4096 4096 None
9 eads.connectionPool.poolsize Specify the maximum number of connections to be pooled for the same connection destination. For details, see 7.2.3 Setting up number of concurrent connections, number of concurrent executions, and connection pool size. 10 -- None
10 eads.connection.timeout Specify the monitoring time for connection confirmation and data transmission (milliseconds). For details, see 7.2.2 Setting up a timeout. 3000 -- None
11 eads.cluster.failureDetector.retry Specify the count of retries to be performed when connection for the survival check times out.
In this property, you must set an appropriate value according to the network environment. For details, see the Elastic Application Data store User Guide.
0 -- None
12 eads.cluster.failureDetector.port Specify the port number to be used for survival check between EADs servers.
In this property, you must set an appropriate value according to the network environment. For details, see the Elastic Application Data store User Guide.
24631 -- None
13 eads.cluster.assertive.threshold.percents Specify the percentage of number of EADs servers that determines that an EADs server is down.
If the number of EADs servers is less than one, round up to one. In the case of any other value, discard the numbers after the decimal point.
The value specified in this property affects the minimum number of servers required for continuing operations on EADs.
50 1
You can continue the operations until the last normal EADs server.
However, depending on the failure, it might be divided into multiple clusters and data consistency might be lost when updating the session thereafter.
For maintaining data consistency, monitor messages# of changing cluster configurations.
If a configuration is divided in multiple clusters, you must stop EADs servers in other clusters so as to make one cluster.
For details on measures for EADs servers, see 2.5.4 In case trouble occurs in the EADs session failover functionality in the uCosminexus Application Server Maintenance and Migration Guide.
--
14 eads.cluster.heartbeat.interval Specify the interval for sending heartbeats (milliseconds).
In this property, you must set an appropriate value according to the network environment. For details, see the Elastic Application Data store User Guide.
400 -- None
15 eads.cluster.heartbeat.timeout Specify the heartbeat timeout time (milliseconds).
In this property, you must set an appropriate value according to the network environment. For details, see the Elastic Application Data store User Guide.
2000 -- None

Legend:
--: No recommended value for the EADs session failover functionality.

#
If you change cluster configuration, the KDEA04524-I message of the EADs server is output.

Cluster definition file

The following table describes the properties of the cluster definition file provided by EADs:

Table 7-30 EADs server settings recommended for the EADs session failover functionality (cluster definition file)

No. Properties of EADs Recommended values and operation of EADs session failover functionality
Parameter name Contents Default value Recommended value Operation performed if you specify a value other than recommended value
1 eads.replication.factor Specify multiplicity of data. If multiplicity is more than the number of EADs servers that configure a cluster, the number of EADs servers that configure a cluster is set as multiplicity.
For this property, you must set an appropriate value by considering the availability of the system, required memory size, and communication overhead between EADs servers. For details, see the Elastic Application Data store User Guide.
2 -- None

Legend:
--: No recommended value for the EADs session failover functionality.

Startup configuration file

The following table describes the properties of the startup configuration file provided by EADs:

Table 7-31 EADs server settings recommended for the EADs session failover functionality (startup configuration file)

No. Properties of EADs Recommended values and operation of the EADs session failover functionality
Parameter name Contents Default value Recommended value Operation performed if you specify a value other than recommended value
1 eads.prf.level Specify the output level of prf trace. Detail level (0x40000000) Detail level (0x40000000) If you specify the standard level (0x00000000), a part of the performance analysis trace of the EADs server is not output. As a result, you cannot examine a series of access from the EADs session failover functionality to the EADs server.
2 eads.java.heapsize Specify the size of the Java heap (megabytes) in which the key is stored. 3072 A value, which is calculated with a calculation formula that estimates the Java heap size provided by EADs. For details, see the Elastic Application Data store User Guide.
For details on the size of the key and value used when using the EADs server, see 5.8.4 Estimating EADs server memory.
If you specify a value smaller than the recommended value, operation of application information or global session information on the EADs server might fail due to insufficient memory.
3 eads.java.external.heapsize Specify the size of the Explicit heap (megabytes) in which the value is stored. 3% of the size of the specified Explicit heap (rounded up after the decimal point) is used as the management area. 1024 A value, which is calculated with a calculation formula that estimates the Explicit heap size provided by EADs. For details, see the Elastic Application Data store User Guide.
For details on the size of the key and value used when using the EADs server, see 5.8.4 Estimating the EADs server memory.
If you specify a value smaller than the recommended value, operation of application information or global session information on the EADs server might fail due to insufficient memory.

(2) Placing JAR file for EADs session failover

For executing the processing of the EADs session failover functionality on an EADs server, place sfo-function.jar, which is stored in Application-Server-installation-directory\CC\sfo\eads\lib directory, in the following directory on all EADs servers existing in the EADs cluster.

EADs-server-installation-directory\servers\-EADs-server-name-\app