Installation and Instance Management on Linux, UNIX, or macOS

Installation Creation on Linux, UNIX, or macOS

The instance administrator creates the installation by extracting the distribution. See "Distribution Media" for information on the distribution. For a Linux/UNIX 64-bit host, see "Creating an Installation on Linux/UNIX" for information. For a macOS or a Linux 32-bit host, see "Creating a TimesTen Client Installation" for information.

The instance administrator can run the ttInstallationCheck utility after installation to verify the installation has the expected contents and permissions. For a Linux/UNIX 64-bit host, see "Verify an Installation on Linux/UNIX" for more information. For a macOS or a Linux 32-bit host, see "Verify a Client Installation" for information.

Installation Deletion on Linux, UNIX, or macOS

The instance administrator who created the installation is the only user who can delete the installation. Deleting the installation involves manually deleting the installation tree (the files and the directories within the installation).

For a Linux/UNIX 64-bit host, see "Deleting an Installation on Linux/UNIX" for information.

For a macOS or a Linux 32-bit host, see "Deleting a TimesTen Client Installation" for information.

Installation Copying on Linux or UNIX

Since installations are read only and immutable, you can pack the installation (using a tool like ZIP), copy it to another host, and unpack it. As long as the file permissions are maintained and the files are copied, the copied installation is valid. You can use the ttInstallationCheck utility to verify the installation. See "Copying an Installation on Linux/UNIX" for information.

Instance Creation on Linux, UNIX, or macOS

The instance administrator who created the installation (by extracting the distribution) is the only user who can create the instance. The instance administrator creates the instance by running the ttInstanceCreate utility located in the /bin area of the installation directory tree (installation_dir/tt22.1.1.25.0/bin).

The instance administrator creates a client-only instance by running ttInstanceCreate with the -clientonly option. (On a macOS or a Linux 32-bit host, the -clientonly option is not required.) See "TimesTen Instances" for information on TimesTen instances.

The ttInstanceCreate utility creates the instance, creates the instance home directory, sets the permissions on the instance home directory, and populates the directory with the appropriate files. See "Instance Home" for information on the instance home directory.

For a Linux/UNIX 64-bit host, see "Creating an Instance on Linux/UNIX: Basics" for more information on the ttInstanceCreate utility and the procedure for creating an instance.

For a macOS or a Linux 32-bit host, see "Creating a TimesTen Client Instance" for information.

Instance Modification on Linux, UNIX, or macOS

The instance administrator who created the installation and the instance is the only user who can modify the instance. The instance administrator modifies the instance by running the ttInstanceModify utility located in the /bin area of the timesten_home directory. See Instance Home for information on this directory.

The instance administrator can run the ttInstanceModify utility either interactively or by specifying a supported option. For a Linux/UNIX 64-bit host, see Modifying an Instance on Linux/UNIX for information on the ttInstanceModify utility and the procedure for modifying an instance. For a macOS or a Linux 32-bit host, see Modifying a TimesTen Client Instance for information.

The instance administrator can also change the attributes of the instance by modifying the instance configuration file. See "Instance Configuration File (timesten.conf)" for information on this file. Also see TimesTen Instance Configuration File in the Oracle TimesTen In-Memory Database Reference.

Upgrading or Downgrading the Instance on Linux, UNIX, or macOS

An instance can be upgraded from one patch release of TimesTen to a later patch release. Instances can also be downgraded from one patch release to an earlier one. Upgrades and downgrades are only possible within a single major release (for example, from 22.1.w.x.0 to 22.1.y.z.0.

The instance administrator who created the installation and the instance is the only user who can upgrade or downgrade the instance. The instance administrator upgrades or downgrades the instance by running the ttInstanceModify utility located in the /bin area of the timesten_home directory. See "Instance Home" for information on this directory.

The procedure for upgrading or downgrading the instance involves associating the instance with a different installation. The instance administrator runs the ttInstanceModify utility with the -install option to accomplish this.

For a Linux/UNIX 64-bit host, see "Modifying an Instance on Linux/UNIX" for information on the ttInstanceModify utility and see "Associate an Instance with a Different Installation (Upgrade or Downgrade)" for the procedure to associate an instance with a different installation.

For a macOS or a Linux 32-bit host, see "Modifying a TimesTen Client Instance" for information.

Instance Removal on Linux, UNIX, or macOS

The instance administrator who created the installation and the instance is the only user who can remove (destroy) the instance. The instance administrator destroys the instance by running the ttInstanceDestroy utility located in the /bin area of the installation directory tree (installation_dir/tt22.1.1.25.0/bin).

The instance to be destroyed is determined by the setting of the TIMESTEN_HOME environment variable. See "Environment Variables" for information on this environment variable and how to set it.

For a Linux/UNIX 64-bit host, see "Destroying an Instance on Linux/UNIX" for information on the ttInstanceDestroy utility and the procedure for destroying an instance.

For a macOS or Linux 32-bit host, see "Destroying a TimesTen Client Instance" for information.