Appendix A: Runtime Engine Parameters Reference

This chapter provides a list of all parameters for the runtime engine.

Parameters Listed in engineParameters42000.xml

Parameter Default value Comment
startInternalDb true Condition for starting the internal database used for the session logs and the scheduler
startSoapServer true Condition for starting the SOAP services that enable Semarchy Convergence for DI to expose web services
rmiPort 42000 IP port of the Java RMI service used for communication between the runtime and graphical interfaces
rmiCallbackPort In the RMI protocol, the client can also receive queries from the server. In this case, it uses the rmiCallbackPort. The default value is that of the rmiPort.
internalDbTcpPort 42100 IP port of the internal database
internalDbWebPort 42101 IP port of the Web interface of the internal database
soapServerPort 42200 IP port used by the SOAP server
soapServerUser Optional user for queries to the SOAP server
soapServerPassword Optional password for queries to the SOAP server
soapServerUncryptedPassword Optional un-encrypted password for queries to the SOAP server
soapServerThreadPoolSize Maximum number of concurrent threads on the SOAP server. If number exceeds this size, sessions are put on hold

Parameters listed in commonParameters.xml

Parameter Default value Comment
userLogDefaultName internalDB Name of the log where session logs are written. This log must exist in the includes.
debugLevel 0 Debug level in the runtime
launchSchedulerEngine true Condition for starting the scheduler that is built in the runtime.
launchExecutionEngine true Condition for starting the execution part of the runtime. Should be set to true.
launchReportEngine true Condition for starting the reporting part of the runtime. Should be set to true.
memoryScanDelay 1000 Deprecated.
memoryLogScanDelay 10000 Scan delay of the logs that have been brought back to memory so as to be purged, in milliseconds.
memoryLogCacheDelay 300000 Time during which logs stay in memory, in milliseconds.
sessionFolder sessions Folder (relative or absolute) used to store the session logs. Now used to store the data of the internal base.
rmiHost The RMI host is automatically calculated. If specified, this parameter skips this step. Useful when there are multiple domains, or address translations that generate different IP addresses for the same host. The host that is indicated (IP or name) must be reachable by the client
soapHost See above.
deliveryFolder build/deliveries Folders where the runtime will find the deliverables
temporaryFolder temp Temporary folder for the runtime. Used by developers as a workspace, and by the runtime to store some temporary files.
deliveryExtension deliv Extension of the deliverables. Do not change this value.
defaultFetchSize 1000 Default fetch value for reading data in databases. This value may be overloaded by the developers or when putting into production directly in the deliverables.
defaultBatchSize 1000 Default batch update value for writing data into databases. This value may be overloaded by the developers or when putting into production directly in the deliverables.
defaultJdbcConnectionTimeout 100 Default timeout value for connections to databases, in seconds
defaultJdbcQueryTimeout 10 Default timeout value for queries to databases, in seconds
defaultSessionReportNumber 10 Default number of sessions for the reporting part of the runtime. Usually overloaded by the graphical interface.
stackTraceOnStdOutput true To write the stack trace on the standard output, if there is an error.
statisticsOnStdOutput true To write the statistics on the standard output, at the end of a session.
sumVariables List of the variables used to calculate the session’s statistics

Logs parameters

In this part, the default values will be those used for the logs in H2 (the internal base). For other logs examples, please refer to the example files that are provided.

Log header

Parameter Example value Comment
userLogName internalDB Name of the log which will then be used in engineParameters.xml
autoUpdate true Condition for the automatic update of the log structures
userLogClass com.indy.engine.userLog.RdbmsUserLog Java class that is used (do not change)

Internal parameters

Parameter Example value Comment
userLogRdbmsDriver org.h2.Driver Java driver which will be used (this file must be in the runtime folder lib/jdbc)
userLogRdbmsUrl jdbc:h2:tcp://localhost:42100/sessions/internalDb/sessionLogs Connection url
userLogRdbmsUser sa Connection user
userLogRdbmsPassword Connection password (non encrypted)
userLogRdbmsEncryptedPassword Connection password (encrypted)
userLogRdbmsVarcharType varchar Type used when the data is a character string
userLogRdbmsVarcharMaxSize 1000 Maximum length of the character strings with the type defined above
userLogRdbmsNumericType numeric Type used when the data is numerical
userLogRdbmsClobType clob Type used when the data is text (clob, limitless text)
userLogRdbmsBlobType blob Type used when the data is binary (blob)
userLogRdbmsSchemaName logs Database scheme used to create the tables
userLogRdbmsUseSchemaNameForIndexCreation true Condition for adding a scheme to prefix indexes during creation
userLogRdbmsDeleteSyntaxe Delete from Syntax of the delete commands. The name of the table will be added behind.
userLogRdbmsCompressedLevel bestCompression Type of compression used (if activated). Possible values: bestCompression, bestSpeed or default
userLogRdbmsDeliveryFormat compressed Gives the deliverable’s storage format in the database. Possible values: text,binary or compressed
userLogRdbmsPropertyMaxVarcharSize 1000 Size of the character strings beyond which the data will be stored as CLOB
userLogRdbmsPropertyMaxClobSize 10000 Size of the CLOB beyond which the data will be stored as BLOB. -1 means “infinite”
userLogRdbmsPropertyBinaryFormat compressed Specifies the compression of the BLOB. Possible values: binary or compressed
userLogRdbmsTimestampQuery select now() SQL order to retrieve the current time stamp.
userLogRdbmsInactivityDetectionPeriod 90000
userLogRdbmsActivityRefreshInterval 60000
userLogRdbmsIndexCreationOption Character string that is added after the SQL order which creates indexes. Useful to specify physical storage parameters such as “tablespaces” or underlying physical types. For example, with MysqlENGINE = InnoDB
userLogRdbmsTableCreationOption Character string that is added after the SQL order which creates tables. Useful to specify physical storage parameters such as “tablespaces” or underlying physical types. For example, with MysqlENGINE = InnoDB