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

2.2.3 IJServerのファイル構成

　Interstage管理コンソールで作成したIJServerや配備したアプリケーションは以下の構成で管理されています。

J2EE共通ディレクトリ\ijserver\

　　　　(J2EE共通ディレクトリのデフォルトは、C:\Interstage\J2EE\var\deployment です。)

/opt/FJSVj2ee/var/deployment/ijserver/

上位ディレクトリ←　→下位ディレクトリ
IJServer名	apps　(※1)	モジュール名
	current　(※2)	IJServer名	PID
	distribute　(※3)	モジュール名
	log　(※4)	プロセス通番
	Shared　(※5)	classes
		lib
	work　(※6)
	ext　(※7)

　※1)配備されたアプリケーションのファイルがモジュール名のディレクトリに展開されます。EARファイルを配備した場合は、その中のWAR/ejb-jar/RARファイルも展開されます。また、配備するEARファイルにSharedディレクトリが存在した場合、そのディレクトリ内のjarファイル、およびクラスファイルは、EAR内のアプリケーションで共通に使用するファイルとなります。jarファイルはShared/libディレクトリ、クラスファイルはShared/classesディレクトリに格納してください。なお、配備後にSharedディレクトリを作成してもロード対象となります。
　※2)Java VMプロセスのカレントディレクトリです。最新はIJServer名のディレクトリで、ワークユニットの起動時にIJServer名.old1、IJServer名.old2、・・・、IJServer名.old5のように5世代までバックアップを残します。IJServer名配下のPIDディレクトリはPID単位でディレクトリが構成されており、PIDに対応するJava VMプロセスのコンテナのカレントディレクトリです。なお、カレントディレクトリの場所はInterstage管理コンソールの[ワークユニット] > “ワークユニット名” > [環境設定]タブ > [詳細設定] > [ワークユニット設定] > [カレントディレクトリ]で変更することが可能です。
　※3)モジュール名のディレクトリが作成され、そのディレクトリにEJBのクライアント配布物、およびCORBA/SOAPサーバゲートウェイファイルを格納します。EARファイルを配備した場合は、モジュール名のディレクトリにejb-jarファイル名のディレクトリが作成され、そのディレクトリに格納します。
　※4)Java VMプロセスのログディレクトリです。IJServerのプロセス多重度分のプロセス通番ディレクトリがあり、このディレクトリにログファイルが出力されます。なお、ログディレクトリの場所はInterstage管理コンソールの[ワークユニット] > “ワークユニット名” > [環境設定]タブ > [詳細設定] > [ワークユニット設定] > [ログ出力ディレクトリ]で変更することが可能です。また、[ワークユニット] > “ワークユニット名” > [ログ参照]タブから参照できます。
　※5)IJServer内のアプリケーションで共通に使用するjarファイル、およびクラスファイルを格納します。jarファイルはShared/libディレクトリ、クラスファイルはShared/classesディレクトリに格納してください。
　　Sharedディレクトリ配下に保管したクラスファイルまたはjarファイルはHotDeployおよびクラスのオートリロードの対象外です。Sharedディレクトリ配下のクラスファイルまたはjarファイルを上書きおよび削除した場合、それらクラスファイルまたはjarファイルはIJServerを再起動するまで有効となりません。

　　Shared/lib配下のjarファイルはIJServerが起動している場合は上書きおよび削除することはできません。
　※6)コンテナのテンポラリファイル(JSPのコンパイル結果など)が入ります。
　※7)JDBCドライバは、extディレクトリではなくSharedのlibに格納してください。

■IJServerのカレントディレクトリ

　デフォルトでは、IJServerのカレントディレクトリは以下のディレクトリです。

J2EE共通ディレクトリ\ijserver\[IJServer名]\current\[IJServer名 *]\[プロセスID]
(J2EE共通ディレクトリのデフォルトは、C:\Interstage\J2EE\var\deploymentです。)

/opt/FJSVj2ee/var/deployment/ijserver/[IJServer名]/current/[IJServer名 *]/[プロセスID]

