ttInstanceModify

Use the ttInstanceModify utility to modify 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.

Syntax

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]

Options

ttInstanceModify has the options:

Option Description

-h

-help

-?

Displays help information.

-daemonport daemonport

Updates the TimesTen main daemon port number.

-crs

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 Task 2: Set Server Configuration for TLS 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.

TimesTen 22.1 supports cipher suites that include both RSA and ECC authentication/digital signature algorithms. If you are using RSA keys, ensure to include one or more cipher suites with an RSA authentication/digital signature algorithm. Similarly, if you are using ECC keys, ensure to include one or more cipher suites with an ECDSA (Elliptic Curve Digital Signature Algorithm) authentication/digital signature algorithm. For example, if your key is ECC, then the TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 cipher suite is valid, but the TLS_RSA_WITH_AES_128_CBC_SHA256 cipher suite is not valid.

There is no default setting. You can specify one or more cipher suites. If you specify more than one cipher suite, ensure to separate each by a comma, and list them in order of preference. For TLS to be used, there must be at least one common cipher suite. For a list of supported cipher suites, see Transport Layer Security for TimesTen Client/Server in Oracle TimesTen In-Memory Database Security Guide.

-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).