Hitachi

uCosminexus Application Server Compatibility Guide


11.1.1 usrconf.properties (User property file for J2EE servers)

Organization of this subsection

(1) Keys beginning with cosminexus.jpa

The following table lists the specifiable keys. Note that Default value is the value that is assumed when a key is not specified.

VR is the version of Application Server on which the keys are introduced or changed.

Key name

Contents

Default value

VR

cosminexus.jpa.logging.level.operation.category

Specify the log level for each category of the JPA provider operation log, when you are using the JPA functionality of the J2EE server. The category name and log level are case sensitive.

If this key is not specified, the log is not output to the operation log. Since this affects the security and performance, take care when you specify the output level settings.

If you specify Off:

The log is not output to the JPA provider operation log.

If you specify Information:

The JPA operation information is output to the JPA provider operation log.

If you specify Detail:

The detailed JPA operation information and the information that was output to Information is output to the JPA provider operation log.

Off

08-00

cosminexus.jpa.exception.logging.sql#

Specify whether the exception message will include the SQL statement that caused the exception, when the JPA provider executes the SQL statement and receives an exception from the database.

If you specify Off:

The SQL statement executed by the JPA provider and the value specified for the ? parameter (place holder) is not included in the exception message.

If you specify Information:

The SQL statement executed by the JPA provider is included in the exception message.

If you specify Detail:

The SQL statement executed by the JPA provider and the value specified for the ? parameter (place holder) is included in the exception message.

Off

08-00

#

The values specified in this property are also applied to the contents output to the exception log.

For Information and Detail, the contents of the SQL statement and the ? parameter (place holder) is also output to the exception log; and therefore, you consider the security. Specify the values as and when required for development and maintenance.

When handling binary data, the hash value of the binary object is output to the ? parameter (place holder).

Before you complete the preparation for issuing an SQL statement, if a failure occurs in acquiring a connection due to communication errors, you might not be able to acquire value of the ? parameter (place holder).

(2) Keys beginning with ejbserver.jpa

The following table lists the specifiable keys. Note that Default value is the value that is assumed when a key is not specified.

VR is the version of Application Server on which the keys are introduced or changed.

Key name

Contents

Default value

VR

ejbserver.jpa.defaultJtaDsName

Specify the default JTA data source references. This property is used when jta-data-source is not specified in persistence.xml or when a space is specified.

None

08-00

ejbserver.jpa.defaultNonJtaDsName

Specify the default non-JTA data source references. This property is used when non-jta-data-source is not specified in persistence.xml or when a space is specified.

None

08-00

ejbserver.jpa.defaultProviderClassName

This property specifies the default JPA provider class name. This property is used when provider is not specified in persistence.xml or when a space is specified.

com.hitachi.software.jpa.PersistenceProvider

08-00

ejbserver.jpa.disable#

Specify this property when using the JPA functionality of Application Server.

If you specify true:

The JPA functionality of Application Server is disabled.

If you specify false:

The JPA functionality of Application Server is enabled.

false

08-20

ejbserver.jpa.overrideJtaDsName

Specify the JTA data source references that will be used with a higher priority than the values specified in jta-data-source in persistence.xml and the values specified in ejbserver.jpa.defaultJtaDsName.

None

08-00

ejbserver.jpa.overrideNonJtaDsName

Specify the non-JTA data source references that will be used with a higher priority than the values specified in non-jta-data-source in persistence.xml and the values specified in ejbserver.jpa.defaultNonJtaDsName.

None

08-00

ejbserver.jpa.overrideProvider

Specify the JPA provider class name that will be used with a higher priority than the values specified in provider in persistence.xml and the values specified in ejbserver.jpa.defaultProviderClassName.

None

08-00

ejbserver.jpa.emfprop.property-key

Specify the JPA provider-specific property keys. When all the persistence units are deployed, the properties with the prefix ejbserver.jpa.emfprop. removed will be passed to the JPA provider.

None

08-00

#

Notes for specifying ejbserver.jpa.disable=true

