Interstage Application Server/Interstage Web Server J2EE ユーザーズガイド

4.3.2 Oracleを使用する場合の環境設定

　Oracleを使用する場合は、以下の環境設定が必要です。

　Oracle Real Application Clustersを使用する場合は、Oracle Real Application Clustersとの連携を参照してください。

• 環境変数の設定
• Interstageへのデータソース登録

　また、File System Service Providerを使用する場合は、上記に加え、以下の作業を行ってください。デフォルトではFile System Service Providerを使用しないデータソースが定義されます。V8.0互換モードのIJServerまたは8.0以前に作成されたIJServerからデータソースを使用する場合は、File System Service Providerを使用する必要があります。

• File System Service Providerを使用する場合の環境設定

■環境変数の設定

　設定する環境変数の設定項目と、動作環境ごとの設定方法は以下のとおりです。

◆設定項目

　Oracle JDBCドライバを動作させるために必要な、以下を設定してください。Oracleホーム・ディレクトリは、Oracle製品のソフトウェアをインストールするために選択したディレクトリです。使用するOracleがインストールされている、Oracleホーム・ディレクトリを指定してください。
　詳細は、Oracleのマニュアルを参照してください。
　また、各JDBCドライバがサポートするJavaバージョンについては各JDBCドライバのマニュアルを参照してください。

設定項目	Oracleの バージョン(注1)	設定値 (注2)
クラスパス	Oracle9i以前	Oracleホーム・ディレクトリ\jdbc\lib\ojdbc14.jar
		Oracleホーム・ディレクトリ\jdbc\lib\nls_charset12.jar または Oracleホーム・ディレクトリ\jdbc\lib\nls_charset12.zip
	Oracle10g	Oracleホーム・ディレクトリ\jdbc\lib\ojdbc14.jar
		Oracleホーム・ディレクトリ\jlib\orai18n.jar
	Oracle11g以降	Oracleホーム・ディレクトリ\jdbc\lib\ojdbc5.jar
		Oracleホーム・ディレクトリ\jlib\orai18n.jar

注1) Windows Server 2003 for Itanium-based Systems/RHEL-AS4(IPF)/RHEL5(IPF)の場合は、Oracle10g以降を使用してください。
注2) SolarisまたはLinuxの場合、“\”を“/”に読み替えてください。

　OCIドライバを使用する場合には、上記の設定に加えて以下の設定が必要です。

設定項目	Oracleの バージョン	設定値
パス	共通	Oracleホーム・ディレクトリ\bin

設定項目	Oracleの バージョン(注1)	設定値
ライブラリパス	Oracle9i以前	Oracleホーム・ディレクトリ/lib (注2)
	Oracle10g以降(注3)	Oracleのインストールディレクトリ/lib32 (注4)
		Oracleホーム・ディレクトリ/lib
ORACLE_HOME	共通	Oracleホーム・ディレクトリ

注1) RHEL-AS4(IPF)/RHEL5(IPF)の場合は、Oracle10g以降を使用してください。
注2) 使用するドライバのバージョンにより必要なライブラリパスが異なります。詳細はOracleのマニュアルを参照してください。
注3) ライブラリパスは上記表に記載している順序で設定してください。
注4) RHEL-AS4(IPF)/RHEL5(IPF)の場合は不要です。

◆設定方法

1) IJServerを使用する場合の設定方法

　IJServerでWebアプリケーション、またはEJBアプリケーションを運用する場合は、以下のように設定してください。
　Interstage管理コンソールを使用する場合の詳細については、Interstage管理コンソールのヘルプを参照してください。また、isj2eeadminコマンドを使用する場合の詳細は“リファレンスマニュアル（コマンド編）”の“isj2eeadmin”を参照してください。

設定項目	設定方法
パス	以下のいずれかにパスを設定してください。 J2EEプロパティのパス IJServer環境設定のパス 以下のいずれかを使用して設定してください。 Interstage管理コンソール [システム] > [環境設定] > [J2EEプロパティ] > [パス] [システム] > [ワークユニット] > [IJServer名] > [環境設定] > [パス] isj2eeadminコマンド J2EEシステム定義ファイル IJServer定義ファイル 設定方法の詳細はInterstage管理コンソールのヘルプまたは“リファレンスマニュアル(コマンド編)”を参照してください。
ライブラリパス	以下にライブラリパスを設定してください。 J2EEプロパティのライブラリパス IJServer環境設定のライブラリパス 以下のいずれかを使用して設定してください。 Interstage管理コンソール [システム] > [環境設定] > [J2EEプロパティ] > [ライブラリパス] [システム] > [ワークユニット] > [IJServer名] > [環境設定] > [ライブラリパス] isj2eeadminコマンド J2EEシステム定義ファイル IJServer定義ファイル 設定方法の詳細はInterstage管理コンソールのヘルプまたは“リファレンスマニュアル(コマンド編)”を参照してください。
クラスパス	以下にクラスパスを設定してください。 J2EEプロパティのクラスパス IJServer環境設定のクラスパス 以下のいずれかを使用して設定してください。 Interstage管理コンソール [システム] > [環境設定] > [J2EEプロパティ] > [クラスパス] [システム] > [ワークユニット] > [IJServer名] > [環境設定] > [クラスパス] isj2eeadminコマンド J2EEシステム定義ファイル IJServer定義ファイル 設定方法の詳細はInterstage管理コンソールのヘルプまたは“リファレンスマニュアル(コマンド編)”を参照してください。 クラスローダの分離をしないIJServerの場合、システム環境変数に設定しても有効となります。IJServerで使用するクラスパスの設定方法の詳細は“IJServerで使用するクラスの設定について”を参照してください。 Webアプリケーションのディレクトリ構成である“WEB-INF/lib”に、クラスパスに設定するJDBCドライバを格納しないでください。格納した場合、以下の機能が使用できない場合があります。 事前コネクト 異常時の再接続
ORACLE_HOME	以下に、ORACLE_HOMEを設定してください。 IJServer環境設定の環境変数 ORALE_HOME=/opt/oracle 以下のいずれかを使用して設定してください。 Interstage管理コンソール [システム] > [ワークユニット] > [IJServer名] > [環境設定] > [環境変数] isj2eeadminコマンド IJServer定義ファイル 設定方法の詳細はInterstage管理コンソールのヘルプまたは“リファレンスマニュアル(コマンド編)”を参照してください。

