ttInstanceModify

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.

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 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: SSL_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 SSL_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 SSL_RSA_WITH_AES_128_CBC_SHA256 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).