※[IJServer名 *]のディレクトリ名部分は、ワークユニットの起動時にIJServer名.old1、IJServer名.old2、・・・、IJServer名.old5のようにバックアップを残し、最新のディレクトリ名はIJServer名になります。

　上記の下線部分は、Interstage管理コンソールの[ワークユニット] > “ワークユニット名” > [環境設定]タブ > [詳細設定] > [ワークユニット設定] > [カレントディレクトリ]で指定可能です。
　また、指定の際に、“IJServerで一意のカレントディレクトリとする”をチェックすると、指定ディレクトリそのものがカレントディレクトリとなり、実際のカレントディレクトリをIJServerとして一意にすることができます。

　以下に、Interstage管理コンソールの[ワークユニット] > “ワークユニット名” > [環境設定]タブ > [詳細設定] > [ワークユニット設定] > [カレントディレクトリ]での設定値とカレントディレクトリの関係をまとめます。

“カレントディレクトリ”の選択肢	ディレクトリ名	“IJServerで一意のカレントディレクトリとする”	カレントディレクトリ
デフォルトのディレクトリ構成	(指定不可) C:\Interstage\J2EE\var\deployment\ijserver (J2EE共通ディレクトリがデフォルトの場合) /opt/FJSVj2ee/var/deployment/ijserver	− (無効)	C:\Interstage\J2EE\var\deployment\ijserver\[IJServer名]\current\[IJServer名 *]\[プロセスID] /opt/FJSVj2ee/var/deployment/ijserver/[IJServer名]/current/[IJServer名 *]/[プロセスID]
ユーザ指定	指定例: C:\tmp\current /tmp/current	チェック時	C:\tmp\current /tmp/current
		非チェック時	C:\tmp\current\[IJServer名]\current\[IJServer名 *]\[プロセスID] /tmp/current/[IJServer名]/current/[IJServer名 *]/[プロセスID]

　“IJServerで一意のカレントディレクトリとする”をチェックした場合は、以下の点に注意してください。

• カレントディレクトリは世代管理されません。
• 指定ディレクトリが存在しない場合、新規作成されます。
• IJServerの削除時やカレントディレクトリの変更時にも、指定ディレクトリは削除されません。

• 以下の場合にcoreファイルが上書きされてしまう可能性があり、トラブル発生時に調査情報が入手できません。そのため、“IJServerで一意のカレントディレクトリとする”をチェックしないことを推奨します。
  • ワークユニット設定のプロセス多重度に2以上を指定している場合
  • ワークユニットを再起動した場合

■IJServerで使用するクラス

　IJServerは、“IJServerで使用するクラス一覧”で記述されたクラスを自動的にロードします。クラスがロードされる優先順位はクラスの設定場所、クラスローダの分離、およびクラスローダの検索順番の設定で変わってきます。詳細は、“クラスローダ”を参照してください。

　コンテナが動作するために必要なクラスパスより優先して使用したいクラスがある場合には、extディレクトリにjarファイルをコピーしてください。extディレクトリにjarファイルをコピーする場合は、以下の点に注意してください。

• extディレクトリに複数のjarファイルが存在した場合、任意の順番でクラスパスに設定されます。
• extディレクトリのjarファイルをロードするには、IJServerを再起動してください。
• extディレクトリのjarファイルにコンテナが使用するクラスと同名のクラスが存在する場合、コンテナもそのクラスを使用して動作します。したがってコンテナが誤動作する可能性があるため、十分に動作検証を実施した上でこの機能を使用してください。

　また、J2EEアプリケーション内にクラスを含めることによりIJServerのクラスより優先して使用することができます。この場合は同名のクラスが存在してもIJServerはJ2EEアプリケーション内のクラスを使用することはありませんので、J2EEアプリケーション内にクラスを含めることをお勧めします。詳細は“IJServerで使用するクラスの設定について”を参照してください。

　IJServerを起動すると起動時のクラスパスの情報が以下の起動情報(info.log)およびコンテナログ(container.log)に出力されます。起動情報およびコンテナログを参照することでクラスパスの設定を確認することができます。起動情報およびコンテナログは、Interstage管理コンソールの[ワークユニット] > “ワークユニット名” > [ログ参照]タブから参照できます。

