Use the ttInstanceModify utility to modify certain attributes of an instance.

The attributes that you can modify are:

  • The installation associated with this instance.

  • The daemon and server port numbers.

  • The TNS_ADMIN for the instance

  • The configuration of TimesTen Replication with Oracle Clusterware for this instance.

  • TLS settings, if any.
  • The system start up scripts.

The instance that is modified is the one that $TIMESTEN_HOME references.

If you do not specify any options for this utility, ttInstanceModify displays the current value of each attribute and a prompt that allows you to keep the value or change it.

If you change any of the settings, the utility:

  1. Shuts down the TimesTen daemon for the instance.
  2. Edits the timesten.conf file in the timesten_home/conf directory.
  3. Starts the TimesTen main daemon for the instance.

Required Privilege

This utility requires the instance administrator privilege.

Usage in TimesTen Scaleout and TimesTen Classic

This utility is supported in TimesTen Classic but not supported in TimesTen Scaleout.


ttInstanceModify [-h | -help | -?] [-verbose]

ttInstanceModify [-port daemonport] [-serverport cs_port] 
[-serverEncryption {accepted|rejected|requested|required} -serverCipherSuites {comma-separated list} -serverWallet {new_wallet_dir}] [-tnsadmin location] [-crs] [-install installation_dir]


ttInstanceModify has the options:

Option Description




Displays help information.

-daemonport daemonport

Updates the TimesTen main daemon port number.


Creates or modifies the instance's Oracle Clusterware configuration.

-install installation_dir

Changes the installation that the instance uses.

You can use the -install option to associate the instance with a different TimesTen installation. Typically, this is used to upgrade the instance to a new maintenance or patch release.

This option cannot be used to upgrade to a new major release, for example to upgrade from 18.1 to 22.1.

-serverEncryption {accepted|rejected|requested|required}

Determines whether encryption is accepted, rejected, requested, or required for a client/server connection.

  • accepted: Enable an encrypted session if required or requested by the client; use an unencrypted session otherwise. This is the 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.

The -serverEncryption and -serverCipherSuites values are set at the instance creation level in the timesten.conf file and serve as the default values for any database created on that instance. However, you can override them by setting the corresponding connection attribute in the database definition.

See TLS configuration for Client/Server in TimesTen Classic in Oracle TimesTen In-Memory Database Security Guide regarding usage of the -serverEncryption and -serverCipherSuites options.

-serverCipherSuites {suites}

Lists the cipher suite or suites that can be used for Transport Layer Security, depending also on the client setting. Specify one or more (separated by a comma and in order of preference) of these suites:


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

-serverWallet new_wallet_dir

If you move or copy the server wallet to a different location, you must specify this new location in the timesten.conf file. You can do this using -serverWallet, which determines if the new server wallet directory is valid, and if so, modifies the entry in the timesten.conf file.

See Task 2: Set Server Configuration for TLS in TimesTen Classic in Oracle TimesTen In-Memory Database Security Guide for more information.

-systemd | -nosystemd

You can use this option to change whether systemd is used to manage the instance’s main daemon or not.

This option cannot be used with Clusterware.

-tnsadmin location

Updates the instance's TNS_ADMIN setting (for cache).