1. リファレンス
  2. ユーティリティ
  3. ttInstanceCreate

ttInstanceCreate

ttInstanceCreateユーティリティは、使用可能なオプションで指定した値、動作、特性を持つ、新しいTimesTenインスタンスを作成します。

次の方法のいずれかでオプションを指定できます。

  • コマンドラインで。

  • ファイル内。

  • ユーティリティが実行されるとき、対話的に。

コマンド・ラインでオプションを指定しなかった場合や、使用したオプションが-recordまたは-verbose (または両方)のみの場合、ttInstanceCreateは対話モードで実行され、インスタンスの設定に必要な情報がインスタンス管理者に要求されます。

コマンドラインで-batchオプションを指定した場合、ttInstanceCreateは対話モードで実行され、-recordオプションを指定した前回の実行で生成された回答を記録されたバッチ・ファイルからフェッチすることによって、質問への回答を試みます。質問に対する回答がバッチ・ファイルに存在しない場合、ユーティリティは質問に対話で回答するようインスタンス管理者に要求します。

コマンドラインでその他のオプションを指定した場合、それらは情報のソースとして使用されます。ttInstanceCreateユーティリティは、不明な値についてユーザーに入力を求めません。

TimesTen ScaleoutおよびTimesTen Classicでの使用

このユーティリティは、TimesTen ClassicとTimesTen Scaleoutの両方でサポートされています。TimesTenでは、Scaleoutは最初の管理インスタンスの作成にのみ使用されます。追加のインスタンスを作成するにはttGridAdmin instanceCreateを使用します。

必要な権限

このユーティリティには、インスタンス管理者の権限が必要です。

構文

ttInstanceCreate {-h | -help | -?} [-verbose]

TimesTen Classicのインスタンスを作成するには、次を使用します。

ttInstanceCreate [-name name] [-location path] [-daemonport port] [-csport port] ]
 [-start] [-tnsadmin path] [-force] [-record filename] [-strict] [-verbose]
 [-serverEncryption {accepted|rejected|requested|required} -serverCipherSuites {comma-separated list}]

TimesTen Scaleoutでグリッドの最初の管理インスタンスを作成するには、次を使用します。

ttInstanceCreate [-name name] [-location path] [-daemonport port] [-csport port]
 [-grid] [-force] [-record filename] [-strict] [-verbose]

TimesTen ScaleoutでTLSを使用するグリッドの最初の管理インスタンスを作成するには、次を使用します:

ttInstanceCreate [-name name] [-location path] [-daemonport port] [-csport port]
 [-grid] [-serverEncryption {accepted|rejected|requested|required}] -serverCipherSuites {suites}
 [-force] [-record filename] [-strict] [-verbose]
メイン・デーモンがsystemdによって管理されるインスタンスを作成するには、次を使用します:
ttInstanceCreate [-name name] [-location path] [-daemonport port] [-csport port]
 [-grid] [-force] [-record filename] [-strict] [-verbose] [-systemd]

クライアントのみのインスタンスを作成するには、次を使用します。

ttInstanceCreate [-name name] [-location path] [-clientonly]
 [-force] [-record filename] [-strict] [-verbose]

ttInstanceCreate [-batch [filename]]

オプション

ttInstanceCreateには次のオプションがあります。

オプション 説明

-h

-help

-?

ヘルプ情報を表示します。

-name name

作成するインスタンスの名前を指定します。

-location path

インスタンスが作成されるディレクトリのパスを指定します。このディレクトリはすでに存在する必要があります。既存のディレクトリに新しいディレクトリが作成されます。新しいディレクトリの名前は-nameオプションで指定します。この新しいディレクトリが新しいインスタンス・ホームになります。

-force

-instanceオプションで指定したインスタンス・ディレクトリがすでに存在する場合、このディレクトリが上書きされることを指定します。ディレクトリは次の場合にのみ上書きされます。

1. 指定したインスタンス・ディレクトリが空である場合、または

2. 指定したインスタンス・ディレクトリにconf/timesten.confファイルが含まれる場合。

-record filename

インストール時の質問に対する応答を、filenameで指定したファイルに記録します。その後、このファイルを-batchオプションに対するパラメータとして指定できます。

