TimesTenのクライアント・インスタンスの作成

インスタンス管理者がディストリビューションを解凍し、その結果としてインストールが作成された後、次のステップではTimesTenクライアント・インスタンスを作成します。このためには、installation_dir/tt22.1.1.29.0/binディレクトリにあるttInstanceCreateユーティリティを実行します。

ノート:

ディストリビューションを解凍したユーザー(インストール環境の作成者)のみが、インストール環境からインスタンスを作成できます。
このユーザーは、TimesTenユーザー・グループのメンバーである必要があります。
このユーザーは、このインスタンス、およびインストール環境に関連付けられている他のすべてのインスタンスのインスタンス管理者になることができる唯一のユーザーです。

内容は次のとおりです。

ttInstanceCreateユーティリティの概要

ttInstanceCreateユーティリティのオプションを指定できます。

コマンドラインで
ファイル内に
ユーティリティが実行されるとき、対話的に

-helpオプションを指定してttInstanceCreateを実行し、使用可能なオプションを表示することもできます。詳細は、Oracle TimesTen In-Memory DatabaseリファレンスのttInstanceCreateを参照してください。

ノート:

macOSまたはLinux 32ビット・ホストでクライアントのみのインストールを行う場合、ttInstanceCreate -clientonlyオプションは任意です。

TimesTenクライアント・インスタンスの作成例

TimesTenのクライアント・インスタンスは、TimesTen ScaleoutのデータベースまたはTimesTen Classicのデータベースに接続するために使用できます。

クライアント・インスタンスを作成するには、installation_dir/tt22.1.1.29.0/bin領域に移動し、ttInstanceCreateユーティリティを実行します。

クライアント・インスタンスを作成したら、DSNを設定し、ステップに従ってクライアントからサーバーに接続できます。詳細は、Oracle TimesTen In-Memory Databaseオペレーション・ガイドのTimesTen ClientおよびTimesTen Serverの使用方法を参照してください。

次の項では、ttInstanceCreateユーティリティを使用してクライアント・インスタンスを作成する方法を示します。

ttInstanceCreateを使用して対話形式でクライアント・インスタンスを作成する

この例では、ttInstanceCreateユーティリティを対話形式で実行してクライアント・インスタンスを作成します。インストール・ディレクトリからユーティリティを実行できます。ユーザーの入力は太字で示されています。

% installation_dir/tt22.1.1.29.0/bin/ttInstanceCreate
 
* Client installation detected.
 
NOTE: Each TimesTen instance is identified by a unique name.
      The instance name must be a non-null alphanumeric string, not longer
      than 255 characters.
 
Please choose an instance name for this installation? [ tt221 ] clientmac
Instance name will be 'clientmac'.
Is this correct? [ yes ]
Where would you like to install the clientmac instance of TimesTen? 
[/home/ttuser ] /scratch/ttuser
Creating instance in /scratch/ttuser/clientmac ...
INFO: Mapping files from the installation to
 /scratch/ttuser/clientmac/install
The 22.1 Release Notes are located here :
  '/installation_dir/tt22.1.1.29.0/README.html'

ttInstanceCreateを使用して、コマンドラインでオプションを指定する

% installation_dir/tt22.1.1.29.0/bin/ttInstanceCreate
 
* Client installation detected.
 
NOTE: Each TimesTen instance is identified by a unique name.
      The instance name must be a non-null alphanumeric string, not longer
      than 255 characters.
 
Please choose an instance name for this installation? [ tt221 ] clientmac
Instance name will be 'clientmac'.
Is this correct? [ yes ]
Where would you like to install the clientmac instance of TimesTen? 
[/home/ttuser ] /scratch/ttuser
Creating instance in /scratch/ttuser/clientmac ...
INFO: Mapping files from the installation to
 /scratch/ttuser/clientmac/install
The 22.1 Release Notes are located here :
  '/installation_dir/tt22.1.1.29.0/README.html'

インスタンス・ホーム・ディレクトリおよびサブディレクトリの確認

インスタンス・ホーム・ディレクトリおよびサブディレクトリは、情報を得るために確認できます。インスタンスを作成すると、各インスタンスの$TIMESTEN_HOMEの下に次のサブディレクトリが含まれています(このリストには含まれていないサブディレクトリもあります)。

bin: そのインスタンスに適応するように調整された、インスタンス固有のTimesTenユーティリティおよび実行可能ファイル

これに含まれるttenv.sh (またはttenv.csh)によって、TimesTen環境の環境変数がセッションに適するように設定され、setuproot.shをrootとして実行することで、オペレーティング・システムが再起動されるたびにデータ・インスタンスを自動的に起動させることができます。

ttenvを実行すると、binディレクトリもパスに追加されます。
conf: TimesTenインスタンスの構成ファイルであるtimesten.confファイルが含まれます
diag: デーモン・ログとエラー・ログを含む診断出力
info: TimesTenインスタンスの永続状態が格納されているTimesTenデーモンの作業ディレクトリ
install: このインスタンスに関連付けられているインストール内容を参照するシンボリック・リンク。
plsql: 次のサブディレクトリが含まれます。
- utl_file_dir: UTL_FILEパッケージを使用してPL/SQLブロックによる読取りや書込みが可能な唯一のディレクトリ

timesten.confファイルの確認

インスタンスの構成ファイルは、TimesTenインスタンスの属性を定義します。詳細は、インスタンスの構成ファイル(timesten.conf)を参照してください。

サンプル・ファイルを次に示します。コメントは"#"で示されています。

# TimesTen Instance Configuration File
# Created by ttInstanceCreate
# Commented values are default values
hostname=host1
client_only=yes
timesten_release=22.1
instance_name=clientmac
daemon_port=-
admin_user=myadmin
admin_uid=12345
group_name=ttgroup
instance_guid=FE8D9351-E749-41B4-AEC9-6E27BCA882A5
verbose=1