2) クライアント環境の場合の設定方法

　クライアント環境でJ2EEアプリケーションクライアントを動作させる場合は、環境変数に設定してください。以下に設定例を記載します。

【Windows(R)上の環境設定でシステム環境変数に設定する場合の例】

　[コントロールパネル]−[システム]−[詳細]の環境変数ボタンをクリックしてください。

　Windows(R) 2000の場合の説明です。使用するOSにより操作方法は異なります。

【コマンドでシステム環境変数に設定する場合の例】

　ORACLE_HOMEは、Oracleのインストールホーム・ディレクトリです。

set CLASSPATH=%CLASSPATH%;%ORACLE_HOME%\jdbc\lib\ojdbc14.jar
set CLASSPATH=%CLASSPATH%;%ORACLE_HOME%\jdbc\lib\nls_charset12.jar

　[Cシェルの場合]
setenv CLASSPATH ${CLASSPATH}:${ORACLE_HOME}/jdbc/lib/ojdbc14.jar
setenv CLASSPATH ${CLASSPATH}:${ORACLE_HOME}/jdbc/lib/nls_charset12.jar

■Interstageへのデータソース登録

　Interstage管理コンソールでデータソースを定義します。詳細は、Interstage管理コンソールのヘルプを参照してください。また、isj2eeadminコマンドを使用して変更することもできます。詳細は“リファレンスマニュアル（コマンド編）”の“isj2eeadmin”を参照してください。

　データソースを定義する際に、使用する機能によって以下からデータソースの種類を選択できます。

データソースの種類	用途
Interstageのコネクションプーリングを使用する	Interstageのコネクションプーリング機能を使用できるデータソースです。Oracle9i以降のJDBCドライバで使用できます。デフォルトで選択されます。
Oracleのコネクションプーリングを使用する	Oracleの暗黙的接続キャッシュを使用するデータソースです。Oracle10g以降のJDBCドライバのみで利用できます。以下の場合に選択してください。 Oracle Real Application Clusters(Oracle RAC)の高速接続フェイルオーバー機能を使用する場合 Statementキャッシュ機能を使用する場合 Oracleの接続キャッシュ・プロパティによるチューニングを行う場合
分散トランザクションを使用する	分散トランザクション(グローバルトランザクション)環境を使用する場合に選択してください。

　Interstage Application Server 8.0以前において定義可能であった「グローバルトランザクションを使用する」のチェックボックスは削除されました。グローバルトランザクションを使用する場合は、「データソースの種類」で「分散トランザクションを使用する」を選択してください。

■File System Service Providerを使用する場合の環境設定

　File System Service Providerを使用する場合には上記に加えて以下の設定が必要です。

• 環境変数の設定

  上記のJDBCドライバの設定に追加して以下の設定が必要です。File System Service Providerは、Interstageから提供され、以下のクラスパスに設定済みですので、IJServerの場合本作業は不要です。

  設定項目	Oracleのバージョン	JDK/JREのバージョン	設定値
  クラスパス	共通	共通	C:\Interstage\J2EE\lib\providerutil.jar C:\Interstage\J2EE\lib\fscontext.jar /opt/FJSVj2ee/lib/providerutil.jar /opt/FJSVj2ee/lib/fscontext.jar

  最新のjarファイルを使用したい場合は、Sun Microsystems社のホームページからFile System Service Providerをダウンロードして、環境変数クラスパスを設定してください。
  また、クライアント環境の場合は、Interstageから提供されているjar(上記の表)、または、ダウンロードしたjarのクラスパスを設定してください。
  　

• File System Service Providerへのデータソース登録

  File System Service Providerに、データソースを登録します。Interstage管理コンソールまたはisj2eeadminコマンドを使用して、Interstageにデータソースを登録する場合には、Interstageへのデータソース登録と同時に、File System Service Providerにデータソースを登録するように指定できます。
  この場合、本作業は必要ありません。詳細は、Interstage管理コンソールのヘルプ、または“リファレンスマニュアル（コマンド編）”の“isj2eeadmin”を参照してください。

  File System Service Providerにデータソースを登録する場合には、以下に格納されているサンプルソースを参考にしてデータソース登録アプリケーションを作成し、データソースを登録してください。
  データソース登録アプリケーションの詳細については、Oracleのマニュアルを参照してください。

  
  　C:\Interstage\J2EE\sample\datasource\FJDSJNDILOCAL.java

  File System Service Providerにデータソースを登録した場合、PROVIDER_URLで指定した場所に“.bindings”というファイルが、作成されます。