-batch [filename]

ttInstanceCreateユーティリティへの入力を指定するために使用されるファイルを指定します。指定しなかった場合、入力ファイルは使用されません。

-strict

コマンドを実行しているプラットフォームがサポートされていることを確認し、そうでない場合はインスタンスの作成を回避します。

-serverEncryption {accepted|rejected|requested|required}

暗号化をクライアント/サーバー接続で受け入れるか、拒否するか、リクエストするか、または必須にするかを決定します。

  • accepted: クライアントによって必要とされる場合またはリクエストされた場合は、暗号化されたセッションを有効にします。それ以外の場合は、暗号化されていないセッションを使用します。これはデフォルトです。
  • rejected: 暗号化されていないセッションを要求します。(サーバーが暗号化をサポートしていない場合、TimesTenは、これがサーバー上の設定であるかのように動作します。)クライアントが暗号化を必要とする場合、接続は拒否されます。
  • requested: クライアントで許可されている場合は暗号化されたセッションをリクエストします(クライアントでrejected以外の設定が使用されている場合)。それ以外の場合は暗号化されていないセッションを使用します。
  • required: 暗号化されたセッションを要求します。クライアントが暗号化を拒否している場合、接続を拒否します。

拒否以外の設定を使用すると、サーバーとクライアント間にサーバー暗号化の互換性がある設定がある場合(暗号スイートに互換性のある設定があるかぎり)、ttInstanceCreateユーティリティはTLSの証明書を生成します。『Oracle TimesTen In-Memory Databaseセキュリティ・ガイド』の「クライアント/サーバー用のTLSの構成」を参照してください

-serverEncryptionおよび-serverCipherSuitesの値は、timesten.confファイルのインスタンス作成レベルで設定され、そのインスタンスで作成されたデータベースのデフォルト値として使用されます。ただし、データベース定義で対応する接続属性を設定することで、それらをオーバーライドできます。

ノート: インスタンスの作成時に証明書を作成しなかった場合は、ttCreateCertsユーティリティを手動で実行して、特定のデータベースでTLSを使用する必要があります。

.

-serverEncryptionおよび-serverCipherSuitesオプションの使用方法は、『Oracle TimesTen In-Memory Databaseセキュリティ・ガイド』の「タスク2: TimesTen ClassicでのTLSのサーバー構成の設定」を参照してください。

-serverCipherSuites {suites}

クライアントの設定にも応じて、Transport Layer Securityに使用できる暗号スイートまたはスイートがリストされますこれらのスイートの1つ以上を(カンマ区切りで優先順に)指定します。

SSL_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
SSL_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
SSL_RSA_WITH_AES_128_CBC_SHA256

デフォルト設定はありません。TLSを使用するには、サーバーおよびクライアント設定に1つ以上の共通スイートが含まれている必要があります。詳細は、『Oracle TimesTen In-Memory Databaseセキュリティ・ガイド』の「TimesTen Client/Server用のTransport Layer Security」を参照してください。

-tnsadmin location

キャッシュ操作の場合、このオプションはTNS_ADMIN設定に使用される場所を構成します。

-verbose

ユーティリティの操作中に追加情報を表示します。

-grid

TimesTen Scaleoutで使用されるようにインスタンスを構成する必要があることを示します。

-systemd

インスタンスのメイン・デーモンがsystemdによって管理されるように指定します。

-clientonly

インスタンスがクライアント専用であることを指定します。他のほとんどの引数はクライアント専用インスタンスではサポートされません。

クライアントおよびサーバー機能を持つインスタンス全体に次のオプションを使用します。

オプション 説明

-daemonport daemon_port

このインスタンスのTimesTenデーモン・プロセス(timestend)がリスニングするポート番号。このポートは、システム上の他のアプリケーションまたはインスタンスで未使用であることが必要です。

-csport port

このインスタンスのTimesTenのクライアント/サーバー・ポート番号に使用される値。指定しなかった場合、デフォルトはdaemonport + 1です。

このオプションは、TimesTen Classicを対象としたインスタンスの場合に使用します。

オプション 説明

-start

インスタンス作成後にそのインスタンスが起動されるように指定します。