Associate an Instance with a Different Installation (Upgrade or Downgrade)

You can use the ttInstanceModify -install option to associate the instance with a different TimesTen installation. This is typically used to upgrade the instance to a new maintenance or patch release. It cannot be used to upgrade to a new major release (such as going from 22.1 to 26.1).

This example upgrades from the ttinstall installation to the ttinstalllatest installation. The current directory is timesten_home for the ttuser1instance instance.

Optional: Before running $TIMESTEN_HOME/bin/ttInstanceModify, you can review the timesten_home/install directories and files to gain an understanding of the symbolic links that are defined.

Navigate to the timesten_home/install directory and run the Linux ls -l command to list the directories and the files within this directory. Note that symbolic links to the installation directory are defined for most of the files and the directories within this timesten_home/install directory. (In this example, swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0 is the installation directory.)

% cd timesten_home/install
% ls -l
...
lrwxrwxrwx 1 ttuser1 timesten   56 Jun 28 11:13 3rdparty -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/3rdparty
lrwxrwxrwx 1 ttuser1 timesten   52 Jun 28 11:13 PERL -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/PERL
lrwxrwxrwx 1 ttuser1 timesten   59 Jun 28 11:13 README.html -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/README.html
lrwxrwxrwx 1 ttuser1 timesten   51 Jun 28 11:13 bin -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/bin
lrwxrwxrwx 1 ttuser1 timesten   52 Jun 28 11:13 grid -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/grid
lrwxrwxrwx 1 ttuser1 timestten   55 Jun 28 11:13 include -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/include
lrwxrwxrwx 1 ttuser1 timesten   52 Jun 28 11:13 info -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/info
drwxr-x--- 2 ttuser1 timesten 4096 Jun 28 11:13 lib
lrwxrwxrwx 1 ttuser1 timesten   55 Jun 28 11:13 network -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/network
lrwxrwxrwx 1 ttuser1 timesten   51 Jun 28 11:13 nls -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/nls
lrwxrwxrwx 1 ttuser1 timesten   61 Jun 28 11:13 oraclescripts -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/oraclescripts
lrwxrwxrwx 1 ttuser1 timesten   53 Jun 28 11:13 plsql -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/plsql
lrwxrwxrwx 1 ttuser1 timesten   55 Jun 28 11:13 startup -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/startup
lrwxrwxrwx 1 ttuser1 timesten   55 Jun 28 11:13 support -> 
/swdir/TimesTen/ttinstallations/ttinstall/tt26.1.1.1.0/support
drwxr-x--- 3 ttuser1 timesten 4096 Jun 28 11:13 ttoracle_home

Now run $TIMESTEN_HOME/bin/ttInstanceModify -install to associate the ttuser1instance instance with the new installation (/swdir/TimesTen/ttinstallations/ttinstalllatest/26.1.1.2.0, in this example).

% $TIMESTEN_HOME/bin/ttInstanceModify 
/swdir/TimesTen/ttinstallations/ttinstalllatest/26.1.1.2.0

Instance Info (UPDATED)
-----------------------
 
Name:           ttuser1instance
Version:        26.1.1.2.0
Location:       /swdir/TimesTen/ttinstances/ttuser1instance
Installation:   /swdir/TimesTen/ttinstallations/ttinstalllatest/26.1.1.2.0
Daemon Port:    21000
Server Port:    21001

The instance ttuser1instance now points to the installation in 
/swdir/TimesTen/ttinstallations/ttinstalllatest/26.1.1.2.0

After running ttInstanceModify, note the symbolic links within the $TIMESTEN_HOME/install directory point to the new installation directory.

% cd $TIMESTEN_HOME/install
% ls -l
...
lrwxrwxrwx 1 ttuser1 timesten   55 Jun 28 13:07 3rdparty -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt/3rdparty
lrwxrwxrwx 1 ttuser1 timesten   51 Jun 28 13:07 PERL -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/PERL
lrwxrwxrwx 1 ttuser1 timesten   58 Jun 28 13:07 README.html -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/README.html
lrwxrwxrwx 1 ttuser1 timesten   50 Jun 28 13:07 bin -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/bin
lrwxrwxrwx 1 ttuser1 timesten   51 Jun 28 13:07 grid -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/grid
lrwxrwxrwx 1 ttuser1 timesten   54 Jun 28 13:07 include -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/include
lrwxrwxrwx 1 ttuser1 timesten   51 Jun 28 13:07 info -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/info
lrwxrwxrwx 1 ttuser1 timesten   57 Jun 28 13:07 kubernetes -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/kubernetes
drwxrwxr-x 2 ttuser1 timesten 4096 Jun 28 13:07 lib
lrwxrwxrwx 1 ttuser1 timesten   54 Jun 28 13:07 network -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/network
lrwxrwxrwx 1 ttuser1 timesten   50 Jun 28 13:07 nls -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/nls
lrwxrwxrwx 1 ttuser1 timesten   60 Jun 28 13:07 oraclescripts -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/oraclescripts
lrwxrwxrwx 1 ttuser1 timesten   52 Jun 28 13:07 plsql -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/plsql
lrwxrwxrwx 1 ttuser1 timesten   54 Jun 28 13:07 startup -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/startup
lrwxrwxrwx 1 ttuser1 timesten   54 Jun 28 13:07 support -> 
/swdir/TimesTen/ttinstallations/ttinstalllatest/tt26.1.1.2.0/support
drwxrwxr-x 3 ttuser1 timesten 4096 Jun 28 13:07 ttoracle_home