Requirements, Considerations, and Installation for Your Cluster

There are requirements and installation steps when creating your cluster.

Required Privileges

There are privileges required to run ttCWAdmin commands.

See ttCWAdmin in Oracle TimesTen In-Memory Database Reference.

Hardware and Software Requirements

TimesTen supports Clusterware on Linux or UNIX platforms except Linux arm64.

TimesTen supports Oracle Clusterware with TimesTen active standby pair replication. See Oracle Clusterware Administration and Deployment Guide in the Oracle Database documentation for network and storage requirements and information about Oracle Clusterware configuration files.

Oracle Clusterware and TimesTen should be installed in the same location on all nodes. The TimesTen instance administrator must belong to the same UNIX or Linux primary group as the Oracle Clusterware installation owner.

Note:

The /tmp directory contains essential TimesTen Oracle Clusterware directories. Their names have the prefix crsTT. Do not delete them.

All hosts should use Network Time Protocol (NTP) or a similar system so that clocks on the hosts remain within 250 milliseconds of each other. When adjusting the system clocks on any nodes to be synchronized with each other, do not set any clock backward in time.

Install Oracle Clusterware

By default, when you install Oracle Clusterware, the installation occurs on all hosts concurrently. See Oracle Clusterware installation documentation for your platform.

For example, see the Grid Infrastructure Installation Guide for Linux.

Oracle Clusterware starts automatically after successful installation.

Note:

You can verify whether Oracle Clusterware is running on all hosts in the cluster by running the following:

crsctl check crs -all

Install TimesTen on Each Host

Use the ttInstanceCreate command to install TimesTen in the same location on each host in the cluster, including extra hosts.

See Create an Instance Interactively for Oracle Clusterware in Oracle TimesTen In-Memory Database Installation, Migration, and Upgrade Guide.

When responding to the various prompts, note that:

  • The instance name must be the same on each host.

  • The user name of the instance administrator must be the same on all hosts.

  • The TimesTen instance administrator must belong to the same UNIX or Linux primary group as the Oracle Clusterware installation owner.

In addition, when you respond yes to the following question:

Would you like to use TimesTen Replication with Oracle Clusterware?

Then, the ttInstanceCreate command prompts you for values used for Oracle Clusterware, each of which is stored in the ttcrsagent.options file:

  • The TCP/IP port number associated with the TimesTen cluster agent (ttCRSAgent). The port number must be the same on all nodes of the cluster. If you do not provide a port number, then TimesTen adds six to the default TimesTen daemon port number to be the TCP/IP port number associated with the TimesTen cluster agent. Thus, the default daemon port number associated with the TimesTen cluster agent is 3574 for 64-bit systems.

  • The Oracle Clusterware location. The location must be the same on each host.

  • The hosts included in the cluster, including spare hosts, with host names separated by commas. This list must be the same on each host.

See Installing Oracle Clusterware for Use with TimesTen and Create an Instance Interactively for Oracle Clusterware in Oracle TimesTen In-Memory Database Installation, Migration, and Upgrade Guide.

The ttCWAdmin –init and ttCWAdmin –shutdown commands use the ttcrsagent.options file to initiate and shut down the TimesTen cluster. The ttcrsagent.options file is located in the TimesTen daemon home directory.

You should not manually alter the ttcrsagent.options file. Instead, use the ttInstanceModify -crs command to create or modify the information in this file after the TimesTen cluster has been initiated. You can also use the -record and -batch options for setup.sh to perform identical installations on additional hosts.

Note:

See Change the Oracle Clusterware Configuration for an Instance in Oracle TimesTen In-Memory Database Installation, Migration, and Upgrade Guide.

The current home location of Oracle Clusterware is set in the CRS_HOME environment variable. In addition, the ttInstanceModify -crs command shows the current location of the Oracle Clusterware home as part of the prompts.

Note:

See Start the TimesTen Cluster Agent for more information on the ttcrsagent.options file. For more information about ttInstanceCreate and ttInstanceModify, see ttInstanceCreate and ttInstanceModify respectively in Oracle TimesTen In-Memory Database Reference.

The following example shows how the ttInstanceModify -crs prompts for you to modify each item in the ttcrsagent.options file:

% ttInstanceModify -crs

Cannot find instance_info file : /etc/TimesTen/instance_info

Would you like to modify the existing TimesTen Replication with Oracle 
Clusterware configuration? [ no ] yes

This TimesTen instance is configured to use an Oracle Clusterware installation
located in : /mydir/oracle/crs/app/11.2.0
Would you like to change this value? [ no ] no

The TimesTen Clusterware agent is configured to use port 54504
Would you like to change this value? [ no ] no

The TimesTen Clusterware agent is currently configured with these nodes :
 
node1
node2
node3
node4
 
Would you like to change these values? [ no ]

Overwrite the existing TimesTen Clusterware options file? [ no ] no

Register the TimesTen Cluster Information

TimesTen cluster information is stored in the Oracle Cluster Registry (OCR).

As the root user, enter this command:

ttCWAdmin -ocrConfig

As long as Oracle Clusterware and TimesTen are installed on the hosts, this step never needs to be repeated.