uCosminexus Application Server, Expansion Guide
With setting up the EADs server environment, place the JAR file used for setup of the EADs server and EADs session failover.
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.
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 |
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 |
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. |
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
All Rights Reserved. Copyright (C) 2013, 2015, Hitachi, Ltd.