system.properties

The main configuration file for TomEE application server.

The ACL Analytics Exchange Service must be restarted for changes made to this file to take effect.

File settings

Property Description

com.acl.ax.project.encoding

For Unicode installations of AX Server this parameter must be present, and set to UTF-16LE.

This property is not present for non-Unicode installations of AX Server, or in Unicode installations if AX Exception is the only application installed on the server.

axcas.authentication.mode

Specify “form” for form-based authentication, or “silent” for Integrated Windows Authentication. The value entered must be lowercase.

This property is not present on AX Engine Node, or if AX Exception is the only application installed on the server.

javax.net.ssl.trustStore

The path to the keystore file used by Tomcat. The default location is the App/keystores/MyKeyStore subfolder.

Note

You must use the forward slash '/' character in the keystore path. If you use the backslash character '\' as is common in Windows environments, you will encounter server errors when logging in.

javax.net.ssl.trustStorePassword

The password for keystore being used.

oracle.net.ssl_cipher_suites

The cipher suites that will be used for SSL connections. The supported values are entered as a comma separated list.

com.acl.ax.server.deleteJobDirectories

This startup parameter isn’t included by default, but it can be added and set to “false” if you want to prevent the system from deleting analytic job directories after each job completes. This can be useful if you need to troubleshoot unexpected analytic results.

sun.security.krb5.msinterop.kstring

When set to “true” the Kerberos string used for authentication is encoded as UTF-8.

This property is not present on AX Engine Node, or if AX Exception is the only application installed on the server.

oracle.jdbc.defaultNChar

This property must be set to “true” in order to support Oracle database instances with non-UTF8 system encodings. This property is ignored if Oracle is not the system database platform.

This property is not present if AX Exception is the only application installed on the server.

oracle.jdbc.ConvertNcharLiterals

This property must be set to “true” to preserve Unicode analytic and entity names being published from AX Server to AX Exception. This property is ignored if Oracle is not the system database platform, an only needs to be set on the server where AX Exception is installed.

exceptionmgmt.jdbc.database.protocol

Valid values are “tcp” for non-SSL and “tcps” for SSL (Oracle only). The value entered must be lowercase. If “tcps” is set for Oracle, the required configuration must be completed to allow SSL connections to the Oracle database instance.

This property is only present if AX Exception is installed on the server.

exceptionmgmt.jdbc.database.type

Valid values are “oracle” and “mssql”. The value entered must be lowercase.

This property is only present if AX Exception is installed on the server.

com.acl.ax.server.daysToKeepFailedJobsFolder

The number of days to keep saved failed job folders on the AX Server or AX Engine Node that it is stored on if you choose to keep failed job folders when running an analytic.

  • Valid values: any positive integer
  • Default value: 5
Note

Jobs are deleted at 3:00 AM server time if the job folder created date is older than the number of says specified in this setting. The automatic deletion is logged in the axcore.log file.