1 TimesTen Instance Configuration File

The TimesTen instance configuration file contains TimesTen instance configuration attributes and their values.The timesten.conf file is located at timesten_home/conf/timesten.conf. Each line of the configuration file consists of one name=value pair.

The following table contains all the TimesTen configuration attributes, descriptions, default values, and data types.

Note that some configuration attributes have a corresponding connection attribute. In these cases, you can override the setting of the configuration attribute in the server timesten.conf file by setting the connection attribute in the database DSN definition. Similarly, you can override the setting of the configuration attribute in the client timesten.conf file by setting the connection attribute in either the client DSN definition or the connection string.

Name Description Value or Data Type

admin_uid

Required

The OS uid number of the instance administrator.

This entry is added by the ttInstanceCreate utility and must not be changed.

Default: None

Integer

admin_user

Required

The OS user name of the instance administrator that matches the OS owner of the instance home directory.

This entry is added by the ttInstanceCreate utility and must not be changed.

Default: None

String

allow_network_files

Optional

Indicates if data access on NFS-mounted systems is allowed.

On Linux x86 and Solaris, you can access checkpoint and transaction log files on NFS-mounted systems.

TimesTen ignores this attribute on platforms other than Linux x86 and Solaris.

  • 1 indicates that TimesTen systems can access data across NFS-mounted systems.

  • 0 indicates that TimesTen systems cannot access data across NFS-mounted systems.

Default: 0

For more information, see Using NFS-mounted systems for checkpoint and transaction log files in the Oracle TimesTen In-Memory Database Operations Guide.

1 or 0

client_cipher_suites and server_cipher_suites

Optional

Lists the cipher suite or suites that can be used for Transport Layer Security.

To use TLS for client/server connections, set client_cipher_suites in the client timesten.conf file and server_cipher_suites in the server timesten.conf file.

Default: None

server_cipher_suites can also be set through:
  • The -serverCipherSuites option of the ttInstanceCreate command for TimesTen Classic.
  • The -serverCipherSuites option of the ttGridAdmin gridCreate command for TimesTen Scaleout.

Note:

You can also use the CipherSuites connection attribute for TimesTen Classic to set client_cipher_suites and server_cipher_suites.

For TLS to be used, the server and client settings must include at least one common suite. For more information, see Transport Layer Security for TimesTen Client/Server in the Oracle TimesTen In-Memory Database Security Guide.

String

client_only

Optional

Indicates if the instance only supports client operations.

This entry is added by the ttInstanceCreate utility and must not be changed.

Default: No

Yes or No

client_wallet and server_wallet

Optional

Specifies the fully qualified path to the wallet directory—the directory where generated certificates are located.

Default: None

For more information, see Transport Layer Security for TimesTen Client/Server in the Oracle TimesTen In-Memory Database Security Guide.

Pathname

daemon_log_snippet_interval_in_mins

Optional

The duration of the daemon log collection for a critical event. The granularity of the duration is in minutes. The minimum value is 1 minute.

Default: 10

Integer

daemon_port

Required

The valid TCP port number on which the TimesTen daemon for this instance listens.

TimesTen ignores this attribute for client-only instances.

Default: 6624

Number

db_fips_140

Optional

Specifies whether FIPS 140-2 mode for symmetric encryption between TimesTen processes is enabled. If specified, it uses a FIPS-validated version of the encryption libraries available to provide the encryption.

  • 1 (FIPS) indicates that FIPS 140-2 mode for symmetric encryption is enabled.

  • 0 (non-FIPS) indicates that FIPS 140-2 mode for symmetric encryption is disabled.

Notes

  • If you specify FIPS mode and the libraries do not exist, the daemon does not start.
  • The db_fips_140 value is read when each process starts.
  • If you change the value while a daemon is running, the change does not take effect on the daemon until it is restarted.
  • If you change the value while a daemon is running, any new process started after this change is affected by it (for instance, running a ttIsql operation)

Default: 0

1 or 0

enable_policy_inactive

Optional

1 indicates that if there are too many failures to automatically load a database, TimesTen puts the database into a "policy inactive" mode. This is the default.

0 indicates that the RAM policy is one of Always, Manual or InUse.

Default: 1

For more information, see Specifying a RAM policy in the Oracle TimesTen In-Memory Database Operations Guide.

1 or 0

enableipv6

Optional

Indicates whether to support IPv6 or not. 1 means supported, and 0 means not supported.

Default: 1

1 or 0

facility

Optional

If daemon logs are sent to syslog, the facility to be used.

Possible name values are: auth, cron, daemon, local0-local7, lpr, mail, news, user, or uucp.

Default: None