If the application includes persistence.xml, Application Server does not read persistence.xml when the application starts. Also, if you are using the reload functionality of the application, update detection is not performed for persistence.xml.

If the application is using a managed persistent context or persistent unit of Application Server, you will not be able to start the application.

(3) Keys beginning with ejbserver.logger

The following table lists the specifiable keys. Note that Default value is the value that is assumed when a key is not specified.

VR is the version of Application Server on which the keys are introduced or changed.

Related information is the reference location for information related to the specified key. uCosminexus Application Server is omitted from the manual names.

Key name

Contents

Default value

VR

Related information

ejbserver.logger.channels.define.channel-name#.filenum

Specify an integer from 1 to 16 for the number of log files of a J2EE server.

  • 16, when the channel name is WebAccessLogFile

  • 4, when the channel name is MaintenanceLogFile or WebServletLogFile

  • 2, when the channel name is other than above

--

ejbserver.logger.channels.define.channel-name#.filesize

Specify an integer from 4096 to 2147483647 (units: bytes) for the size of the log files of a J2EE server.

  • 2097152, when the channel name is WebAccessLogFile

  • 16777216, when the channel name is MaintenanceLogFile

  • 4194304, when the channel name is WebServletLogFile

  • 1048576, when the channel name is other than above

--

Legend:

--: Indicates a version earlier than the version 08-00.

Blank cell: Related information does not exist.

#

You can set the following names as channel name:

  • Channels for output of Cosminexus system log:

    MessageLogFile, MaintenanceLogFile, ExceptionLogFile, ConsoleLogFile, EJBContainerLogFile, WebContainerLogFile, WebServletLogFile, UserOutLogFile, UserErrLogFile, WebAccessLogFile, JPAOperationLogFile, JPAMaintenanceLogFile

  • Channels for output of resource depletion monitoring log

    MemoryWatchLogFile, FileDescriptorWatchLogFile, ThreadWatchLogFile, ThreaddumpWatchLogFile, RequestQueueWatchLogFile, HttpSessionWatchLogFile, ConnectionPoolWatchLogFile

For details about the acquisition of documents, see 2.3 Acquiring the Data in the manual uCosminexus Application Server Maintenance and Migration Guide.

(4) Keys beginning with ejbserver.server

The following table lists the specifiable keys. Note that Default value is the value that is assumed when a key is not specified.

VR is the version of Application Server on which the keys are introduced or changed.

Related information is the reference location for information related to the specified key. uCosminexus Application Server is omitted from the manual names.

Key name

Contents

Default value

VR

Related information

ejbserver.server.eheap.ajp13.enabled

Specify whether to deploy the objects for communication with the redirector on the Explicit heap.

If you specify true:

The objects for communication with the redirector will be deployed on the Explicit heap.

If you specify false:

The objects for communication with the redirector will be deployed on the Java heap area.

However, if JavaVM option HitachiUseExplicitMemory is disabled, this property is disabled (same as for the case when false is specified).

true

08-00

Legend:

Blank cell: Related information does not exist.

(5) Keys beginning with webserver.connector

The following table lists the specifiable keys. Note that Default value is the value that is assumed when a key is not specified.

VR is the version of Application Server on which the keys are introduced or changed.

Related information is the reference location for information related to the specified key. uCosminexus Application Server is omitted from the manual names.

Key name

Contents

Default value

VR

Related information

webserver.connector.ajp13.backlog

Specify the maximum number of rows and columns awaiting connection requests from the redirector. Specify the value using an integer from 1 to 2147483647.

The valid maximum value becomes the maximum value of the Listen queue in the Socket specifiable on the platform to be used. The actual maximum value of the Listen queue depends on the OS. For details, see the manuals for the listen functionality in each OS.

The value specified in this key is set in the backlog argument of java.net.ServerSocket class constructor. If, however, this specified value exceeds the limit value set for the OS, it is interpreted as the limit value of the OS, and it therefore does not result in an error. The limit value is different for every OS. For details on how to extend the limit value, see the OS manual.

100

--

