acl.conf

Stores the settings for the AX Connector service.

File settings

Property Description

WORK SPACE ALLOC

The amount of memory the AX Connector service allocates as a buffer for reading from data sources, including both databases and disk files. The valid range is from 32760 to 2000000 bytes (2MB), and the default value is 1000000 bytes (1MB). The value specified is allocated to each session. A session is created for each Analytics user that connects to the server, and for each legacy offline script run on the server using the aclse command line tool.

ACL SERIAL NUMBER

The serial number the AX Connector is licensed under. The default installed value should not be modified.

EXPIRY

The expiry date in hashed form. The service is running as a component of Analytics Exchange, so there is no expiry date.

CONCURRENT USERS

The maximum number of concurrent users that can access the service. The line includes a hash code to ensure that the number of users is correct.

SORT MEMORY

The maximum physical memory (RAM) available for sorting Analytics data. The appropriate value depends on the total memory available and processing requirements of the server.

The valid range is from 2000000 to 100000000 bytes (2MB to 100MB). If the SORT MEMORY entry is missing, or the value is outside the valid range, a default value of 5000000 (5MB) is used and a warning message is recorded in the server log.

The value of SORT MEMORY needs to be set to a level that ensures that the memory allocated to sorting does not exceed the amount of physical memory available on the server when multiple sessions that involve sorting tables are active on the server. Exceeding the amount of physical memory available on the server will significantly slow down all processes running on the server.

DISABLE_ORACLE_EXT_AUTH

This property is not included by default, but if can be included on the sixth line to prevent the use of Oracle external authentication when connecting to Oracle databases. Oracle external authentication means that Oracle manages the user account, but authentication is managed by another service, such as the operating system.

Example

The following is an example of a properly formatted acl.conf file:

1000000                                         /*WORK SPACE ALLOC
XYZ1234567891                                   /*ACL SERIAL NUMBER
123456789012                                    /*EXPIRY 01 01 01
0 USERS                      12345678           /*CONCURRENT USERS
5000000                                         /*SORT MEMORY

If you edit the file, you must ensure that there are no blank lines and that you retain the original order of the lines.