ここでは、動作環境のカスタマイズの方法と、何らかの理由により、J2EEアプリケーションが動作しなくなった場合に確認すべき内容について説明します。
ポイント
Interstage Application Serverのインストール後には、J2EEアプリケーションが登録されていない状態でデフォルトのIJServerが登録されます。デフォルトのIJServerは“IJServer”という名前で登録され、サンプルアプリケーションの動作環境としてだけではなく実際の運用にも利用できます。
すぐにJ2EEアプリケーションを実行させたい場合には、J2EEサンプルアプリケーションの登録を行うか、お手持ちのJ2EEアプリケーションを配備してください。
ここでは、以下について説明します。
Fujitsu XMLプロセッサを使用する場合の設定
コンテナがdeployment descriptorファイルか名前変換ファイルの解析処理にFujitsu XMLプロセッサを使用する場合、またはJ2EEアプリケーションでJAXP(Java API for XML Processing)を使用している場合において、Fujitsu XMLプロセッサを使用したい場合、以下を行ってください。
Fujitsu XMLプロセッサのインストール
Fujitsu XMLプロセッサは、以下のようにインストールが必要な場合があります。
Fujitsu XMLプロセッサはInterstage Application Serverのインストールではインストールされません。“インストールガイド”を参照して、インストールしてください。
カスタムインストールの場合、Fujitsu XMLプロセッサがインストールされていない場合があります。必要に応じて、“インストールガイド”を参照して、インストールしてください。
Fujitsu XMLプロセッサの設定
“2.3.5 XMLパーサの設定”を参照して、カスタマイズしてください。
以下の環境変数を、“isj2ee.jar”のパス設定よりも前になるように設定してください。
環境変数 | 設定値 |
|---|---|
CLASSPATH | %ProgramFiles%\Common Files\FujitsuXML\xmlpro.jar |
環境変数 | 設定値 |
|---|---|
CLASSPATH | /opt/FJSVxmlpc/lib/xmlpro.jar |
JDK1.4を使用する場合の設定
JDK1.4を使用する場合にはJavaアプリケーション実行時に、javaコマンドのパラメタとして以下の指定が必要です。
DOMインタフェースを使用する場合
-Djavax.xml.parsers.DocumentBuilderFactory=com.fujitsu.xml.tree.DocumentBuilderFactoryImpl
SAXインタフェースを使用する場合
-Djavax.xml.parsers.SAXParserFactory=com.fujitsu.xml.parser.SAXParserFactoryImpl
環境変数の設定
環境変数CLASSPATHに、次の値が設定されていない場合は設定してください。
C:\Interstage\J2EE\lib\isj2ee.jar
/opt/FJSVj2ee/lib/isj2ee.jar
Javaの環境設定
Javaのインストール
Interstageのサーバパッケージをインストールする場合
標準インストールでは、JDK5.0がインストールされます。
カスタムインストールでは、JDKまたはJREを選択してインストールしてください。
Javaの環境変数
Interstage上で、J2EEアプリケーションを動作させる場合は、Javaの環境設定を行う必要があります。環境変数PATHに、以下の値が設定されていない場合は設定してください。
JDK5.0系使用時:C:\Interstage\JDK5\jre\bin
JRE5.0系使用時:C:\Interstage\JRE5\bin
JDK1.4系使用時:C:\Interstage\JDK14\jre\bin
JRE1.4系使用時:C:\Interstage\JRE14\bin
JDK5.0系使用時:/opt/FJSVawjbk/jdk5/jre/bin
JRE5.0系使用時:/opt/FJSVawjbk/jre5/bin
JDK1.4系使用時:/opt/FJSVawjbk/jdk14/jre/bin
JRE1.4系使用時:/opt/FJSVawjbk/jre14/bin
注意
Javaの環境変数に関する注意事項
環境変数の“PATH”は、使用するシェルによっては“path”となる場合がありますので、環境に合わせて設定してください。
ディレクトリ中にバージョンが含まれている場合は適宜読み替えて設定してください。
Java VMのバージョンの違いによる非互換等の問題を防ぐため、開発/配備/運用で使用するJDK/JREのバージョンは一致させる事を推奨します。また、J2EEアプリケーションクライアント、Webアプリケーション、EJBアプリケーションが連携して動作する場合なども、おのおのが使用するJava VMのバージョンの違いによる非互換等の問題を防ぐため、使用するJDK/JREのバージョンを一致させることを推奨します。
IJServerを利用する場合の設定
プロパティ情報ファイル
IJServerを利用する場合は、アプリケーションの実行に必要なプロパティ情報を記述したファイルが必要になります。
プロパティ情報ファイル(orb.properties)は、Interstageインストール時に以下のディレクトリに複写されますが、SolarisまたはLinuxでカスタムインストールでJavaを後からインストールした場合または、Javaを追加インストールした場合は該当個所に複写が必要です。
(プロパティ情報ファイル:C:\Interstage\EJB\etc\orb.properties)
(JDKの場合)%{JAVA_HOME}%\jre\lib
(JREの場合)%{JAVA_HOME}%\lib
(プロパティ情報ファイル:/opt/FJSVejb/etc/orb.properties)
(JDKの場合)%{JAVA_HOME}%/jre/lib
(JREの場合)%{JAVA_HOME}%/lib
Java環境設定ファイル
IJServerを利用する場合はJava環境設定ファイルへの設定が必要です。
Interstageのインストール時にJavaの環境設定が設定されていない場合、または、SolarisまたはLinuxでカスタムインストールでJavaを後からインストールした場合または、Javaを追加インストールした場合は、Java環境設定ファイルにJavaを追加で設定してください。
Java環境設定ファイルは、以下のディレクトリに作成されます。
C:\Interstage\J2EE\etc\java_config.txt
/opt/FJSVj2ee/etc/java_config.txt
以下に、設定形式と設定する場合の注意事項について説明します。
以下の形式で設定してください。
使用するJavaのバージョン = Javaのインストールディレクトリ |
使用するJavaのバージョン
使用するJavaのバージョンは、以下のように記述してください。
JDK5.0を使用する場合・・・JDK50DIR
JRE5.0を使用する場合・・・JRE50DIR
JDK1.4を使用する場合・・・JDK14DIR
JRE1.4を使用する場合・・・JRE14DIR
Javaのインストールディレクトリ
Javaのインストールディレクトリは、絶対パス形式で設定してください。
例
C:\Interstage\jdk5にインストールしたJDK5.0を使用する場合の記述例
JDK50DIR = C:\Interstage\jdk5
/opt/FJSVawjbk/jdk5にインストールしたJDK5.0を使用する場合の記述例
JDK50DIR = /opt/FJSVawjbk/jdk5
注意
Java環境設定ファイルに関する注意事項
Java環境設定ファイル(java_config)には、コメント行を記述することはできません。先頭が#、!などの記号の場合は、不当な情報として扱います。
業務運用中に、Java環境設定ファイルの削除や内容の変更をしないでください。
Interstageのインストール時にJDKを選択した場合、Java環境としてJDKの中に含まれるJREを使用することはできません。この場合、「使用するJavaのバージョン」に“JDK50DIR”または“JDK14DIR”を指定し、Java環境としてJDKを使用するようにしてください。
Java環境設定ファイルに情報を設定する場合は、管理者権限で実施してください。
業務運用中に、Java環境設定ファイルの削除や内容の変更をしないでください。
Java環境設定ファイルの「使用するJavaのバージョン」にJRE50DIRまたは、JRE14DIRを指定した場合は、「Javaのインストールディレクトリ」に、JDK5.0または、JDK1.4配下のJREを設定しないでください。JRE5.0または、JRE1.4をインストールしたディレクトリを設定してください。
V7.0以降で作成したIJServerで、指定したJavaバージョンがJava環境設定ファイルに記述されていない場合は、起動エラーとなります。
V6.0で作成したIJServerで、指定したJavaバージョンがJava環境設定ファイルに記述されていない場合はJDK1.4もしくはJRE1.4で動作します。
EJBサービス運用コマンドを利用する場合の設定
EJBのJava環境設定ファイル
EJBサービス運用コマンドを利用する場合は、EJBのJava環境設定ファイルの設定が必要です。
以下のいずれかに該当している場合は、Java環境設定ファイルにJavaを追加で設定してください。
Interstageのインストール時にJavaの環境設定が設定されていない
SolarisまたはLinuxでカスタムインストールでJavaを後からインストールした
Javaを追加インストールした
Java環境設定ファイルは、以下のディレクトリに作成されます。
C:\Interstage\EJB\etc\java_config.txt
/opt/FJSVejb/etc/java_config.txt
以下に設定形式と設定する場合の注意事項について説明します。
以下の形式で設定してください。
使用するJavaのバージョン = Javaのインストールディレクトリ |
使用するJavaのバージョン
使用するJavaのバージョンは、以下のように記述してください。
JDK5.0を使用する場合・・・JDK50DIR
JRE5.0を使用する場合・・・JRE50DIR
JDK1.4を使用する場合・・・JDK14DIR
JRE1.4を使用する場合・・・JRE14DIR
Javaのインストールディレクトリ
Javaのインストールディレクトリは、絶対パス形式で設定してください。
例
C:\Interstage\jdk5にインストールしたJDK5.0を使用する場合の記述例
JDK50DIR = C:\Interstage\jdk5
/opt/FJSVawjbk/jdk5にインストールしたJDK5.0を使用する場合の記述例
JDK50DIR = /opt/FJSVawjbk/jdk5
注意
Java環境設定ファイルに関する注意事項
Java環境設定ファイル(java_config)には、コメント行を記述することはできません。先頭が#、!などの記号の場合は、不当な情報として扱います。
業務運用中に、Java環境設定ファイルの削除や内容の変更をしないでください。
Interstageのインストール時にJDKを選択した場合、Java環境としてJDKの中に含まれるJREを使用することはできません。この場合、「使用するJavaのバージョン」に“JDK50DIR”または“JDK14DIR”を指定し、Java環境としてJDKを使用するようにしてください。
Java環境設定ファイルに情報を設定する場合は、管理者権限で実施してください。
業務運用中に、Java環境設定ファイルの削除や内容の変更をしないでください。
Java環境設定ファイルの「使用するJavaのバージョン」にJRE50DIRまたは、JRE14DIRを指定した場合は、「Javaのインストールディレクトリ」に、JDK5.0または、JDK1.4配下のJREを設定しないでください。
JRE5.0または、JRE1.4をインストールしたディレクトリを設定してください。
