9.3 appclient

名前

appclient －アプリケーションクライアントコンテナの起動

形式

appclient [-client appjar] [-name display-name] [-xml xml] [app-args]

機能説明

アプリケーションクライアントコンテナを起動します。JVMオプションの指定を必要とする場合、環境変数VMARGSにオプションを指定します。詳細は5.5.1 Java EEアプリケーションクライアントの環境設定を参照してください。

オプション

オプション名	説明
-client	クライアントスタブJARファイルのパスを指定します。クライアントスタブJARファイルは、クライアントJARファイルを含むモジュールを配備する際に、asadminコマンドのdeployサブコマンドに--retrieveオプションを指定してダウンロードするか、配備後asadminコマンドのget-client-stubsサブコマンドでダウンロードします。
-name	ディスプレイ名を指定します。実行するクライアントJARファイルのapplication-client.xmlファイルのdisplay-nameタグに指定した名前を指定します。 EARファイルに複数のクライアントJARファイルを含めて配備して取得したクライアントスタブJARファイルを使用する場合には、-nameオプションを指定する必要があります。
-xml	Interstage ACC deployment descriptor(sun-acc.xml)を指定します。指定しなかった場合には以下のファイルが使用されます。 [Java EE 6共通ディレクトリ]\domains\domain1\config\sun-acc.xml [Java EE 6共通ディレクトリ]/domains/domain1/config/sun-acc.xml

オペランド

オペランド名	省略	説明
app-args	可	メインクラスのmainメソッドを呼び出す場合の引数を指定します。

戻り値

0: 正常終了
1: 異常終了

注意事項

一般ユーザで実行する場合の環境構築について

デフォルト設定では、appclientコマンドに一般ユーザへの参照権限が付与されていません。
一般ユーザでappclientコマンドを使用する場合、コマンドの使用者をシステム管理者から一般ユーザへ変更するための環境構築を行う必要があります。以下の手順で環境構築を行ってください。
- 手順
  環境構築を行う前にappclientコマンドが利用中でないことを確認してください。
  また、操作はすべてシステム管理者で行ってください。
  1. Interstage Java EE 6 DASサービスを停止します。
    注) すでにInterstage Java EE 6 DASサービスが停止している場合、本操作は不要です。
    コマンドの詳細については、「9.1.6.3 stop-domainサブコマンド」コマンドを参照してください。
```
/opt/FJSVisje6/glassfish/bin/asadmin stop-domain domain1
Waiting for the domain to stop ...
Command stop-domain executed successfully
```
  2. appclientコマンドのアクセス権限を変更します。
    システム管理者と同じアクセス権限をグループ、ユーザにも設定します。
    OSコマンドの詳細については、OSのマニュアルを参照してください。
    appclient
    変更前の権限:500を変更後の権限:555に変更します。
    sun-acc.xml
    変更前の権限:644を変更後の権限:666に変更します。
```
chmod 555 /opt/FJSVisje6/glassfish/bin/appclient
chmod 666 /opt/FJSVisje6/var/domains/domain1/config/sun-acc.xml
```
  3. appclientコマンド、およびデフォルトのsun-acc.xmlの所有者を一般ユーザに変更します。
    OSコマンドの詳細については、OSのマニュアルを参照してください。
    例) 変更前の所有者:(ユーザ:root、グループ:sys)を変更後の所有者:(ユーザ:apsuser、グループ:apsgroup)に変更する場合
```
chown apsuser:apsgroup /opt/FJSVisje6/glassfish/bin/appclient
chown apsuser:apsgroup /opt/FJSVisje6/var/domains/domain1/config/sun-acc.xml
```
appclientコマンドの使用者を一般ユーザからシステム管理者へ変更する場合
- 手順
  環境構築を行う前にappclientコマンドが利用中でないことを確認してください。
  また、操作はすべてシステム管理者で行ってください。
  1. Interstage Java EE 6 DASサービスを停止します。
    注) すでにInterstage Java EE 6 DASサービスが停止している場合、本操作は不要です。
    コマンドの詳細については、「9.1.6.3 stop-domainサブコマンド」コマンドを参照してください。
```
/opt/FJSVisje6/glassfish/bin/asadmin stop-domain domain1
Waiting for the domain to stop ...
Command stop-domain executed successfully
```
  2. appclientコマンドのアクセス権限を変更します。
    OSコマンドの詳細については、OSのマニュアルを参照してください。
    appclient
    変更前の権限:555を変更後の権限:500に変更します。
    sun-acc.xml
    変更前の権限:666を変更後の権限:644に変更します。
```
chmod 500 /opt/FJSVisje6/glassfish/bin/appclient
chmod 644 /opt/FJSVisje6/var/domains/domain1/config/sun-acc.xml
```
  3. appclientコマンド、およびデフォルトのsun-acc.xmlの所有者をシステム管理者に変更します。
    OSコマンドの詳細については、OSのマニュアルを参照してください。
    例) 変更前の所有者:(ユーザ: apsuser、グループ: apsgroup)を変更後の所有者:(ユーザ: root、グループ: sys)に変更する場合
```
chown root:sys /opt/FJSVisje6/glassfish/bin/appclient
chown root:sys /opt/FJSVisje6/var/domains/domain1/config/sun-acc.xml
```

使用例

以下のように実行します。

C:\Interstage\F3FMisje6\glassfish\bin\appclient -client MyApplicationClient.jar -xml sun-acc.xml test

/opt/FJSVisje6/glassfish/bin/appclient -client MyApplicationClient.jar -xml sun-acc.xml test