　起動情報　　 : IJServer名\log\[プロセス通番]\info.log
　コンテナログ : IJServer名\log\[プロセス通番]\container.log

　起動情報　　 : IJServer名/log/[プロセス通番]/info.log
　コンテナログ : IJServer名/log/[プロセス通番]/container.log

◆IJServerで使用するクラス一覧

No	クラスファイル		クラスローダ
1	コンテナが動作するために必要なクラスパス (“C:\Interstage”にInterstageをインストールした場合のクラスパスを記載しています。)	C:\Interstage\J2EE\lib\ijserverboot.jar C:\Interstage\J2EE\lib\jsse.jar C:\Interstage\J2EE\lib\jcert.jar C:\Interstage\J2EE\lib\jnet.jar C:\Interstage\J2EE\lib\isj2ee7.jar C:\Interstage\odwin\etc\class\ODjava2.jar(注1)(注8) C:\Interstage\odwin\etc\class\ODjava4.jar(注2)(注8) C:\Interstage\ots\lib\fjtscorba13.jar(注1) C:\Interstage\ots\lib\fjtscorba14.jar(注2)	システムクラスローダ
2	ワークユニット設定の使用するXMLパーサの種別で指定されたXMLパーサ	C:\Interstage\J2EE\lib\crimson.jar(注3) C:\Interstage\J2EE\lib\jaxp.jar(注3) システムドライブ:\Program Files\Common Files\FujitsuXML\xmlpro.jar(注4) その他ディレクトリで指定されたディレクトリ内のjarファイル(注5)	システムクラスローダ
3	コンテナが動作するために必要なクラスパス (“C:\Interstage”にInterstageをインストールした場合のクラスパスを記載しています。)	C:\Interstage\J2EE\lib\isj2eert.jar C:\Interstage\J2EE\lib\isjaxp.jar C:\Interstage\lib\isadmin_scs.jar C:\Interstage\jms\lib\fjmsprovider.jar C:\Interstage\eswin\lib\esnotifyjava2.jar(注1) C:\Interstage\eswin\lib\esnotifyjava4.jar(注2) C:\Interstage\ots\lib\fjtsserverimpl13.jar(注1) C:\Interstage\ots\lib\fjtsserverimpl14.jar(注2) C:\Interstage\ejbcl\lib\fjcontainer72.jar(注1)(注6) C:\Interstage\ejb\lib\fjcontainer72.jar(注1)(注7) C:\Interstage\ejbcl\lib\fjcontainer74.jar(注2)(注6) C:\Interstage\ejb\lib\fjcontainer74.jar(注2)(注7) C:\Interstage\F3FMsoap\lib\issoap.jar(注1) C:\Interstage\F3FMsoap\lib\issoap4.jar(注2) %JAVA_HOME%\lib\fmoni.jar(注9) %JAVA_HOME%\jre\lib\fmoni.jar(注9) C:\Interstage\F3FMsoap\lib\issoapsec.jar C:\Interstage\F3FMuddic\lib\fjuddi4.jar C:\Interstage\F3FMuddic\lib\isplugin.jar C:\Interstage\J2EE\lib\fjjca1_0.jar C:\Interstage\J2EE\lib\providerutil.jar C:\Interstage\J2EE\lib\fscontext.jar %JAVA_HOME%\lib\tools.jar(注9) C:\Interstage\J2EE\lib\ijserverw.jar C:\Interstage\ejb\lib\fjcdomdef2.jar C:\Interstage\lib\isjmxserver.jar	Interstageクラスローダ

注1)

JDK1.3/JRE1.3系使用時に設定されます。

注2)

JDK1.4/JRE1.4系使用時に設定されます。

注3)

ワークユニットの環境設定で使用するXMLパーサの種別をCrimsonに指定した場合に設定されます。

注4)

ワークユニットの環境設定で使用するXMLパーサの種別をFujitsu XML Processorに指定した場合に設定されます。

注5)

ワークユニットの環境設定で使用するXMLパーサの種別をその他に指定した場合に設定されます。

注6)

Web-J Editionの場合です。

注7)

Web-J Edition以外の場合です。

注8)