webserver.connector.ajp13.bind_host

Specify the IP address or the host name used for Web server integration.

The single-byte space before and after the IP address or the host name is ignored. If you do not specify a value, the wild card address is used.

When specifying this property, you need to specify the local host name or the IP address even in the worker host name.

In a configuration wherein a Web server is integrated with another Web server running on the same host, the Web Container cannot receive requests from the Web server if either of the following settings is specified:

  • The local host name or IP address is specified in the webserver.connector.ajp13.bind_host property, and the loopback address of a host, such as localhost, is specified in the worker host name of the redirector.

  • The loopback address of a host, such as localhost, is specified in the webserver.connector.ajp13.bind_host property, and the local host name or IP address is specified in the worker host name of the redirector.

None

--

5.7 Specifying the IP address (Web server integration)

webserver.connector.ajp13.max_threads

Specify the concurrently executing number of requests being processed by the Web container.#1

Specify the value using an integer from 1 to 1024.

Number of threads equal to the concurrently executing number of specified requests is generated when the server is started.

10

--

Web Container Functionality Guide

webserver.connector.ajp13.port

Specify the port number used for communication with the Web server.

Specify the value using an integer from 1 to 65535.

You cannot specify a port number that is already being used or secured for another application. Furthermore, do not specify the same value in port numbers of the ports to be used to communicate with the Web server in multiple J2EE servers. The cjstartsv command cannot start up multiple J2EE servers in which identical port numbers are specified.

8007

--

webserver.connector.ajp13.receive_timeout

Specify an integer from 0 to 3600 (units: seconds) for the period to await a response (communication timeout value) from the redirector, while the data request is being processed in the redirector (that processes requests).

If you specify 0, the waiting period continues until a response is received from the redirector and the timeout will not occur.

600 (seconds)

--

webserver.connector.ajp13.send_timeout

Specify an integer from 0 to 3600 (units: seconds) for the timeout value for sending response.

If you specify a non-numeric value, or a numeric value outside the range, a message will be output and the default value will be used.

If 0 or a time period longer than the resend timer of data transmission present in the TCP is set, the timeout value will be the timeout value of the TCP. In such a case, a message indicating that an invalid timeout value has been specified will not be output.

600

--

webserver.connector.inprocess_http.backlog

Specify an integer from 1 to 2147483647 for the length of the TCP listen queue that saves the connection requests from the Web client.

The maximum valid specified value or the length of the TCP listen queue that is actually set, is different for every OS.

If you specify a non-numeric value, a numeric value outside the range, a null character string, or a whitespace#2, a message is output and the default value will be set.

511

--

webserver.connector.inprocess_http.bind_host

Specify the IP address or the host name used in an in-process HTTP server.

The single-byte space before and after the IP address or the host name is ignored. If you do not specify a value, the wild card address is used.

If the specified host name or the IP address cannot be resolved and if you specify the name or IP address of a host that is not local, a message is output and the wild card address is used.

None

--

webserver.connector.inprocess_http.enabled

Specify whether to enable the in-process HTTP server functionality.

If you specify true:

The in-process HTTP server functionality will be enabled.

If you specify false:

The in-process HTTP server functionality will be disabled.

If you specify a string other than true or false or if you specify a null character string or a whitespace#2, a message is output and the default value will be set.

Note that, if the in-process HTTP server functionality is enabled, Web server integration cannot be used.

false

--

webserver.connector.inprocess_http.enabled_methods

Specify the HTTP methods that have access permission.

When specifying multiple methods, demarcate them with a comma (,). In the method name, specify the method that has been defined in HTTP/1.1.

If you specify an asterisk (*), all methods are permitted.

HTTP methods are case-sensitive so the value specified in this property is also case-sensitive.

In the method name, you need to use the value provided in RFC2616. You cannot, however, specify the string "*" as a method name.

The whitespace#2 before and after each method name is ignored. If you specify an invalid value, a null character string, or a whitespace#2, a message is output and the default value will be set.

GET, HEAD, POST, PUT, DELETE, OPTIONS

--

