4 OC4Jランタイムの構成

この章では、OC4Jの起動時に設定できるランタイム・オプションおよびシステム・プロパティについて詳しく説明します。次の項目が含まれます。

JDKのバージョンの指定
起動時のOC4Jランタイム・オプションの設定
起動時のシステム・プロパティの設定
統合開発環境からのリモート・デバッグの有効化

JDKのバージョンの指定

OC4Jには、次のいずれかのJDKリリースが必要です。

Java Platform Standard Edition（Java SE）Development Kit（JDK）6
Java Platform 2 Standard Edition（J2SE）Development Kit（JDK）5.0（JDK1.5とも呼ばれる）
Java Platform 2 Standard Edition（J2SE）Development Kit（JDK）1.4

スタンドアロンOC4J構成に使用するJDKバージョンを指定する必要があります。各OC4JインスタンスにJDKバージョンを指定できます。Oracle Application Serverインストールでは、OC4JインスタンスにデフォルトでJDK 5.0が使用されます。

スタンドアロン構成でのJDKの指定

スタンドアロンOC4J構成では、JAVA_HOME環境変数にOC4Jで使用されるJDKの場所を設定します。使用されるJDKは、ホスト・マシンのPATH環境変数に追加する必要があります。

あるいは、OC4Jの起動時に使用するJDKを指定できます。次に例を示します。

C:\ORACLE_HOME\j2ee\home\C:\jdk\bin\java -jar oc4j.jar

管理構成でのJDKの指定

Oracle Application ServerのコンポーネントとしてインストールされたOPMN管理のOC4Jインスタンスは、デフォルトではJDKリリース5.0を使用します。EJB 3.0を使用するには、JDK 5.0またはJDK 6が必要です。OC4JにデプロイされるアプリケーションにJDK 6またはJDK 1.4.2のリリースが必要な場合は、別のバージョンに切り替える必要があります。

JDK 5.0からJDK 6またはJDK 1.4.2に切り替えるには、すべてのコンパイル済アプリケーション・ファイルをOC4Jインスタンスから削除する必要があります。

OC4Jインスタンスを停止します。
ORACLE_HOME/j2ee/instance/application-deploymentsディレクトリを削除します。

このディレクトリを削除すると、OC4JがJDK 6またはJDK 1.4.2で再起動される際に、アプリケーション・ファイルは再コンパイルされます。

opmn.xml構成ファイルを手動で編集して、各OC4Jインスタンスに使用するJDKを指定できます。JDKとともにインストールされた、JAVA_HOME環境変数に定義されているjavacコンパイラを使用する場合は、server.xmlファイルから<java-compiler>要素も削除し、OC4Jがデフォルト設定を再検出できるようにします。

id属性がjava-binである<data>要素にJavaシステム・プロパティを設定します。この<data>要素は、XML構造の<ias-component id="default_group">要素の<category id="start-parameters">サブ要素に囲まれています。次に例を示します。

<ias-component id="default_group">
  <process-type id="home" module-id="OC4J" status="enabled">
    <module-data>
      <category id="start-parameters">
        <data id="java-bin" value="c:/myhost/jdk/bin/java"/>
      </category>
      ...
    </module-data>
  </process-type>
</ias-component>

起動時のOC4Jランタイム・オプションの設定

OC4Jの起動時に、多くのOC4Jランタイム・オプションをOC4Jインスタンスに設定できますが、ほとんどは標準出力メッセージを管理するためのオプションです。これらのオプションの設定方法は、スタンドアロンOC4J構成と管理Oracle Application Server構成では異なります。

スタンドアロンOC4J構成でのランタイム・オプションの設定
管理OC4J構成でのランタイム・オプションの設定
OC4Jランタイム・オプションの概要

スタンドアロンOC4J構成でのランタイム・オプションの設定

OC4Jランタイム・オプションは、OC4Jの起動時にoc4j.jarコマンドラインで引数を渡して設定できます。oc4j.jarの構文は次のとおりです。

java [props] -jar oc4j.jar [args]

構文のoc4j.jarの後に、ランタイム・オプション（[args]）を指定します。次に例を示します。

java -jar oc4j.jar -userthreads

管理OC4J構成でのランタイム・オプションの設定

OC4JがOracle Application Serverのコンポーネントとしてインストールされる場合、OC4Jランタイム・オプションはopmn.xml構成ファイルに手動で追加する必要があります。オプションは、起動時に管理OC4Jインスタンスに渡されます。

