This chapter discusses how to install a TimesTen client on Windows. Review Chapter 1, "Overview of the Installation Process in TimesTen Classic" before beginning the installation.
Topics include:
The TimesTen installer on Windows creates a single TimesTen client-only installation (and instance). No additional installations (or instances) can be created without first uninstalling the existing one.
Once installed, a Windows host can be used as a TimesTen client that connects to either a database in TimesTen Scaleout or a database in TimesTen Classic.
A Windows host cannot have multiple installations from the same TimesTen major release, such as 18.1. For example, it cannot have both a 18.1.3.x and a 18.1.4.x installation. But it can have TimesTen installations from different major releases, such as an 11.2.2.8.x installation and a 18.1.x installation.
You cannot modify the installation or the instance.
Note:
TimesTen does not support copying a Windows installation or sharing a Windows installation between hosts. TimesTen must be installed separately on each host.You can install TimesTen in any directory where the user performing the installation has sufficient permission. The user who installs TimesTen must be a member of the TimesTen users group, and the TimesTen files and the directories must be accessible to only members of that group. Installing TimesTen requires Administrator privileges.
Information about the TimesTen installation is contained in the Windows operating system registry.
Do not install TimesTen for Windows on a mapped network drive.
The default top-level directory of the installation is C:\TimesTen\tt181_64
. The instance name is simply instance
.
These sections describe how to create the installation and then verify it.
After you create and verify the installation, you can connect to the server from the Windows client and set up your DSN. See "Working with the TimesTen Client and Server" in the Oracle TimesTen In-Memory Database Operations Guide for details.
The procedure for the installation is:
Download the appropriate TimesTen client distribution ZIP file. For example, download timesten.181410.win64.zip
.
Extract the contents of the file.
From the Win64
directory, run the setup.exe
executable (the TimesTen installer).
In the initial TimesTen Setup dialog, choose Next.
In the Choose Installation Folder dialog, select or specify the desired folder. The default is C:\TimesTen\tt181_64
. Then choose OK.
In the Select Program Folder dialog, select or specify the desired folder. The default is TimesTen
18.1
(64-bit)
. Then choose Next.
In the TimesTen Configuration Options dialog, there is a check mark in the check box for Register TimesTen environment variables. If you choose to register the TimesTen environment variables, leave this box checked. Then choose Next.
Notes:
Settings made by registering environment variables are reflected in the System control panel and persist across sessions. It is advisable to reboot the system after the installation to ensure that Windows re-reads the registry and propagates the environment settings.
If you do not register environment variables during installation, you can run ttenv.bat
from the TimesTen bin
directory (in a DOS window) for each session. This sets PATH
, CLASSPATH
, and TIMESTEN_HOME
(but not LIB
and INCLUDE
).
Registering environment variables is not advisable if you are installing multiple releases of TimesTen, in which case the path could cause unexpected behavior. Multiple installations must be from different major releases, such as 11.2.2.w.x and 18.1.y.z.
In the "Select which version of Java to add to the CLASSPATH
" dialog, select one of the options: JDK 8, JDK 9, JDK 10, JDK 11, or None. Then choose Next.
In the Installation Information dialog, confirm settings. Choose Back to make changes. Otherwise, choose Next.
The Setup Status dialog displays with a message indicating your new installation is being configured.
Additional dialogs and windows display, indicating that timesten.conf
is updated and TimesTen is configured.
In the InstallShield Wizard Complete dialog, choose Finish (optionally choosing to display the TimesTen release notes).
Verifying the installation on Windows includes:
To verify that the TimesTen client has been properly installed:
Confirm that the TimesTen 18.1 shortcut (for example, "TimesTen 18.1 (64-bit)") appears under Apps & features (or the equivalent).
From Administrative Tools, select ODBC Data Sources (64-bit). This opens the ODBC Data Source Administrator (64-bit) menu. Choose the Drivers tab.
Confirm that the TimesTen Client 18.1 driver is installed. Click OK.
This is a sample directory structure after a successful installation. Not all directories are included in this sample.
C:\TimesTen tt181_64 bin [contains TimesTen utilities and executables] doc [contains Help files only] include [contains TimesTen include files] instance bin [link to tt181_64\bin] conf diag info install [link to tt181_64] plsql utl_file_temp [for PL/SQL UTL_FILE package] lib plsql
You may also review the timesten.conf
file located in the instance\conf
directory of the installation folder (for example, C:\TimesTen\tt181_64\instance\conf
). The daemon_port
value and the server_port
value can be ignored. The hostname
indicates the host name on which you performed the installation.
# TimesTen Instance Configuration File # Commented values are default values hostname=host1 timesten_release=18.1 instance_name=instance daemon_port= server_port= tns_admin=:TNS_ADMIN: admin_user=ttuser userlog=C:\TimesTen\tt181_64\instance\diag\tterrors.log supportlog=C:\TimesTen\tt181_64\instance\diag\ttmesg.log client_only=yes # By default, turn verbose logging on verbose=1
This section discusses the steps to delete the installation and also the steps to verify the uninstallation was successful:
Uninstall TimesTen on Windows through the Apps & features menu list, much as you would other Windows programs.
Note:
Uninstallation will delete the TimesTen installation as well as the TimesTen instance that was created as part of the installation.From the Apps & features menu list, locate Oracle TimesTen In-Memory Database 18.1 (64-bit).
Choose Uninstall.
The "This app and its related info will be uninstalled" dialog displays. Choose Uninstall.
In the Question dialog, the "Are you sure you want to uninstall TimesTen In-Memory Database Client 18.1?" question displays. Choose Yes.
In the Confirm Uninstall dialog, the "Do you want to completely remove the selected application and all its features?" question displays. Choose OK.
In the Question dialog, the "Would you like to delete all DSNs associated with TimesTen 18.1?" question displays. If you choose Yes, you will not be able to access your existing databases. Choose Yes or No.
Note:
The uninistallation process begins. Even for uninstallation, there is a dialog that says, "Configuring your new software installation."The Maintenance Complete dialog displays indicating the uninstallation is complete. Choose Finish.
To verify that uninstallation was successful, confirm that:
TimesTen 18.1 has been removed from Apps & features.
The TimesTen Client 18.1 driver is not listed in the Drivers tab in the ODBC Data Source Administrator.
The installation directory has been deleted (by default, C:\TimesTen\tt181_64
). If not, delete it and any remaining contents manually.
If this is the only TimesTen installation, you can delete the TimesTen
directory. If there are other installations (such as an 11.2.2
installation), then delete only the t
t181_64
directory.
Note:
If any files are open to Windows Explorer, you may have to use the Task Manager to end theexplorer
process before you can delete the installation directory and its contents.