webserver.connector.inprocess_http.error_custom.list

Specify the definition name for error page customization used in the error page customization functionality.

The maximum length of the value that can be specified is 1024 characters. Specify a string consisting of alphanumeric characters (A-Z, a-z, 0-9) or underscores (_). The string length of one definition name is from 1 to 32 characters.

When specifying multiple definition names, demarcate them with a comma (,). The whitespace#2 before and after the comma is ignored. The same definition name for error page customization cannot be specified multiple times.

If you specify an invalid value, a message is output and all the definitions for error page customization are disabled.

None

--

webserver.connector.inprocess_http.error_custom.error-page-customization-definition-name.file

Specify an absolute path for the file used as the response body during error page customization with the error page customization functionality.

Use a forward slash (/) as the demarcation sign in the path.

If this property is set by using the definition name for error page customization that has not been specified in webserver.connector.inprocess_http.error_custom.list, the property is disabled.

In the definition name for error page customization specified in webserver.connector.inprocess_http.error_custom.list, make sure that you specify either this property, or webserver.connector.inprocess_http.error_custom.error-page-customization-definition-name.redirect_url. If you specify both the properties or if you do not specify any of the properties, or if you do not specify as an absolute path, or if you specify a file that does not exist, or a file for which there is no read permission, a message is output and this definition for error page customization is disabled.

If you specify a null character string, or a whitespace#2, the property is disabled.

None

--

webserver.connector.inprocess_http.error_custom.error-page-customization-definition-name.file.content_type

Specify the value of Content-Type header of the response during error page customization using the error page customization functionality.

If this property is set by using the definition name for error page customization that is not specified in webserver.connector.inprocess_http.error_custom.list, the property is disabled.

If webserver.connector.inprocess_http.error_custom.error-page-customization-definition-name.file is not set, the property is disabled.

text/html

--

webserver.connector.inprocess_http.error_custom.error-page-customization-definition-name.redirect_url

Specify the redirect URL as an absolute path using the error page customization functionality.

If this property is set by using the definition name for error page customization that is not specified in webserver.connector.inprocess_http.error_custom.list, the property is disabled.

In the definition name for error page customization specified in webserver.connector.inprocess_http.error_custom.list, make sure that you specify either this property or webserver.connector.inprocess_http.error_custom.error-page-customization-definition-name.file.

Whether the value is correct is not verified, so you need to check through actual operations.

None

--

webserver.connector.inprocess_http.error_custom.error-page-customization-definition-name.request_url

Specify an absolute path beginning with a forward slash (/) for the request URL that applies the error page customization with the error page customization functionality. You can specify the wild card (*) only once, immediately after the forward slash. An asterisk (*) is always interpreted as the wild card, so it cannot be used as a normal character.

The value specified in this property and the value specified in webserver.connector.inprocess_http.error_custom.error-page-customization-definition-name.status, must not match with any other definition for error page customization.

If this property is set by using the definition name for error page customization that is not specified in webserver.connector.inprocess_http.error_custom.list, the property is disabled.

If you specify an invalid value, a message is output and this definition for error page customization is disabled.