id属性がoc4j-optionsである<data>要素にOC4Jランタイム・オプションを設定します。この<data>要素は、XML構造の<ias-component id="default_group">要素の<category id="start-parameters">サブ要素に囲まれています。次に例を示します。

<ias-component id="default_group">
  <process-type id="home" module-id="OC4J" status="enabled">
    <module-data>
      <category id="start-parameters">
        <data id="oc4j-options" value="-userthreads"/>
        ...
      </category>
      ...
    </module-data>
  </process-type>
</ias-component>

OC4Jランタイム・オプションの概要

表4-1に、OC4Jランタイム・オプションを示します。

表4-1 OC4J起動オプション

コマンドライン引数	説明
`-quiet`	コンソールへの標準出力を抑止します。
`-config` `path`	`server.xml`ディスクリプタ・ファイルへのパスを指定します。デフォルトの場所は、`ORACLE_HOME/j2ee/instance/config`ディレクトリです。
`-validateXML`	読取り時にXSDによって定義されたXML構成ファイルを検証します。 `orion-ejb-jar.xml`ファイルの`<entity-deployment>`または`<session-deployment>`要素に`tx-retry-wait`属性を追加した場合は、OC4J起動コマンドラインで`-validateXML`オプションを使用しないでください。
`-out [file]`	標準出力のルーティング先となるファイルを指定します。このファイルには、`System.out`に出力されるメッセージの他、サーブレット・ロギング・インタフェースを介して出力に送信されるメッセージが格納されます。指定しない場合は、すべての出力が標準出力に書き込まれます。 `stdout`ファイルを管理するために設定できるその他のシステム・プロパティは、「stdoutおよびstderrログ・ファイルの管理」を参照してください。 OPMN管理の構成では、このファイルは、指定されたパスの最後に追加されるinstance_default_group_1ディレクトリ内に生成されます。たとえば、`opmn.xml`に次の要素を指定したとします。 <data id="oc4j-options" value="...-out /mypath/mylog.log"/> `mylog.log`ファイルは、実際には次のファイルに生成されます。 /mypath/instance_default_group_1/mylog.log
`-err [file]`	標準エラー出力のルーティング先となるファイルを指定します。このファイルには、`System.err`に出力されるメッセージが格納されます。指定しない場合は、すべてのエラーが標準エラーに書き込まれます。 `stderr`ファイルを管理するために設定できるその他のシステム・プロパティは、「stdoutおよびstderrログ・ファイルの管理」を参照してください。 OPMN管理の構成では、このファイルは、指定されたパスの最後に追加されるinstance_default_group_1ディレクトリ内に生成されます。詳細は、`-out`の説明を参照してください。
`-verbosity` `int`	メッセージ出力の詳細レベルを設定する`1`～`10`の整数を定義します。値`10`は、最も詳細な出力を生成します。次に例を示します。 java -jar oc4j.jar -verbosity 10
`-monitorResourceThreads`	スレッド・リソースのバックアップ・デバッグを有効にします。コードの重要な部分でスレッドがスタックする問題が発生した場合にのみ、有効にします。
`-userThreads`	ユーザー作成のスレッドからのコンテキスト参照のサポートを有効にします。
`-http.sessionInvalidatingThreads`	HTTPセッションを無効化する最大スレッド数を指定します。デフォルト値は、`3`です。
`-listProperties`	OC4Jの起動時にJVMに設定できるすべてのOC4J固有のシステム・プロパティのリストを出力した後、終了します。次の例では、作業ディレクトリ内のテキスト・ファイルに出力をリダイレクトしています。 java -jar oc4j.jar -listProperties > props.txt
`-sequential`	Oracle Application Serverクラスタ内の各OC4Jインスタンスを順番に起動します。
`-version`	インストールされたOC4Jのバージョンを返した後、終了します。
`-? \|-help`	これらのオプションのヘルプ・テキストをコンソールに出力します。

起動時のシステム・プロパティの設定

次の各項で説明するように、OC4Jの起動時に、多くのOC4J固有のシステム・プロパティをJVMに設定できます。

スタンドアロンOC4J構成でのシステム・プロパティの設定
OPMN管理OC4J構成でのシステム・プロパティの設定
manifest.dependencies.warn.onlyを使用した共有ライブラリでの異なる依存性の許容
シンボリック・リンク使用の防止
stdoutおよびstderrログ・ファイルの管理
一般的なシステム・プロパティの概要
デバッグ・プロパティの概要

