4.9.1 Java EEアプリケーションクライアントの環境設定

クラスパスの設定

Java EEアプリケーションクライアントが動作するためにクラスパスを追加する必要がある場合には、環境変数APPCPATHに追加するクラスパスを指定してください。複数設定する場合には、環境変数CLASSPATHと同様にWindowsの場合には「;」区切りで設定し、Solaris/Linuxの場合には「:」区切りで設定してください。

例

set APPCPATH=C:\util\MyUtil.jar;C:\test\TestTool.jar

APPCPATH=/util/MyUtil.jar:/test/TestTool.jar
export APPCPATH

Javaアプリケーションの起動コマンドのオプション設定

アプリケーションクライアントコンテナを起動する場合、通常のJavaアプリケーションと同様に内部的にJavaアプリケーションの起動コマンド(javaコマンド)を使用します。
このJavaアプリケーションの起動コマンドで指定可能なオプション(-Xmxオプションなど)を指定する場合には、環境変数VMARGSを指定してください。

例

set VMARGS=-Xmx512m

VMARGS=-Xmx512m
export VMARGS

複数のオプションを設定する場合、以下のように指定してください。

例

set VMARGS=-Xmx512m -Xms128m

VMARGS="-Xmx512m -Xms128m"
export VMARGS

注意

-classpathオプションは指定しないでください。クラスパスを設定する場合には、環境変数APPCPATHに指定してください。
空白を含むシステムプロパティは設定できません。

以下のように不当な値を指定した場合、javaコマンドのエラーが発生します。オプションの指定方法はjavaコマンドの説明を参照してください。

無効なオプションを指定した場合

set VMARGS=-option
C:\Interstage\F3FMisje7\glassfish\bin\appclient -client TestApplicationClient.jar -xml glassfish-acc.xml
Unrecognized option: -option
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

VMARGS=-option
export VMARGS
/opt/FJSVisje7/glassfish/bin/appclient -client TestApplicationClient.jar -xml glassfish-acc.xml
Unrecognized option: -option
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

定義設定

アプリケーションクライアントコンテナの環境設定を行う場合、Interstage ACC deployment descriptor(glassfish-acc.xml)ファイルに必要な設定を行います。以下にInterstage ACC deployment descriptor(glassfish-acc.xml)ファイルに接続するサーバの情報を定義した場合の例を記載します。詳細は、「3.2.1 Interstage deployment descriptor」を参照してください。

  <?xml version="1.0" encoding="UTF-8"?>
  
  <client-container>
    <target-server name="server1" address="localhost" port="25700"/>
  </client-container>

作成したInterstage ACC deployment descriptor(glassfish-acc.xml)は、appclientコマンド実行時に-xmlオプションで指定してください。-xmlオプションを指定しなかった場合には、以下のファイルを参照します。

[Java EE 7共通ディレクトリ]\domains\domain1\config\glassfish-acc.xml

[Java EE 7共通ディレクトリ]/domains/domain1/config/glassfish-acc.xml

注意

-xmlオプションを指定しなかった場合に参照するInterstage ACC deployment descriptor(glassfish-acc.xml)は編集しないでください。編集した場合、本製品の再インストールが必要となる可能性があります。

クライアントパッケージの場合

appclientコマンド実行時に必ず-xmlオプションでInterstage ACC deployment descriptor(glassfish-acc.xml)を指定してください。
必要に応じて、以下に格納されているテンプレートを参考にしてInterstage ACC deployment descriptor(glassfish-acc.xml)を作成してください。

[Java EE 7インストールディレクトリ]\glassfish\config\glassfish-acc.xml

[Java EE 7インストールディレクトリ]/glassfish/config/glassfish-acc.xml