/*

--

webserver.connector.inprocess_http.error_custom.error-page-customization-definition-name.status

Use the error page customization functionality and specify an integer from 400 to 599 for the response status code that performs error page customization.

The value specified in this property and the value specified in webserver.connector.inprocess_http.error_custom.error-page-customization-definition-name.request_url, must not match with any other definition for error page customization.

If this property is set by using the definition name for error page customization that is not specified in webserver.connector.inprocess_http.error_custom.list, the property is disabled.

Make sure that you specify this property for setting the definition name for error page customization that has been specified in webserver.connector.inprocess_http.error_custom.list. If you do not specify this property, or if you specify an invalid value, a message is output and this definition for error page customization is disabled.

None

--

webserver.connector.inprocess_http.gateway.host

Specify the host name or the IP address of the gateway. When requests without a Host header are redirected to files, such as the welcome file, the host name of the URL specified in the Location header becomes the specified value.

None

--

webserver.connector.inprocess_http.gateway.port

Specify the port number of the gateway by using an integer from 1 to 65535.

If a request has no Host header and the request is to be redirected to a location such as a welcome file, the port number portion of the URL that is specified in the Location header becomes the specified value.

This property specification is ignored when webserver.connector.inprocess_http.gateway.host is not specified.

If webserver.connector.inprocess_http.gateway.host is specified and this property is omitted, the following value is set:

  • If you specify true for webserver.connector.inprocess_http.gateway.https_scheme: 443

  • If you specify false for webserver.connector.inprocess_http.gateway.https_scheme: 80

If a string other than a numeric value or a numeric value outside the valid range is specified, a message appears and the value is considered not to have been specified.

None

--

webserver.connector.inprocess_http.gateway.https_scheme

When a client request uses https as a scheme, and the scheme for a Web server will become http by using an SSL accelerator, specify true.

If you specify true:

https is assumed to be used as the scheme for requests sent to the Web server.

If you specify false:

No action occurs.

If you specify a string other than true or false or if you specify a null character string or a whitespace#2, a message is output and the default value will be set.

false

--

webserver.connector.inprocess_http.hostname_lookups

Specify whether the Web container should perform reverse lookup of the host name and convert the IP address of the client to the host name, for a request received by the in-process HTTP server.

The throughput, however, will decline In the case of reverse lookup of the host name.

If the host name is not resolved, the result of the getRemoteHost() method of javax.servlet.ServletRequest interface and the client IP address output to the log file will be in the format wherein a dot (.) is used for demarcation.

If you specify true:

The IP address will be converted to the host name.

If you specify false:

The IP address will not be converted to the host name.

If you specify a string other than true or false or if you specify a null character string or a whitespace#2, a message is output and the default value will be set.

false

--

webserver.connector.inprocess_http.init_threads

Specify an integer from 1 to 1024 for the number of request processing threads of in-process HTTP server, generated when the server is started.

The specified value must be lower than the maximum number of connections with the Web client (value specified in webserver.connector.inprocess_http.max_connections). If you specify a value greater than the maximum number of connections with the Web client, a message is output and the maximum number of connections with the Web client is set as the value.

Furthermore, the maximum valid value differs based on the OS.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

10

--

webserver.connector.inprocess_http.keep_start_threads

Specify whether to maintain the number of threads that are created when the server is started.

If you specify true:

The number of threads created when the server is started will be maintained. Even if the number of spare threads maintained in the pool exceeds the maximum number of spare threads (value specified in webserver.connector.inprocess_http.max_spare_threads), the number of threads created during the startup of the server will not be reduced.

If you specify false:

The number of threads created when the server is started will not be maintained. Adjustment will be made on the basis of the maximum number and the minimum number of threads maintained as spare threads.

If the number of threads created when the server is started is lesser than the minimum number of spare threads (value specified in webserver.connector.inprocess_http.min_spare_threads), the number of threads is maintained as per the value specified in the minimum number of spare threads, irrespective of the settings in this property.

If you specify false in this property, adjustment is done so that the threads created when the server is started become lesser than the maximum number of spare threads. If the request-processing threads created when a server is started are greater than the maximum number of spare threads, the threads exceeding the maximum number of spare threads get destroyed one by one at an interval of one second after the server is started.

If you specify a string other than true or false or if you specify a null character string or a whitespace#2, a message is output and the default value will be set.

false

--

webserver.connector.inprocess_http.limit.max_headers

Specify an integer from 0 to 32767 for the upper limit of the number of HTTP headers included in the HTTP requests. If you do not want to set the upper-limit value, specify 0.

Even if the number of HTTP headers specified in this property is not met, an error occurs if the size specified in webserver.connector.inprocess_http.limit.max_request_header is exceeded.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

100

--

webserver.connector.inprocess_http.limit.max_request_body

Specify an integer from -1 to 2147483647 (units: bytes) for the maximum size of the request body of an HTTP request. If you do not want to set the upper-limit value, specify -1. If the request body is sent in chunk format, the size of the chunk header also needs to be included in the specified size.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

-1

--

webserver.connector.inprocess_http.limit.max_request_header

Specify an integer from 7 to 65536 (units: bytes) for the maximum size of the request header of an HTTP request.

Even if the maximum size of the request header that has been set in this property is not met, an error occurs if the HTTP header specified in webserver.connector.inprocess_http.limit.max_headers is exceeded.

The linefeed characters (double bytes of CR(0x0d)+LF(0x0a)) indicating the end of the HTTP header also need to be included in the specified size.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

16384

--

webserver.connector.inprocess_http.limit.max_request_line

Specify either -1 or an integer from 7 to 8190 for the maximum length (units: bytes) of the request line. If you do not specify the upper-limit, specify -1. The request line includes URI and HTTP version that include the HTTP methods and the query strings.

The value to be specified needs to be lower than the maximum size of the request header (value specified in webserver.connector.inprocess_http.limit.max_request_header). If you specify a value greater than the maximum size of the request header, a message is output, and the maximum size of the request header is set as the maximum length of the request line.

The linefeed characters (double bytes of CR(0x0d)+LF(0x0a)) indicating the end of the HTTP header also need to be included in the size to be specified.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

8190

--

webserver.connector.inprocess_http.max_connections

Specify an integer from 1 to 1024 for the maximum number of connections with the Web client. The valid maximum value is different for every operating OS.

The value specified in this parameter becomes the maximum value for the request-processing threads.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

100

--

webserver.connector.inprocess_http.max_execute_threads

Specify an integer from 1 to 1024 for the number of concurrently executing requests processed by the Web container.

The specified value must be lower than the maximum number of connections with the Web client (value specified in webserver.connector.inprocess_http.max_connections). If you specify a value greater than the maximum number of connections with the Web client, a message is output and the maximum number of connections with the Web client is set in the value.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

10

--

webserver.connector.inprocess_http.max_spare_threads

Specify an integer from 1 to 1024 for the maximum number of spare threads stored in a pool.

The specified value must be lower than the maximum number of connections with the Web client (value specified in webserver.connector.inprocess_http.max_connections). If you specify a value greater than the maximum number of connections with the Web client, a message is output and the maximum number of connections with the Web client is set in the value.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

20

--

webserver.connector.inprocess_http.min_spare_threads

Specify an integer from 1 to 1024 for the minimum number of spare threads stored in a pool.

The specified value needs to be lower than the maximum number of spare threads stored in the pool (value specified in webserver.connector.inprocess_http.max_spare_threads). If a value greater than the maximum number of spare threads stored in the pool is set, a message is output, and the maximum number of spare threads stored in the pool is set as the minimum number of spare threads stored in the pool.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

5

--

webserver.connector.inprocess_http.permitted.hosts

Specify the IP address (decimals) or the name of the host that has access permission for the in-process HTTP server. If you specify multiple hosts, demarcate the IP addresses or the host names with a comma (,). If there are no access restrictions, specify only an asterisk (*).

Note that even if the local host (the address#3 associated with localhost) is not explicitly specified, access is always allowed.

If you specify a null character string or a whitespace#2, a message is output and the default value will be set.

If the specified host name cannot be resolved, a message is output and only access from the local host (the address#3 associated with localhost) is allowed.

Note that the single-byte space before and after the IP address or the host name is ignored.

*

--

webserver.connector.inprocess_http.persistent_connection.max_connections

Specify an integer from 0 to 1024 for the maximum number of TCP connections maintained in a Persistent Connection.

The value to be set must be lower than the maximum number of connections with the Web client (value specified in webserver.connector.inprocess_http.max_connections). If you set a value greater than the maximum number of connections with the Web client, a message is output and the maximum number of connections with the Web client is set as the maximum number of TCP connections stored in the Persistent Connection.

If you specify a non-numeric value or a numeric value outside the range, a message is output and the value specified in webserver.connector.inprocess_http.max_connections is set as the default value. If you specify a null character string or a whitespace#2, the value specified in webserver.connector.inprocess_http.max_connections is set as the default value.

Value specified in webserver.connector.inprocess_http.max_connections

--

webserver.connector.inprocess_http.persistent_connection.max_requests

Specify an integer from 0 to 2147483647 for the upper limit of the number of serial connections when TCP connections are sustained by a Persistent Connection. If you do not want to set the upper-limit value, specify 0.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

100

--

webserver.connector.inprocess_http.persistent_connection.timeout

Specify an integer from 0 to 3600 for the request wait period (units: seconds), when the TCP connections are sustained in a Persistent Connection. If you specify 0, the timeout does not occur.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

3

--

webserver.connector.inprocess_http.port

Specify an integer from 1 to 65535 for the port number used by the in-process HTTP server. You cannot specify a port number that is already being used by another application. If you specify a port number that is in use or has been secured by another application, a message is output and the J2EE server does not start.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

80

--

webserver.connector.inprocess_http.receive_timeout

Specify an integer from 0 to 3600 for the period until timeout (units: seconds), when requests are received from the Web client. If you specify 0, the timeout does not occur.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

300

--

webserver.connector.inprocess_http.redirect.redirect-definition-name.file

Specify an absolute path for the file used as the response body during redirection with the redirect functionality. Use a forward slash (/) as the demarcation sign in the path.

If you specify 200 in webserver.connector.inprocess_http.redirect.redirect-definition-name.status, always specify this property. If you specify 200 in webserver.connector.inprocess_http.redirect.redirect-definition-name.status, and this property is not specified, a message is output and this redirect definition is disabled.

If you set this property by using a redirect definition name that is not specified in webserver.connector.inprocess_http.redirect.list and if you specify a null character string or a whitespace#2, the property is disabled.

If you specify a value that is not an absolute path, a message is output and this redirect definition name is disabled. If you specify a file that does not exist or a file that does not have read permission, a message is output and this redirect definition is disabled.

None

--

webserver.connector.inprocess_http.redirect.redirect-definition-name.file.content_type

Specify the value of the response Content-Type header during redirection, using the redirect functionality.

If this property is set by using a redirect definition name that is not set in webserver.connector.inprocess_http.redirect.list, the property is disabled.

If the webserver.connector.inprocess_http.redirect.redirect-definition-name.file is not set, this property is disabled.

text/html

--

webserver.connector.inprocess_http.redirect.redirect-definition-name.redirect_url

Specify the redirect URL as an absolute URL, using the redirect functionality.

If you specify 200 in webserver.connector.inprocess_http.redirect.redirect-definition-name.status, this property cannot be set. If you specify 200 in webserver.connector.inprocess_http.redirect.redirect-definition-name.status, and you specify this property, a message is output and the redirect definition name is disabled.

If you specify a value other than 200 in webserver.connector.inprocess_http.redirect.redirect-definition-name.status, make sure that you specify this property. If you specify a value other than 200 in webserver.connector.inprocess_http.redirect.redirect-definition-name.status and this property is not specified, a message is output and the redirect definition is disabled.

If this property is set by using a redirect definition name that is not set in webserver.connector.inprocess_http.redirect.list, the property is disabled.

Whether the value is correct is not verified, so you need to check through actual operations.

None

--

webserver.connector.inprocess_http.redirect.redirect-definition-name.request_url

Specify an absolute path beginning with a forward slash (/) for the request URL performing redirection with the redirect functionality. You can specify the wild card (*) only once, immediately after the forward slash. The wild card indicates any string of 0 or more characters. An asterisk (*) is always interpreted as the wild card, so it cannot be used as a normal character. You also cannot specify a value same as that specified in another redirect definition.

For the redirect definition name that has been specified in webserver.connector.inprocess_http.redirect.list, you always need to specify this property. If you do not specify this property, a message is output and the redirect definition is disabled.

If this property is set by using a redirect definition name that is not set in webserver.connector.inprocess_http.redirect.list, the property is disabled.

If you specify an invalid value, a message is output and the redirect definition is disabled.

None

--

webserver.connector.inprocess_http.redirect.redirect-definition-name.status

Specify the response status code (200, 300, 301, 302, 303, 305, 307) during redirection with the redirect functionality.

If this property is set by using a redirect definition name that is not set in webserver.connector.inprocess_http.redirect.list, the property is disabled.

If you specify an invalid value, a null character string, or a whitespace#2, a message is output and the default value will be set.

302

--

webserver.connector.inprocess_http.redirect.list

Specify the redirect definition name used in the redirect functionality.

The maximum length of the value that can be specified in this property is 1024 characters. Specify the redirect definition name with a string consisting of alphanumeric characters (A-Z, a-z, 0-9) or underscores (_). The string length of one redirect definition name is from 1 to 32 characters.

When specifying multiple redirect definition names, demarcate them with a comma (,). The whitespace#2 before and after the comma is ignored. You cannot specify the same redirect definition name multiple times.

If you specify an invalid value, a message is output and all redirect definitions are disabled.

None

--

webserver.connector.inprocess_http.rejection_threads

Specify an integer from 0 to 1023 for the number of request-processing threads that are denied access. The value to be specified must be lesser than the maximum number of request-processing threads (value specified in webserver.connector.inprocess_http. max_connections). If a value greater than the maximum number of connections with the Web client is set, a message is output and a value that is 1 less than the maximum number of connections with the Web client is set as the number of request-processing threads that are denied access.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

1

--

webserver.connector.inprocess_http.response.header.server

Specify the value of the Server header that is automatically added to the response.

If you specify a null character string or a whitespace#2, a message is output and the default value will be set.

CosminexusComponentContainer

--

webserver.connector.inprocess_http.send_timeout

Specify an integer from 0 to 3600 for the period until timeout (units: seconds) when a response is sent to the Web client. When you specify 0, the timeout is not enabled.

If you specify a non-numeric value, a numeric value outside the range, a null character string or a whitespace#2, a message is output and the default value will be set.

300

--

Legend:

--: Indicates a version earlier than the version 08-00.

#1
  • The valid maximum value depends on the operating platform.

  • Some of the requests arriving in the Web server are passed to the Web container, therefore, the maximum number of concurrent connections of the Web server to be set up must be greater than the total size of the default pending queue and the pending queue of each URL group and Web application + maximum number of concurrently executing threads in each Web container.

    In a servlet or JSP performing the database operations, since it is not possible to obtain greater multiplicity than the number of database connections, you need to increase the number of usable database connections, when increasing the concurrently executing number of Web containers.

    When tuning the performance, always consider the following relation and adjust the value of each parameter:

    Maximum-number-of-concurrent-connections-of-Web-server > Total-size-of-the-pending-queues-of-each-URL-group-and-Web-application-and-the-default-pending-queue + Maximum-number-of-concurrently-executing-threads-in-each-Web-container

    Maximum-number-of-concurrently-executing-threads-in-each-Web-container Number-of-database-connections

    For details on controlling the number of concurrently executed threads in Web containers, see 2.14 Controlling the number of concurrently executed threads in Web containers in the manual uCosminexus Application Server Web Container Functionality Guide.

    For details about the number of concurrent connections used for processing in the Web server, reference the manual of the Web server.

#2

Whitespace imply single-byte spaces, tabs, LF(0x0a), CR(0x0d) or FF(0x0c).

#3

This is the address associated with localhost when the J2EE server started.

(6) Keys beginning with webserver.container

The following table lists the specifiable keys. Note that Default value is the value that is assumed when a key is not specified.

VR is the version of Application Server on which the keys are introduced or changed.

Related information is the reference location for information related to the specified key. uCosminexus Application Server is omitted from the manual names.

Key name

Contents

Default value

VR

Related information

webserver.container.ac.logEnabled

Specify whether to output the trace log for Web container maintenance.

If you specify true:

The trace log will be output.

If you specify false:

The trace log will not be output.

false

--

Legend:

--: Indicates a version earlier than the version 08-00.