String

group_name

Required

The primary group name of the instance administrator.

This entry is added by the ttInstanceCreate utility, and must not be changed.

Default: None

String

hostname

Required

The OS hostname of the instance.

This entry is added by the ttInstanceCreate utility, and must not be changed.

Default: None

String

instance_guid

Required

A globally unique ID, guaranteed to be different than the ID of any other instance.

TimesTen adds this ID during instance creation.

Default: None

String

instance_name

Required

The name of the TimesTen instance. An ASCII name from 1 to 255 characters long.

This attribute is optional for client-only instances.

Default: instance1

String

listen_addr and

listen_6_addr

Optional

listen_addr indicates the IPv4 address where the TimesTen daemon and servers listen.

listen_6_addr indicates the IPv6 address where the TimesTen daemon and servers listen.

By default, TimesTen supports IPv6.

Default: None

String

max_conns_per_server

Optional

The maximum number of client/server connections for the TimesTen server.

You can also set this with the MaxConnsPerServer connection attribute.

Default: 1

Integer

max_subs

Optional

The maximum number of subdaemons TimesTen spawns.

The main TimesTen daemon spawns subdaemons dynamically as they are needed.

Default: 50

Integer

max_support_log_files

Optional

The TimesTen main daemon automatically rotates the files once they get to a specific size.

This attribute specifies the maximum number of daemon log files to keep.

Default: 10

Integer

max_support_log_size_mb

Optional

The maximum size of a TimesTen daemon log file in megabytes.

Default: 100 MB

Integer

max_user_log_files

Optional

The TimesTen main daemon automatically rotates the files once they get to a specific size.

This attribute specifies the maximum number of user log files to keep.

Default: 10

Integer

max_user_log_size_mb

Optional

The maximum size of a TimesTen daemon user log file in megabytes.

Default: 10 MB

Integer

min_subs

Optional

The minimum number of subdaemons TimesTen spawns.

The main TimesTen daemon spawns subdaemons dynamically as they are needed.

Default: 4

Integer

noserverlog

Optional

Turns logging on or off for connects to and disconnects from client applications.

1 indicates logging is on.

0 indicates that logging is off.

Default: 1

1 or 0

openssl_path

Optional

Specifies the fully qualified directory path where the OpenSSL library resides.

If you do not provide a value for this attribute, TimesTen uses the OpenSSL library, if any, that the system uses by default.

Default: None

String

replication_cipher_suite

Optional

The cipher suite to be used in encrypting communications to and from the replication agents. This setting is required if you are using TLS for replication.

See Transport Layer Security for TimesTen Replication in Oracle TimesTen In-Memory Database Security Guide for more information about replication TLS attributes.

Default: None

String

replication_ssl_mandatory

Optional

Specifies whether it is mandatory to have consistent TLS configuration between TimesTen instances—specifically, whether TLS is configured through replication_cipher_suite and replication_wallet settings, and what cipher suite is specified. If there is a mismatch between the current instance and the replication peer, then TimesTen behavior is determined as follows:

  • 1 indicates that replication cannot proceed unless settings are the same on all instances.

  • 0 indicates that TLS is not used for communication between replication agents.

Default: 1

1 or 0

replication_wallet

Optional

Specifies the path to the wallet directory—the directory where you placed the certificates that you generated. This setting is required if you are using TLS for replication. Oracle recommends using the same location and directory name on each TimesTen instance.

Default: None

Pathname

server_encryption

Optional

This is the encryption flag. Possible values are:

  • accepted: Enable an encrypted session if required or requested by the client; use an unencrypted session otherwise (default).

  • rejected: Demand an unencrypted session. (If the server does not support encryption, TimesTen behaves as if this is the setting on the server.) The connection is rejected if the client requires encryption.

  • requested: Request an encrypted session if the client allows it (if the client has any setting other than rejected); use an unencrypted session otherwise.

  • required: Demand an encrypted session. Reject the connection if the client rejects encryption.

Default: Accepted

server_encryption can also be set through:
  • The -serverEncryption option of the ttInstanceCreate command for TimesTen Classic.
  • The Encryption connection attribute for TimesTen Classic.
  • The -serverEncryption option of the ttGridAdmin gridCreate command for TimesTen Scaleout.

Note:

To use Transport Layer Security, settings from the server and the client must be compatible. For more information about settings compatibility, see Transport Layer Security for TimesTen Client/Server in the Oracle TimesTen In-Memory Database Security Guide.

String

server_pool

Optional

The number of processes that the TimesTen server should prespawn and keep in a reserve pool.

If not specified, no processes are prespawned.

Default: None

Integer

server_port