注意:

oc4j.jar -listPropertiesオプションを使用すると、OC4Jの起動時にJVMに設定できるすべてのOC4J固有のシステム・プロパティのリストを出力できます。次の例では、作業ディレクトリ内のテキスト・ファイルに出力をリダイレクトしています。

java -jar oc4j.jar -listProperties > props.txt

スタンドアロンOC4J構成でのシステム・プロパティの設定

システム・プロパティは、起動時にOC4Jコマンドラインを使用してJVMに設定できます。OC4Jが稼働中の場合は、新しいプロパティ設定を有効にするために、インスタンスを再起動する必要があります。

構文は次のとおりです。

java [props] -jar oc4j.jar [args]

構文のoc4j.jarの前に、すべてのシステム・プロパティ（props）を指定します。コマンドラインでは、各システム・プロパティを-Dで始める必要があります。次に例を示します。

java -Doc4j.formauth.redirect=true -jar oc4j.jar

OPMN管理OC4J構成でのシステム・プロパティの設定

OC4JがOracle Application Serverのコンポーネントとしてインストールされる場合、opmn.xml構成ファイルにOC4Jシステム・プロパティを手動で追加できます。オプションは、起動時に管理OC4Jインスタンスに渡されます。

id属性がjava-optionsである<data>要素にJavaシステム・プロパティを設定します。この<data>要素は、XML構造の<ias-component id="default_group">要素の<category id="start-parameters">サブ要素に囲まれています。すべてのシステム・プロパティは、-Dで始めます。次に例を示します。

<ias-component id="default_group">
  <process-type id="home" module-id="OC4J" status="enabled">
    <module-data>
      <category id="start-parameters">
        <data id="java-options" value="-Doc4j.formauth.redirect=true
         -Dhttp.session.debug=true"/>
      </category>
      ...
    </module-data>
  </process-type>
</ias-component>

manifest.dependencies.warn.onlyを使用した共有ライブラリでの異なる依存性の許容

OC4Jが初期化される際には、MANIFEST.MFファイルに指定されているバージョンを検証することで、コンテナ・レベル構成に定義されている共有ライブラリの依存性が検証されます。依存性チェック失敗のデフォルトの動作では、エラーが発行されて初期化プロセスが停止されます。同じ共有ライブラリの異なるバージョンを使用する場合は、起動時にmainifest.dependencies.warn.onlyプロパティをtrueに設定し、依存性チェックが失敗した際に、OC4Jが警告を発行し、初期化が続行されるようにできます。

このプロパティは、同じアプリケーション・ライブラリに対する依存性が異なるプロジェクト・リリースおよびビルドを同時に実行する場合に便利です。

mainifest.dependencies.warn.onlyがtrueに設定されていると、OC4Jにより、デフォルトで警告メッセージが発行されます。記録されたメッセージは、oracleログ出力のORACLE_HOMEj2ee/instance/config/j2ee-logging.xml構成ファイルに指定された場所に保存されます。このログ出力には、コンソールと、j2ee/instance/log/oc4j/log.xmlのOLD形式のXMLファイルという2つの出力場所があります。スタンドアロンOC4Jでは、instance名はhomeです。OPMN管理のOracle Application Server環境では、すべてのコンソール出力がORACLE_HOME/opmn/logs/instance_default_group_1ファイル（またはこの名前の変化形）にリダイレクトされます。

シンボリック・リンク使用の防止

デフォルトでは、OC4J10g（10.1.3.5.0）のhttp.file.allowAliasプロパティはfalseに設定されています。この設定により、シンボリック・リンクの使用が防止されています。場合によっては、JSPのソース・コードがエンドユーザーに表示される可能性があるため、この設定をtrueに変更しないことをお薦めします。

プロパティ設定を変更するかわりに、次のいずれかの回避策を使用できます。

OC4J軽量HTTPリスナーの使用を、Oracle HTTP Serverを介してOC4Jアプリケーションがフロントエンドとなる構成に一時的に切り替え、ブラウザがHTTPを介して直接ページにアクセスするのではなく、mod_oc4jおよびApache JServ Protocol（AJP）を介して間接的にアクセスできるようにします。

アプリケーション内のすべてのシンボリック・リンクを、それらが提供する実際のファイル名で置き換えます。

シェル・スクリプトを使用すると、シンボリック・リンクの置換えを自動化できます。次に例を示します。

