Copyright (c) 2010, 2021, Oracle and/or its affiliates. All rights reserved.
Windows is a client only platform for TimesTen; you cannot host a TimesTen database on Windows. You can access a TimesTen database, running on another machine, from a Windows machine, using the TimesTen Windows client.
To use this sample you will need access to a TimesTen database running on a Unix or Linux platform, as well as a Windows machine with .NET 4.0 development environment.
The following steps must be performed on the Unix/Linux machine hosting the TimesTen database. You will need to have a copy of the QuickStart files available on that machine.
-
Manually Configure the Sample DSN for the Sample Programs; refer to quickstart/classic/html/developer/sample_dsn_setup.html
-
Set up sample database and user accounts
The following build_sampledb script should be run once to set up the sample database and user accounts. First set up the Instance Environment Variables e.g. If your TimesTen instance location is under /home/timesten/instance/tt221 directory, execute the command
source /home/timesten/instance/tt221/bin/ttenv.sh
Run the quickstart/classic/sample_scripts/createdb/build_sampledb script, which creates the sample database and user accounts that are used by the sample programs. This script creates the TimesTen user accounts and prompts you for the desired user passwords.
Unix/Linux:
cd quickstart/classic/sample_scripts/createdb
./build_sampledb.sh
The following steps should be performed on the Windows client machine.
-
Download and install the TimesTen Windows client. Be sure to select the check box to 'Register Environment Variables'. You will need to log out of Windows and then log back in (or restart the Windows machine) before proceeding.
-
Configure an ODBC client DSN named sampledbCS for connection to the database hosted on your Unix/Linux sytem (consult the TimesTen documentation for instructions, if required).
-
Download and install Oracle Data Provider for .NET (ODP.NET).
To compile the sample program on the Windows machine:
-
Open a Visual Studio command prompt.
-
Change directory to the directory containg the sample program (DemoODP.cs).
-
Compile the program:
csc /out:DemoODP.exe /reference:<path\to\Oracle.DataAccess.dll> DemoODP.cs
NOTE: You need to reference the Oracle.DataAccess.dll assembly located in your ODP.NET installation.
Run the program specifying an 'easy connect' specifier that references the client DSN (sampledbCS), the database username and password:
DemoODP -db localhost/sampledbCS:timesten_client -user appuser -passwd <password>
For all available program options, use:
DemoODP -help
For more information on how to use ODP.NET to develop programs for the TimesTen database, see the ODP.NET Support for TimesTen User's Guide.