クライアント・インスタンスのアップグレードの実行

完全インスタンスでデータベースにアクセスするために使用されているクライアント・インスタンスをアップグレードできます。インスタンスの詳細は、インストール環境およびインスタンスの概要およびTimesTenインスタンスを参照してください。クライアント/サーバーの詳細は、Oracle TimesTen In-Memory Databaseオペレーション・ガイドのTimesTenクライアント/サーバーの概要を参照してください。

アップグレードを実行するには、次のステップに従います。

オプション: このステップは、TimesTenクライアントのリリース情報の識別および検証に役立つ情報を提供することを目的として用意されています。
クライアント・インスタンスでttVersionユーティリティを実行し、クライアントのリリースとクライアント・インスタンスを確認します。この例では、クライアント・インスタンスでttVersionを実行すると、クライアントのリリースが22.1.1.29.0で、クライアント・インスタンスがinstance_221_clientであることが示されます。
```
% ttVersion
TimesTen Release 22.1.1.29.0  (64 bit Linux/x86_64) (instance_221_client)
2024-06-29T23:22:07Z
  Instance home directory: /scratch/instance_221_client
  Group owner: g900
```
オプション: このステップは、database1データベースへのクライアント接続を確立して表示するための情報提供の目的で含められています。クライアント・インスタンスで、ttIsqlCSを実行して(サーバー上の)完全インスタンスのdatabase1データベースに接続します。TCP_PORTが指定されていないことに注意してください。デフォルト値が前提とされています。
```
% ttIsqlCS -connstr "TTC_SERVER=server.mycompany.com;TTC_SERVER_DSN=database1";
 
Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved.
Type ? or "help" for help, type "exit" to quit ttIsql.
 
 
 
connect "TTC_SERVER=server.mycompany.com;TTC_SERVER_DSN=database1";
Connection successful: DSN=;TTC_SERVER=server.mycompany.com;
TTC_SERVER_DSN=database1;
...
(Default setting AutoCommit=1)
```

クライアント・インスタンスを使用しているすべてのアプリケーションを停止します。この例では、クライアント・インスタンスで最初にttIsqlCSを実行してdatabase1データベースに接続してから、ttIsqlCSを終了します。

% ttIsqlCS -connstr "TTC_SERVER=server.mycompany.com;
TTC_SERVER_DSN=database1";
 
Copyright (c) 1996, 2021, Oracle and/or its affiliates. All rights reserved.
Type ? or "help" for help, type "exit" to quit ttIsql.
 
 
 
connect "TTC_SERVER=server.mycompany.com;TTC_SERVER_DSN=database1";
Connection successful: DSN=;TTC_SERVER=server.mycompany.com;
TTC_SERVER_DSN=database1;
...
(Default setting AutoCommit=1)
Command> exit
Disconnecting...
Done.

新しい場所に新しいクライアント・インストール環境を作成します。たとえば、clientinstall_newインストール・ディレクトリを作成します。次に、新しいリリースのzipファイルをそのディレクトリに解凍します。たとえば、Oracle Linux for Intel and AMD上で22.1.1.30.0インストール環境を作成するには、timesten2211300.server.linux8664.zipをclientinstall_newディレクトリに解凍します。(Linux 64ビットには、1つのディストリビューションのみがあります。このディストリビューションには、サーバーとクライアントのインストール環境が含まれています。)
```
% mkdir clientinstall_new
% cd clientinstall_new
% unzip /swdir/TimesTen/ttinstallers/timesten2211300.server.linux8664.zip
[...UNZIP OUTPUT...]
```
詳細は、TimesTenのインストール環境を参照してください。
新しいインストール環境を指すようにクライアント・インスタンスを変更します。このためには、クライアント・インスタンスの$TIMESTEN_HOME/binディレクトリから、-installオプションを指定してttInstanceModifyユーティリティを実行します。
この例では、/clientinstall_new/tt22.1.1.30.0内のインストール環境をクライアント・インスタンスが指すようにします。
```
% $TIMESTEN_HOME/bin/ttInstanceModify -install 
 /clientinstall_new/tt22.1.1.30.0
 
Instance Info (UPDATED)
-----------------------
 
Name:           instance_221_client
Version:        22.1.1.30.0
Location:       /scratch/instance__client
Installation:   /clientinstall_new/tt22.1.1.30.0
 
* Client-Only Installation
 
 
The instance instance_221_client now points to the installation in 
clientinstall_new/tt22.1.1.29.0
```
オプション: クライアント・インスタンスでttVersionユーティリティを実行してクライアントのリリースが22.1.1.30.0であることを確認します。
```
% ttVersion
TimesTen Release 22.1.1.30.0 (64 bit Linux/x86_64) (instance_221_client) 2021-06-28T22:37:51Z
  Instance home directory: /scratch/instance_221_client
  Group owner: g900
```

クライアント・インスタンスを使用するアプリケーションを再起動します。

この例では、クライアント・インスタンスで最初にttIsqlCSを実行して完全インスタンス内のdatabase1データベースに接続します。

% ttIsqlCS -connstr "TTC_SERVER=server.mycompany.com;
TTC_SERVER_DSN=database1";
 
Copyright (c) 1996, 2021, Oracle and/or its affiliates. All rights reserved.
Type ? or "help" for help, type "exit" to quit ttIsql.
 
 
 
connect "TTC_SERVER=server.mycompany.com;TTC_SERVER_DSN=database1";
Connection successful: DSN=;TTC_SERVER=server.mycompany.com;
TTC_SERVER_DSN=database1;
...
(Default setting AutoCommit=1)

オプション: 以前のリリースのインストール環境(クライアントで使用)を削除します。
```
% chmod -R 750 installation_dir/tt22.1.1.30.0
% rm -rf installation_dir/tt22.1.1.30.0
```