wrapper.conf

The wrapper.conf file is the main configuration file for Geronimo application server. The file includes startup settings for the Windows service, global configuration settings, and log file settings. The ACL Analytics Exchange Geronimo service must be restarted for changes made to this file to take effect.

The following table lists properties specified as wrapper.java.additional.n properties. The wrapper.java.additional properties must be listed in sequential order with each number being used once.

Property	Description
-javaagent:	The path to the jpa.jar file in the geronimo/bin subfolder.
-Djava.ext.dirs	The paths to the Geronimo and Java extension subfolders. The Geronimo subfolder is geronimo/lib/ext. The java folder is the jre/lib/ext subfolder where the JDK is installed.
-Djava.endorsed.dirs	The paths to the Geronimo and Java endorsed subfolders. The Geronimo subfolder is geronimo/lib/endorsed. The java folder is the jre/lib/endorsed subfolder where the JDK is installed.
-Dorg.apache.geronimo.base.dir	The path to the folder where the Geronimo application files are installed.
-Djava.io.tmpdir	The path to the folder where temporary files are created during Java input/output operations, such as uploading files to AX Server. This property is set to the C:\ACL\App\geronimo\var\temp subfolder by default. If disk space where the application files are installed is limited, you can set this property to another folder or drive on the server where more space is available.
-XX:MaxPermSize	The maximum size for the Java permanent generation heap, a memory area that holds objects such as classes and methods. If you see the following error “java.lang.OutOfMemoryError: PermGen” message in the Geronimo log file, you need to increase the MaxPermSize value.
-Xms	The minimum Java memory heap size. Sets the minimum size of the pool of free memory available to the service.
-Xmx	The maximum Java memory heap size. Sets the maximum size of the pool of free memory available the service.
-Dcom.acl.help.url	The server location for web based application help. The default location is docs.acl.com, which is hosted by ACL. This property is not present on AX Engine Node.
-Dcom.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.
-Dcas.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.
-Djavax.net.ssl.trustStore	The path to the keystore file used by Geronimo. The default location is the geronimo/var/security/keystore/MyKeyStore subfolder.
-Djavax.net.ssl.trustStoreType	The type of keystore being used. The default value is JKS.
-Djavax.net.ssl.trustStorePassword	The password for keystore being used.
-Doracle.net.ssl_cipher_suites	The cipher suites that will be used for SSL connections. The supported values are entered as a comma separated list.
-Dcom.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.
-Dsun.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.
-Doracle.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.
-Doracle.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.
-Dexceptionmgmt.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.
-Dexceptionmgmt.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.

The following table lists the logging configuration properties for the Windows Service.

Property	Description
wrapper.logfile	The name and location of the log file for the ACL Analytics Exchange Geronimo service. The default path for the log file is C:\ACL\App\Geronimo\var\log\geronimo_services.log.
wrapper.logfile.format	The format to use when writing messages to the log. The default value is LPTM, which displays the log level, prefix or source of the message, time, and message.
wrapper.logfile.loglevel	Specifies the amount of information recorded in the log file. You can set the log level at any of the following: NONE, FATAL, ERROR, STATUS, INFO, DEBUG. The default installed value is INFO.
wrapper.logfile.rollmode	Specifies when a new logfile should be created. The default value is SIZE_OR _WRAPPER, which means that a new log should be created whenever the service is restarted or the file size grows larger than the value specified in wrapper.logfile.maxsize.
wrapper.logfile.maxsize	The maximum size of the log file. The default value is 10 megabytes (10m).
wrapper.logfile.maxfiles	The maximum number of log files to retain. The most recent files are retained, and any files exceeding the maximum number are deleted. The default value is 30.
wrapper.syslog.loglevel	Specifies the amount of information recorded in the Windows Event Log. You can set the log level at any of the following: NONE, FATAL, ERROR, STATUS, INFO, DEBUG. The default installed value is ERROR.

The following table lists Windows Service configuration settings. These properties are only read when the service is first installed or reinstalled.

Property	Description
wrapper.ntservice.name	The name of the Windows Service when installed.
wrapper.ntservice.displayname	The display name of the Windows Service when installed.
wrapper.ntservice.description	The description of the Windows Service when installed.
wrapper.ntservice.starttype	The mode to use to start the Windows service. Valid values are AUTO_START and DEMAND_START. AUTO_START specifies that the service is automatically started when the system is rebooted. DEMAND_START specifies that the service must be started manually.