環境変数
TimesTen Scaleoutを正しく動作させるには適切な設定が必要な環境変数がいくつかあります。
環境変数の設定
ターミナル・ウィンドウの環境変数を設定することで、このウィンドウで特定のインスタンスに対してコマンドを実行することが可能になります。次の状況において、環境変数を設定することが必要になります。
-
アクティブ管理インスタンスを作成した後
-
ttGridAdminまたは任意のTimesTenユーティリティを使用する前 -
データ・インスタンスを実行しているホスト上で直接モード・アプリケーションを実行する前
-
クライアント(またはデータ)・インスタンスを実行しているホスト上でクライアント・サーバー・アプリケーションを実行する前
環境変数を設定するには、ttenvシェル・スクリプト(ttenv.shまたはttenv.csh)にソースを指定します。インスタンスを作成した後に、TimesTenによってスクリプトが作成されます。これらのスクリプトは、grid/instance1/binディレクトリにあります(grid/instance1はそのインスタンスのフル・パスです)。これらのスクリプトにソースを指定することで、TimesTen Scaleoutインスタンスを使用するために必要な環境変数が設定されます。
これらの環境変数としては、TIMESTEN_HOME、PATH、LD_LIBRARY_PATH (または同等のもの)、TNS_ADMINなどがあります。
例:
sh、bash、zsh、kshなどのBourne型のシェルの場合
$ . ttenv.shcshまたはtcshシェルの場合
% source ttenv.cshTIMESTEN_HOME環境変数
TIMESTEN_HOME環境変数は、TimesTen Scaleoutインスタンスのホーム・ディレクトリを指定します。ttenvスクリプトにソースを指定するときに、この変数を明示的に設定します。
NLS_LANG環境変数
データベース定義ファイルで指定された文字セットは、デフォルトで接続用に使用されますが、その文字セットがNLS_LANGによってオーバーライドされている場合や、接続可能オブジェクト内にある場合は除きます。文字セットを明示的に設定することをお薦めしますが、デフォルトの文字セットは通常はAMERICAN_AMERICA.US7ASCIIです。環境変数を使用して文字セットを設定するには、次の手順を実行します。
% setenv NLS_LANG AMERICAN_AMERICA.WE8ISO8859P1『Oracle TimesTen In-Memory Database C開発者ガイド』の文字セットの指定、および『Oracle TimesTen In-Memory Databaseリファレンス』のDatabaseCharacterSetを参照してください。
共有ライブラリ・パス環境変数
共有ライブラリ・パスの環境変数は、ttenvにソースを指定するときに設定されます。この環境変数は、共有ライブラリのパスを指定します。ttenvスクリプトによって、LD_LIBRARY_PATHに$TIMESTEN_HOME/install/libが追加されます。
PATH環境変数
TimesTenには、アプリケーションを管理およびデバッグするための各種ユーティリティが用意されています。これらのユーティリティを使用可能にするには、$TIMESTEN_HOME/binおよび$TIMESTEN_HOME/install/bin内の実行可能ファイルのパスをPATH設定で指定する必要があります。ttenvにソースを指定すると、パスが更新されて、これらのディレクトリがパスに含まれるようになります。
また、プログラムをコンパイルするには、使用するプログラミング言語のコンパイラの場所がPATH環境変数で指定されていることを確認してください。
TNS_ADMIN環境変数
TNS_ADMIN環境変数は、tnsnames.oraファイルが配置されているディレクトリのフル・パスを指定します。
-
TimesTenのOCI、Pro*C/C++またはODP.NETについては、
tnsnames.oraファイルが配置されているディレクトリのフル・パスをTNS_ADMIN環境変数で指定します。 -
TimesTen Scaleoutによって、すべてのインスタンスの
tnsnames.oraファイルに、すべての接続可能オブジェクトのエントリが自動的に移入されます。関連する構成ファイルはTimesTen Scaleoutによって所有されているため、これらのエントリを手動で設定しないでください。 -
tnsnamesおよび追加エントリ(該当する場合はOracleデータベース接続のエントリなど)の関連情報は、ttGridAdmin TNSNamesImportおよびttGridAdmin SQLNetImportコマンドによって取り込まれて配布されます。『Oracle TimesTen In-Memory Databaseリファレンス』のTNS名のインポート(TNSNamesImport)およびSQLNetファイルのインポート(SQLNetImport)を参照してください。
Java環境変数
Javaアプリケーションについては、関係がある追加の環境変数が存在します。次の各トピックでは、Javaアプリケーションに影響を与える追加の環境変数や考慮事項について説明します。
CLASSPATH環境変数
Javaのクラスとクラス・ライブラリは、CLASSPATH環境変数で指定されたクラス・パス上で検出されます。いずれかのTimesTen JDBCドライバをロードするJavaプログラムを実行する前に、CLASSPATH環境変数でクラス・ライブラリのファイルとパスが指定されている必要があります。
$TIMESTEN_HOME/install/lib/ttjdbcJDK_VER.jarここで、JDK_VERはJDKバージョンを示します。JDK8の場合は、JDK_VERは8であり、ファイル名はttjdbc8.jarです。
ノート:
複数のJARファイルがCLASSPATHにリストされている場合は、TimesTen JARファイルが最初にリストされていることを確認します。
CLASSPATHの要素はコロンで区切ります。たとえば、次のように記述します(sh型のシェル)。
CLASSPATH=.:$TIMESTEN_HOME/install/lib/ttjdbc8.jar
export CLASSPATHまたは次のように実行します(csh型のシェル)。
setenv CLASSPATH .:$TIMESTEN_HOME/install/lib/ttjdbc8.jarJDKのバージョンを確認するには、次のように実行します。
java -version