CORBAサービスのプレインストール型Javaライブラリが自動設定されるため、ワークユニット設定のクラスパスなどにPortable-ORB用のライブラリを設定してもロードされません。CORBAサービスの環境定義を変更する場合にはプレインストール型の設定を変更してください。

注9)

%Java_HOME%はC:\Interstage\J2EE\etc\java_config.txtファイルに定義されたJRE/JDKのインストールディレクトリです。

No	クラスファイル		クラスローダ
1	コンテナが動作するために必要なクラスパス	/opt/FJSVj2ee/lib/ijserverboot.jar /opt/FJSVj2ee/lib/jsse.jar /opt/FJSVj2ee/lib/jcert.jar /opt/FJSVj2ee/lib/jnet.jar /opt/FJSVj2ee/lib/isj2ee7.jar /opt/FSUNod/etc/class/ODjava2.jar(注1)(注8) /opt/FSUNod/etc/class/ODjava4.jar(注2)(注8) /opt/FSUNots/lib/fjtscorba13.jar(注1) /opt/FSUNots/lib/fjtscorba14.jar(注2)	システムクラスローダ
2	ワークユニット設定の使用するXMLパーサの種別で指定されたXMLパーサ	/opt/FJSVj2ee/lib/crimson.jar(注3) /opt/FJSVj2ee/lib/jaxp.jar(注3) /opt/FJSVxmlpc/lib/xmlpro.jar(注4) その他ディレクトリで指定されたディレクトリ内のjarファイル(注5)	システムクラスローダ
3	コンテナが動作するために必要なクラスパス	/opt/FJSVj2ee/lib/isj2eert.jar /opt/FJSVj2ee/lib/isjaxp.jar /opt/FJSVisscs/lib/isadmin_scs.jar /opt/FJSVjms/lib/fjmsprovider.jar /opt/FJSVes/lib/esnotifyjava2.jar(注1) /opt/FJSVes/lib/esnotifyjava4.jar(注2) /opt/FSUNots/lib/fjtsserverimpl13.jar(注1) /opt/FSUNots/lib/fjtsserverimpl14.jar(注2) /opt/FJSVejbcl/lib/fjcontainer72.jar(注1)(注6) /opt/FJSVejbcl/lib/fjcontainer74.jar(注2)(注6) /opt/FJSVejb/lib/fjcontainer72.jar(注1)(注7) /opt/FJSVejb/lib/fjcontainer74.jar(注2)(注7) /opt/FJSVsoap/lib/issoap.jar(注1) /opt/FJSVsoap/lib/issoap4.jar(注2) $JAVA_HOME/lib/fmoni.jar(注9) $JAVA_HOME/jre/lib/fmoni.jar(注9) /opt/FJSVsoap/lib/issoapsec.jar /opt/FJSVuddic/libfjuddi4.jar /opt/FJSVuddic/lib/isplugin.jar /opt/FJSVj2ee/lib/fjjca1_0.jar /opt/FJSVj2ee/lib/providerutil.jar /opt/FJSVj2ee/lib/fscontext.jar $JAVA_HOME/lib/tools.jar(注9) /opt/FJSVj2ee/lib/ijserverw.jar /opt/FJSVejb/lib/fjcdomdef2.jar /opt/FJSVisjmx/lib/isjmxserver.jar	Interstageクラスローダ

注1)

JDK1.3/JRE1.3系使用時に設定されます。

注2)

JDK1.4/JRE1.4系使用時に設定されます。

注3)

ワークユニットの環境設定で使用するXMLパーサの種別をCrimsonに指定した場合に設定されます。

注4)

ワークユニットの環境設定で使用するXMLパーサの種別をFujitsu XML Processorに指定した場合に設定されます。

注5)

ワークユニットの環境設定で使用するXMLパーサの種別をその他に指定した場合に設定されます。

注6)

Web-J Editionの場合です。

注7)

Web-J Edition以外の場合です。

注8)

CORBAサービスのプレインストール型Javaライブラリが自動設定されるため、ワークユニット設定のクラスパスなどにPortable-ORB用のライブラリを設定してもロードされません。CORBAサービスの環境定義を変更する場合にはプレインストール型の設定を変更してください。

