1. Scaleout User's Guide
  2. Prerequisites and Installation of TimesTen Scaleout
  3. Installing TimesTen Scaleout

Installing TimesTen Scaleout

When you unpack the TimesTen distribution on a host, you create an installation (that is read only). Do not add, alter, or remove files or directories within the installation, unless you are deleting the installation.

The installation may be a full installation or a client-only installation. A client-only installation supports the client use of TimesTen:

Type Description

Full installation

Use the TimesTen full distribution for this type of installation (for example, timesten2211180.server.linux8664.zip).

Client-only installation

You can connect and access databases in TimesTen Classic through a client. Use the full installation (for example, timesten2211180.server.linux8664.zip) to unpack the distribution and then specify ttInstanceCreate -clientonly. See Database Connections.

The operating system user that you designated as the instance administrator creates the installation by:

  1. Downloading the TimesTen distribution on the host that will contain the active management instance. The distribution is a ZIP file where the ZIP file name indicates the platform, release number, and the type of distribution. For example, timesten2211180.server.linux8664.zip.

  2. Unpacking the ZIP file to create a TimesTen installation. The installation includes the binaries and the support files from which you can create a grid (and all of its components), membership servers, and clients

Only the first installation is created manually by the instance administrator on the host containing the active management instance. Additional installations used by additional instances are created by TimesTen Scaleout utilities. See Setting Up a Grid.

After you download the distribution, follow these steps:

  1. Log in as the instance administrator to the host that will contain the initial management instance. In this example, instanceadmin is the name of the instance administrator. You can verify the instance administrator with the Linux id command.
  2. Create the desired directory for the installation such as /grid/installation1.
    % mkdir -p /grid/installation1
  3. Extract and unpack the distribution file into the directory. This example unpacks the installation using the unzip command:
    % unzip /timesten2211180.server.linux8664.zip -d /grid/installation1

The top level directory of the installation is the TimesTen release. For example, the directory created under /grid/installation1 is: 

dr-xr-x--- 19 instanceadmin timesten 4096 Mar  2 22:07 tt22.1.1.18.0

Verifying the Installation

These topics provide details on how to verify your installation:

Run the ttInstallationCheck Utility

The ttInstallationCheck utility, located in the installation_dir/tt22.1.1.18.0/bin directory, verifies the success or failure of the installation. This utility generates an error if the checksum value for the installation differs from the original checksum value. Checksum values are different if there are any of these changes to the installation directory or files:

  • Contents of a file

  • Name of a file

  • Addition of a file to a directory

  • Removal of file from a directory

  • Changes to the permissions of a file or directory

In this example, the installation is verified:

% ttInstallationCheck
This installation has been verified.

In this example, permissions on a file were changed, and ttInstallationCheck generates an error: 

% ttInstallationCheck 
Cannot validate the installation in /grid/installation1/tt22.1.1.18.0.

See ttInstallationCheck in Oracle TimesTen In-Memory Database Reference.

Review the Installation Directory and Subdirectories

A TimesTen full installation includes these subdirectories located under the top-level installation_dir/tt22.1.1.18.0 directory.

  • 3rdparty: Includes resources for:

    • Apache ZooKeeper

    • Java Message Service (JMS)

  • bin: TimesTen utilities and executables

  • grid: Files and resources for TimesTen Scaleout

  • include: TimesTen include files, among them timesten.h (for TimesTen ODBC features) and tt_errCode.h (for information about TimesTen error codes)

  • lib: TimesTen libraries

  • plsql: Files and resources for TimesTen PL/SQL

  • ttoracle_home: Oracle Database Instant Client files and resources, for OCI, Pro*C/C++, and ODP.NET

Note:

A client-only installation does not include the 3rdparty or the grid directories.