#!/bin/ksh

PROGNAME="${0##*/}"
LN_EXTN="ln"

function displaySyntax
{
echo "${PROGNAME}! SYNTAX: ${PROGNAME} some_dir_path"
exit 1
}

if [[ $# < 0 ]]
then
displaySyntax
fi

DIR="$1"

if [[ ! -d ${DIR}
then
displaySyntax
fi

find ${DIR} -type l|while read filepath
do
echo "FIXING: ${filepath} (=> ${filepath}.${LN_EXTN})"
mv ${filepath} ${filepath}.${LN_EXTN}
cp -L ${filepath}.${LN_EXTN} ${filepath}
done

この例のKSHスクリプトは、UNIX環境では次のようにして起動します。

$ fixLinks web_module_root

このスクリプトにより、すべてのディレクトリが再帰的に調査され、追加の.ln拡張子が付くシンボリック・リンクである、検出されたすべてのファイル名が変更されます。その後、スクリプトにより、リンクが検出された元の場所にリンク・ターゲットのコピーが配置されます。

stdoutおよびstderrログ・ファイルの管理

次のプロパティは、stderrおよびstdout標準ログ・ファイルの管理に使用されます。oc4j.jarコマンドの-outおよび-errオプションを使用して、プロパティが属するログ・ファイルのタイプと場所を指定できます。

たとえば、次のコマンドは、ファイル・サイズが2.5MBに達したときにstdoutおよびstderrファイルを循環させることを指定しています。ログ・ファイルは、d:\logsディレクトリに出力されます。

java -Dstdstream.filesize=2.5 -jar oc4j.jar -out d:\logs\oc4j.out -err d:\logs\oc4j.err

次の例では、stdoutログ・ファイルを毎日午後2:30に循環させ、ログ・アーカイブを最大10ファイルに制限することを指定しています。

java -Dstdstream.rotatetime=14:30 -Dstdstream.filenumber=10 -jar oc4j.jar -out d:\logs\oc4j.out

表4-2 stdoutおよびstderrファイルのアーカイブ管理プロパティ

プロパティ	説明
stdstream.filesize=max_file_size	アーカイブ内のファイルの最大サイズ（MB単位）。この最大サイズに達するとファイルが循環します。
`stdstream.filenumber=max_files`	アーカイブとして保持される最大ファイル数。この制限を超えると、最も古いファイルが自動的に削除されます。
stdstream.rotatetime=HH:mm	ログ・ファイルが毎日循環する時刻。

一般的なシステム・プロパティの概要

表4-3に、OC4Jに対して設定できる一般的なシステム・プロパティを示します。

表4-3 OC4Jの一般的な-Dシステム・プロパティ

プロパティ	説明
`java.ext.dirs`	コンパイル時にクラスが検索される外部ディレクトリを設定します。
`java.io.tmpdir=new_tmpdir`	デプロイ・ウィザード用の一時ディレクトリを設定します。デフォルトは`/tmp/var`です。デプロイ・ウィザードは、デプロイ・プロセス時に情報を格納するために、一時ディレクトリのスワップ領域を20MB使用します。完了すると、デプロイ・ウィザードは一時ディレクトリをクリーンアップします。ただし、ウィザードが中断されると、一時ディレクトリをクリーンアップする時間またはタイミングが失われることがあります。その場合、ユーザー自身がこのディレクトリから追加デプロイメント・ファイルをクリーンアップする必要があります。クリーンアップしないと、このディレクトリが満杯になり、それ以降のデプロイが実行できなくなります。 `Out` `of` `Memory`エラーが出力された場合は、一時ディレクトリの使用可能領域を確認してください。
`java.awt.headless=true\|false`	`true`の場合は、環境でディスプレイ、キーボードおよびマウスがサポートされているかどうかが確認されます。`false`の場合、確認は行われません。デフォルトは`true`です。
`oracle.home`	OC4Jディストリビューションをインストールするルート・ディレクトリを設定します。 `oracle.home`システム・プロパティを使用するかわりに、`ORACLE_HOME`環境変数の値をルート・ディレクトリに設定できます。
`oracle.j2ee.home`	J2EEホーム・ディレクトリを、`oc4j.jar`および`admin.jar`ファイルのインストール・ディレクトリである`ORACLE_HOME/j2ee/instance`に設定します。`ORACLE_HOME`の値は、OC4Jディストリビューションをインストールするルート・ディレクトリです。このシステム・プロパティまたは`J2EE_HOME`環境変数をJ2EEホーム・ディレクトリに設定すると、`oc4j.jar`および`admin.jar`を任意のディレクトリから起動できるようになります。
`GenerateIIOP=true\|false`	IIOPスタブの生成を有効にします。デフォルトは`false`です。
`KeepIIOPCode=true\|false`	生成されたIIOPスタブ/タイ・コードを保持するかどうかを設定します。デフォルトは`false`です。
`oracle.arraylist.deepCopy=true\|false`	`true`の場合は、配列リストのクローニング中に、ディープ・コピーが実行されます。`false`の場合は、配列リストに対してシャロー・コピーが実行されます。デフォルトは`true`です。
`dedicated.rmicontext=true\|false`	非推奨の `dedicated.connection`プロパティはこのプロパティに置き換えられました。デフォルトは`false`です。同じプロセス内の2つ以上のクライアントが`InitialContext`を取得すると、OC4Jはキャッシュされているコンテキストを返します。したがって、各クライアントは、そのプロセスに割り当てられている同じ`InitialContext`を受け取ります。サーバー参照は、サーバーのロード・バランシングを招きますが、これはクライアントが独自の`InitialContext`を取得する場合にのみ発生します。 `dedicated.rmicontext=true`と設定すると、各クライアントは共有コンテキストではなく独自の`InitialContext`を受け取ります。各クライアントが独自の`InitialContext`を保持する場合、クライアントの負荷分散が可能です。このプロパティは、JNDIプロパティに設定することもできます。 OC4J 10g（10.1.3.5.0）で非推奨になった`dedicated.rmicontext`、`dedicated.connection`および`LoadBalanceOnLookup`プロパティは、`oracle.j2ee.rmi.loadBalance`プロパティに置き換えられました。
`manifest.dependencies.warn.only`	このプロパティを使用すると、システム・ライブラリのJAR依存性が一致していない場合に、OC4Jの初期化が停止されるデフォルトの動作を上書きできます。デフォルトのプロパティ値は`false`です。 OC4Jが初期化される際には、MANIFEST.MFファイルに指定されているバージョンを検証することで、コンテナ・レベル構成に定義されているライブラリの依存性が検証されます。このプロパティを`true`に設定すると、問題を説明した警告メッセージがシステムにより発行され、初期化は続行されます。このプロパティの使用方法の詳細は、「manifest.dependencies.warn.onlyを使用した共有ライブラリでの異なる依存性の許容」を参照してください。
`oracle.j2ee.rmi.loadBalance`	このプロパティは、次のいずれかの設定で、レプリケーション・ベースのロード・バランシングを構成します。 `client`: クライアントが通信全体の初期参照で最初に選択されたOC4Jプロセスと通信します。 `context`: 別のコンテキストが使用されると（非推奨の`dedicated.rmicontext`プロパティと同じように）、クライアントは新規サーバーに切り替えます。 `lookup`: クライアントは参照ごとにサーバーを切り替えます。デフォルト設定は`client`です。非推奨の`dedicated.rmicontext`、`dedicated.connection`および`LoadBalanceOnLookup`プロパティは、`oracle.j2ee.rmi.loadBalance`プロパティに置き換えられました。
`oracle.mdb.fastUndeploy=int`	OC4Jが基礎となるデータベースをポーリングして、MDBセッションが停止しているかどうかをチェックする間隔（秒単位）を設定します。このプロパティを使用すると、Windows環境でMDBを実行している場合またはWindows環境でバックエンド・データベースが稼働している場合に、OC4Jをクリーンに停止できます。通常、MDBを使用する場合、MDBは受信メッセージを待機する受信状態でブロックされます。しかし、Windows環境でMDBが待機状態のときにOC4Jを停止すると、MDBがブロックされているため、OC4Jインスタンスは停止されず、アプリケーションはアンデプロイされません。このプロパティを設定すると、MDBが受信メッセージを処理しておらず待機状態であるときに、OC4Jはデータベースをポーリングして、セッションが停止しているかどうかを確認できるようになります。このプロパティを設定せずに、[Ctrl]+[C]を使用してOC4Jを停止しようとすると、OC4Jプロセスは2.5時間以上ハングします。このポーリング・プロセスは、パフォーマンスに対して高価となる可能性があるため、頻繁に起動しすぎないように設定してください。
`oracle.dms.sensors=none\|normal\|heavy\|all`	Oracle組込みパフォーマンス・メトリックの値は、次のように設定できます。 `none`: メトリックを無効化 `normal`: 中程度のメトリック（デフォルト） `heavy`: 高いメトリック `all`: 可能なすべてのメトリックこのパラメータは、OC4Jサーバーで設定する必要があります。これらのパフォーマンス・メトリックを有効にするための以前の方法である`oracle.dms.gate=<true\|false>`は、`oracle.dms.sensors`変数で置き換えられています。ただし、`oracle.dms.gate`を引き続き使用する場合、この変数をfalseに設定すると、`oracle.dms.sensors=none`の設定と同じ意味になります。
`associateUsingThirdTable=true\|false`	エンティティBeanにおけるコンテナ管理の関係について、第3のデータベース表を使用して関係を管理するかどうかを指定できます。第3の関連表を必要としない場合は、`false`に設定します。デフォルトは`false`です。このプロパティは非推奨で、OrionCMPでのみ機能します。
`DefineColumnType=true\|false`	リリース9.2.0より前のOracle JDBCドライバを使用している場合は、`true`に設定します。これらのドライバの場合、この変数をtrueに設定すると、Oracle JDBCドライバに対してSelectを実行する場合のラウンドトリップを回避できます。このパラメータは、OC4Jサーバーで設定する必要があります。デフォルトは`false`です。このオプションの値を変更してOC4Jを再起動すると、この変更の後にデプロイされるアプリケーションに対してのみ有効になります。変更前にデプロイされたアプリケーションには影響はありません。 trueの場合、`DefineColumnType`拡張機能により、通常は表の記述に必要なデータベースへのラウンドトリップが節約されます。Oracle JDBCドライバが問合せを実行する場合、最初にデータベースへのラウンドトリップを使用して、結果セットの列に使用する必要がある型を判別します。次に、JDBCは問合せからデータを受け取ると、結果セットに移入する際に、データを必要に応じて変換します。 `DefineColumnType`拡張機能をtrueに設定して問合せの列の型を指定すると、Oracleデータベースへの最初のラウンドトリップが回避されます。そのように最適化されているサーバーは、必要な型変換を実行します。
`oc4j.formauth.redirect=true\|false`	このプロパティは、Webアプリケーションでフォームベース認証が使用される場合に適用できます。 `true`に設定した場合、リソースへのアクセス時にユーザーが有効な資格証明を入力すると、OC4JはリクエストURLへのクライアント・サイド・リダイレクトを実行します。ユーザーに有効な資格証明がない場合、Webブラウザは、Webアプリケーションに定義されたフォーム認証エラー・ページにリダイレクトされます。 `false`に設定した場合、ユーザーが有効な資格証明を入力すると、ブラウザには`/j-security-check`のURLが表示されます。デフォルトは`false`です。
`file.encoding=value`	このプロパティは、ファイル・エンコーディングのデフォルトのキャラクタ・セットを指定します。エンコーディングが指定されていない場合、OC4Jでは、デフォルトのキャラクタ・セットとしてISO-8859-1が使用されます。 Windows環境では、ファイル・エンコーディングのデフォルトのキャラクタ・セットは、ISO 8859-1キャラクタ・セットのスーパーセットであるWindows-1252であることが必要です。デフォルトとしてWindows-1252キャラクタ・セットを使用するには、`-Dfile.encoding=Cp1252`をOC4Jの起動プロパティとして指定します。これにより、PrintWriter出力でWindows-1252の文字が疑問符（?）に置き換えられなくなります。
`http.file.allowAlias`	このプロパティにより、シンボリック・リンクの使用が制御されます。デフォルト値は`false`で、シンボリック・リンクの使用を防止します。場合によっては、JSPのソース・コードがエンドユーザーに表示される可能性があるため、この設定を`true`に変更しないことをお薦めします。詳細は、「シンボリック・リンク使用の防止」を参照してください。
`http.maxFileInfoCacheEntries`	このプロパティにより、クライアントがパス情報を使用してアプリケーションにアクセスする際に、OC4Jが収集するファイル情報が格納されるキャッシュが制御されます。次のように設定すると、キャッシュを制御できます。 `http.maxFileInfoCacheEntries < 0`と設定すると、ファイル情報はキャッシュされません。 `http.maxFileInfoCacheEntries == 0`と設定すると、すべてのファイル情報が格納され、オブジェクトはキャッシュから解放されません。 `http.maxFileInfoCacheEntries > 0`と設定すると、キャッシュされるエントリの最大数を指定できます。デフォルト値は`2000`です。
`http.proxyHost=proxy_hosthttp.proxyPort=proxy_port`	HTTPトラフィックがプロキシWebサーバーを通過する場合、プロキシ・ホストと必要に応じてプロキシ・ポートをコマンドラインに指定します。proxy_portを省略した場合、デフォルトはポート80です。
`http.webdir.enable=true\|false`	このプロパティは、OC4Jインスタンス内のすべてのサーブレットについて、サーブレット・クラス名の起動を有効または無効にします。 `true`に設定した場合、OC4Jインスタンスで稼働しているサーブレットはデフォルトでクラス名により起動できます。`false`に設定した場合、サーブレットはクラス名により起動できません。デフォルトは`false`です。 Webアプリケーションごとにこの機能を無効にするには、このプロパティを`true`に設定して、サーブレット・クラス名の起動を許可しない各Webアプリケーションの`orion-web.xml`ディスクリプタに`<orion-web-app servlet-webdir="" ... />`と設定します。 `orion-web.xml`で`servlet-webdir`に設定された値は、`ORACLE_HOME/j2ee/instance/config/global-web-application`でこの属性に設定されたデフォルト値、すなわち`servlet-webdir="/servlet"`に優先します。
`HTTPClient.log.level`	このプロパティを使用すると、次のいずれかの`java.util.logging.Level`値に設定した場合に、Oracle `HTTPClient`パッケージを記録できます。 `CONFIG` `FINE` `FINER` `FINEST` `ALL` HTTPClientロギングを無効化するには、このプロパティを`OFF`に設定します。 HTTPClientログは、トレース・レベル（`CONFIG`以下）でのみメッセージ通知され、アプリケーション・ログ・レベル（`SEVERE`、`WARNING`および`INFO`）では使用されません。ログ・レベルの設定およびHTTPClientロギングの有効化の詳細は、『Oracle Containers for J2EE開発者ガイド』の第4章「ロギング実装のガイドライン」を参照してください。

デバッグ・プロパティの概要

注意:

この項に示すデバッグ・プロパティは非推奨です。

OC4Jに付属するコンポーネント・ログ出力の使用方法は、「OC4Jコンポーネント・ログ出力の使用方法と構成」を参照してください。

次のプロパティを使用して、OC4J内で稼働しているアプリケーションをデバッグできます。デバッグ・メッセージはコンソールに出力されます。すべてのプロパティがブール値をとります。

すべてのプロパティは、-Dで始めます。

表4-4 OC4Jのデバッグ・プロパティ

デバッグ・プロパティ	説明
http.session.debug=true\|false	HTTPセッションのイベントに関する情報をコンソールに示します。
http.request.debug=true\|false	各HTTPリクエストに関する情報をコンソールに示します。
http.cluster.debug=true\|false	HTTPクラスタリングのイベントに関する情報をコンソールに示します。
http.error.debug=true\|false	すべてのHTTPエラーをコンソールに出力します。
http.method.trace.allow=true\|false	`trace` HTTPメソッドを有効にします。
datasource.verbose=true\|false	データソースの作成、データソースを使用する接続およびプールに解放された接続に関する詳細情報を示します。
jdbc.debug=true\|false	JDBCコールが行われるときに詳細情報を示します。
ejb.cluster.debug=true\|false	EJBクラスタリングのデバッグ・メッセージを有効にします。
rmi.debug=true\|false	RMIデバッグ情報をコンソールに出力します。
rmi.verbose=true\|false	RMIコールに関する詳細情報を示します。
`jca.connection.debug=true\|false`	J2CA接続に関するその他の診断情報を示します。
ws.debug=true\|false	Webサービスのデバッグを有効にします。

統合開発環境からのリモート・デバッグの有効化

開始パラメータとして指定されているJVMデバッグ・コマンドを使用してOC4Jインスタンスを起動すると、リモート・デバッガの接続が可能になるため、OC4Jのアプリケーションを統合開発環境（IDE）からリモートでデバッグできます。次の各項では、これらのパラメータの指定方法について説明します。

Application Server Controlを使用したOC4Jインスタンスのリモート・デバッグの有効化
opmn.xmlファイルへのデバッグ開始パラメータの指定
起動コマンドラインへのデバッグ開始パラメータの指定

Application Server Controlを使用したOC4Jインスタンスのリモート・デバッグの有効化

Application Server Controlを使用して単一のOC4Jインスタンスのリモート・デバッグを有効化するには、次のようにします。

OC4Jホームページに移動します。
「管理」をクリックして、OC4Jの「管理」ページを表示します。
管理タスクの表の「プロパティ」の下で、「サーバー・プロパティ」行のタスク・アイコンをクリックします。

「サーバー・プロパティ」ページが表示されます。
「コマンドライン・オプション」の下の「開始パラメータ: Javaオプション」セクションで「行の追加」をクリックして、次に示す各デバッグ開始パラメータを追加します。
- -Xdebug
- -Xnoagent
- -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=4000
「適用」をクリックして、変更をOC4J構成に適用します。

サーバー・プロパティで変更を行ったら、変更内容を反映する前にOC4Jインスタンスを再起動する必要があります。

opmn.xmlファイルへのデバッグ開始パラメータの指定

OPMN管理のOC4Jインスタンスでは、id属性がstart-parametersの<category>要素内の<data>サブ要素（id属性はjava-options）の値として、opmn.xmlファイルにデバッグ・パラメータを配置し、インスタンスを再起動できます。opmn.xmlのエントリは、次のようになります。

<module-data>
  <category id="start-parameters">
     <data id="java-options" value="-server -Xdebug -Xnoagent
      -Djava.compiler=NONE
      -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=4000
      -Djava.security.policy=$ORACLE_HOME/j2ee/home/config/java2.policy
      -Djava.awt.headless=true"/>

デバッガが追加されるまでOC4Jが起動されなくなるため、suspend=yは使用しないでください。このデバッガ・パラメータを使用すると、OPMNは問合せpingからレスポンスを取得できなくなるため、OPMNによるOC4Jインスタンスの再起動が継続的に試行されます。

ポート4000などのaddressを設定するポートをサーバーに追加します。

注意:

4000というポート値は任意の値です。ユーザーの接続に適した値を設定する必要があります。指定されたポートは、サーバーに接続するためにリモートのデバッグ・クライアントに設定する必要のあるポートです。

起動コマンドラインへのデバッグ開始パラメータの指定

スタンドアロンOC4Jインスタンスでは、次のように、起動コマンドラインにデバッグ開始パラメータを指定できます。

java -Xdebug -Xnoagent -Djava.compiler=NONE
-Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=4000 -jar oc4j.jar

リモートからのWebアプリケーションのデバッグ

IDEからWebアプリケーションをデバッグするには、次に示す項で説明するように、サーブレットおよびJSPデバッグ用の設定を行う必要があります。

サーブレットのリモート・デバッグ用の設定
JSPのリモート・デバッグ用の設定

サーブレットのリモート・デバッグ用の設定

サーブレットのリモート・デバッグを設定するには、次のようにします。

プロジェクトの実行、またはリモート・デバッグを行うためのデバッグ構成をマークします。
リモート・デバッグ固有のランタイム構成ノードのJPDAへの追加を設定します。
「起動コマンドラインへのデバッグ開始パラメータの指定」の例で示されているように、デバッグ・パラメータを使用してOC4Jインスタンスを起動します。
サーブレットにブレークポイントを設定します。
リモート・デバッガを実行します。

Webブラウザからサーブレットを起動すると、サーブレットがブレークポイントに到達します。

JSPのリモート・デバッグ用の設定

JSPの場合は、前項「サーブレットのリモート・デバッグ用の設定」に説明されているように設定できますが、手順がもう1つ必要です。デフォルトでORACLE_HOME/j2ee/instance/configにインストールされているglobal-web-application.xmlファイルを編集し、JSP部分に少なくとも次に示すパラメータを設定する必要があります。

<init-param>
   <param-name>debug</param-name>
   <param-value>true</param-value>
</init-param>
<init-param>
   <param-name>developer_mode</param-name>
   <param-value>true</param-value>
</init-param>
<init-param>
   <param-name>encode_to_java</param-name>
   <param-value>true</param-value>
</init-param>
<init-param>
   <param-name>reduce_tag_code</param-name>
   <param-value>false</param-value>
</init-param>
<init-param>
   <param-name>extra_imports</param-name>
   <param-value></param-value>
</init-param>
<init-param>
   <param-name>main_mode</param-name>
   <param-value>recompile</param-value>
</init-param>
<init-param>
   <param-name>debug_mode</param-name>
   <param-value>true</param-value>
</init-param>