注9)

%Java_HOME%は/opt/FJSVj2ee/etc/java_config.txtファイルに定義されたJRE/JDKのインストールディレクトリです。

No	クラスファイル		クラスローダ
1	コンテナが動作するために必要なクラスパス	/opt/FJSVj2ee/lib/ijserverboot.jar /opt/FJSVj2ee/lib/jsse.jar /opt/FJSVj2ee/lib/jcert.jar /opt/FJSVj2ee/lib/jnet.jar /opt/FJSVj2ee/lib/isj2ee7.jar /opt/FJSVod/etc/class/ODjava2.jar(注1)(注8) /opt/FJSVod/etc/class/ODjava4.jar(注2)(注8) /opt/FJSVots/lib/fjtscorba13.jar(注1) /opt/FJSVots/lib/fjtscorba14.jar(注2)	システムクラスローダ
2	ワークユニット設定の使用するXMLパーサの種別で指定されたXMLパーサ	/opt/FJSVj2ee/lib/crimson.jar(注3) /opt/FJSVj2ee/lib/jaxp.jar(注3) /opt/FJSVxmlpc/lib/xmlpro.jar(注4) その他ディレクトリで指定されたディレクトリ内のjarファイル(注5)	システムクラスローダ
3	コンテナが動作するために必要なクラスパス	/opt/FJSVj2ee/lib/isj2eert.jar /opt/FJSVj2ee/lib/isjaxp.jar /opt/FJSVisscs/lib/isadmin_scs.jar /opt/FJSVjms/lib/fjmsprovider.jar /opt/FJSVes/lib/esnotifyjava2.jar(注1) /opt/FJSVes/lib/esnotifyjava4.jar(注2) /opt/FJSVots/lib/fjtsserverimpl13.jar(注1) /opt/FJSVots/lib/fjtsserverimpl14.jar(注2) /opt/FJSVejbcl/lib/fjcontainer72.jar(注6)(注1) /opt/FJSVejbcl/lib/fjcontainer74.jar(注6)(注2) /opt/FJSVejb/lib/fjcontainer72.jar(注7)(注1) /opt/FJSVejb/lib/fjcontainer74.jar(注7)(注2) /opt/FJSVsoap/lib/issoap.jar(注1) /opt/FJSVsoap/lib/issoap4.jar(注2) $JAVA_HOME/lib/fmoni.jar(注9) $JAVA_HOME/jre/lib/fmoni.jar(注9) /opt/FJSVsoap/lib/issoapsec.jar /opt/FJSVuddic/libfjuddi4.jar /opt/FJSVuddic/lib/isplugin.jar /opt/FJSVj2ee/lib/fjjca1_0.jar /opt/FJSVj2ee/lib/providerutil.jar /opt/FJSVj2ee/lib/fscontext.jar $JAVA_HOME/lib/tools.jar(注9) /opt/FJSVj2ee/lib/ijserverw.jar /opt/FJSVejb/lib/fjcdomdef2.jar /opt/FJSVisjmx/lib/isjmxserver.jar	Interstageクラスローダ

注1)

JDK1.3/JRE1.3系使用時に設定されます。

注2)

JDK1.4/JRE1.4系使用時に設定されます。

注3)

ワークユニットの環境設定で使用するXMLパーサの種別をCrimsonに指定した場合に設定されます。

注4)

ワークユニットの環境設定で使用するXMLパーサの種別をFujitsu XML Processorに指定した場合に設定されます。

注5)

ワークユニットの環境設定で使用するXMLパーサの種別をその他に指定した場合に設定されます。

注6)

Web-J Editionの場合です。

注7)

Web-J Edition以外の場合です。

注8)

CORBAサービスのプレインストール型Javaライブラリが自動設定されるため、ワークユニット設定のクラスパスなどにPortable-ORB用のライブラリを設定してもロードされません。CORBAサービスの環境定義を変更する場合にはプレインストール型の設定を変更してください。

注9)

$Java_HOMEは/opt/FJSVj2ee/etc/java_config.txtファイルに定義されたJRE/JDKのインストールディレクトリです。