Optional

The valid TCP port number on which the TimesTen server for this instance listens if you want to run a server in the instance.

Default: 6625

Number

servers_per_dsn

Optional

The number of servers per DSN for client /server implementations.

The value is set by and can be changed by the ServersPerDSN attribute in the server DSN.

Default: 1

Integer

server_stack_size

Optional

The client/server stack size in kilobytes.

You can also set this with the ServerStackSize connection attribute.

Default: 768 KB

Integer

show_date

Optional

Indicates whether the date is prepended on all daemon and user log entries.

1 indicates that the date is prepended to every record in the user and daemon log files.

0 indicates that the date is not prepended to every record in the user and daemon log files.

Default: 1

1 or 0

snmp_conf_path

Optional

Lists the fully qualified directory paths, separated by a colon, where the snmp.conf and snmp.local.conf files may reside.

Default: None

Pathname

snmp_trap

Optional

Specifies the fully qualified directory path where the snmptrap utility resides.

If you do not provide a value for this attribute, TimesTen does not attempt to generate SNMP traps.

Default: None

Pathname

snmp_trap_dests

Optional

Lists the destinations for the SNMP traps, separated by a space.

Each destination must include the transport specifier and transport address. If the transport specifier or port number are not provided, snmptrap uses the defaults: udp and 161, respectively.

A destination can be specified as follows:

  • [udp:]hostname[:port] or

    [udp:]IPv4-address[:port]

  • udp6:hostname[:port],

    udp6:IPv6-address:port, or

    upd6:'['IPv6-address']'[:port]

  • dtlsudp:hostname[:port] or

    dtlsudp:IPv4-address[:port]

  • tcp:hostname[:port] or

    tcp:IPv4-address[:port]

  • tcp6:hostname[:port],

    tcp6:IPv6-address:port, or

    tcp6:'['IPv6-address']'[:port]

  • tlstcp:hostname[:port] or

    tlstcp:IPv4-address[:port]

  • unix:pathname

Default: None

String

snmp_trap_opts

Optional

Lists the options to be passed to the snmptrap utility.

For information on the options supported by the snmptrap utility, see the man pages for snmpcmd and snmptrap.

Default: None

String

snmp_version

Optional

Specifies the SNMP version to be used.

Default: 3

1, 2, or 3

ssl_client_authentication

Optional

Specifies whether TLS client authentication is required (setting of 1) or not (setting of 0).

Default: 0

With client authentication, the server validates an identity presented by the client, and requires an identity (public/private key) in the client wallet. Regardless of the client authentication setting, server authentication is performed, where the client validates the server. For more information, see Transport Layer Security for TimesTen Client/Server in the Oracle TimesTen In-Memory Database Security Guide.

1 or 0

ssl_fips_140

Optional

Specifies whether FIPS 140-2 mode encryption for both client/server and replication connections are enabled. If specified, it uses a FIPS-validated version of the encryption libraries available to provide the encryption.

  • 1 indicates that FIPS 140-2 mode encryption is enabled for client/server and replication connections.

  • 0 indicates that FIPS 140-2 mode encryption is disabled for client/server and replication connections.

Notes

  • To use the FIPS 140-2 mode encryption, you must enable encryption on both the client and server side of the connection.
  • Both ends of a connection need to be either encrypted or unencrypted. However, you can mix encrypted and unencrypted client/server connections to a single database.
  • FIPS 140-2 mode encryption for client/server connections in TimesTen Scaleout is not supported.

Default: 0

1 or 0

supportlog

Optional

The location of the TimesTen daemon log file.

Default: timesten_home/diag/ttmesg.log

String

timesten_release

Optional

The number of the TimesTen release that created the instance home and that can use the instance home.

Default: The installed TimesTen release number

Number

tns_admin

Optional

In a TimesTen cache environment, the directory that contains the TNS_ADMIN settings to allow TimesTen to communicate with the Oracle database.

This attribute is required in a TimesTen cache environment only.

This entry is added by the ttInstanceCreate utility and can be changed using the ttInstanceModify utility.

Default: None

Pathname

userlog

Optional

The location of the TimesTen daemon user log file.

Default: timesten_home/diag/tterrors.log

String

In TimesTen Classic, you can change values through various TimesTen utilities or connection attributes, at instance creation time or through editing this file. For more information about changing values by editing this file, see Working with the TimesTen Daemon in the Oracle TimesTen In-Memory Database Operations Guide.

In TimesTen Scaleout, you can change the values in this file by using the ttGridAdmin instanceConfigImport command. For more details, see Import Instance Configuration Attributes (instanceConfigImport). Do not edit the configuration file by hand.