OTXJSP.warの作成
WebAP JSPが提供するWARファイル作成ツールを使用してWARファイル(OTXJSP.war)を作成します。
OTXJSP.warの配備
作成したOTXJSP.warファイルを運用管理コンソール（Web Applicationの管理）より配備してください。
このとき、Context Root は /OTXJSP としてください。
セキュリティの設定
WebOTX Webコンテナは、デフォルト状態ではセキュリティ機能が有効になっています。この状態で、WebAP JSP Developer を利用して開発したアプリケーション（以下、Webアプリケーション）を動作させるには、セキュリティポリシーの設定が必要です。
| a.1 WebAP JSPに必要な権限 |
WebAP JSPは、ファイル転送、設定ファイルの参照・更新、ログ出力等のため、ソケットやファイルI/Oに関する権限を必要とします。
WebAP JSPが提供する「環境設定ツール」は、これらのセキュリティポリシーを自動設定します。
環境設定ツールを使用しないでセキュリティポリシーを設定する場合は、次に示す「環境設定ツールによるセキュリティ設定値」を追加してください。
※事前にserver.policyのバックアップをお勧めします。
| 環境設定ツールによるセキュリティ設定値 |
環境設定ツールは、Webコンテナを使用する場合、server.policyに対して以下のような設定を行います。
注）WebAP JSPルートディレクトリが「C:\ProgramFiles\NEC\WebOTX\JSP\Runtime」、 ドメインディレクトリが「C:\Program Files\NEC\WebOTX\domains\domain1」の場合の例です
|
grant codeBase "file:${com.nec.webotx.instanceRoot}/applications/j2ee-modules/OTXJSP/-" { permission java.security.AllPermission; }; grant codeBase "file:C:/Program Files/NEC/WebOTX/JSP/Runtime/run/-" { permission java.lang.RuntimePermission "charsetProvider"; permission java.io.FilePermission "C:/Program Files/NEC/WebOTX/JSP/Runtime/${/}logs${/}*", "read,write"; permission java.io.FilePermission "C:/Program Files/NEC/WebOTX/JSP/Runtime/${/}conf${/}env${/}*", "read,write"; permission java.io.FilePermission "C:/Program Files/NEC/WebOTX/JSP/Runtime/${/}conf${/}MFDL${/}*", "read"; permission java.io.FilePermission "C:/Program Files/NEC/WebOTX/JSP/Runtime/${/}conf${/}MFDL${/}", "read"; permission java.io.FilePermission "C:/Program Files/NEC/WebOTX/JSP/Runtime/${/}conf${/}data${/}*", "read"; }; |
WebAP JSPは、図のとおり「① WebAP JSP本体（OTXJSP.WARアーカイブ）」と「② Webアプリケーション」の２つの構成からなります。セキュリティ設定は、下記表のとおり各ディレクトリ配下に対する設定をそれぞれ行っており、各ディレクトリ間には親子関係が無いためWebAP JSP本体に付与したAllPermission権限が、Webアプリケーションに派生することはありません。
| 名称 | ① WebAP JSP本体（OTXJSP.WARアーカイブ） |
| ディレクトリ | ${com.nec.webotx.instanceRoot}/applications/j2ee-modules/OTXJSP/- |
| 権限 | AllPermission |
| 名称 | ② Webアプリケーション |
| ディレクトリ | C:/Program Files/NEC/WebOTX/JSP/Runtime/run/- |
| 権限 | WebAP JSPインストールディレクトリのログディレクトリおよびコンフィグディレクトリ に対しFilePermissionを持つ |
| a.2. Webアプリケーションに必要な権限 |
WebAP JSPが自動生成したままの状態で配備を行ったWebアプリケーションでは、環境設定ツール(a.1)と同等のセキュリティ設定を行うことで、動作に必要な最低限の設定が行われます。ただし、Webアプリケーション中に、任意の場所に存在するファイルのI/O(ログの出力等)を行っている場合やソケット通信処理など、セキュリティに関わるコード(*1)を追加している場合は権限の設定が必要となります。
(例） Webアプリケーション中で、WebAP JSPインストールディレクトリが
「C:/Program Files/NEC/WebOTX/JSP/Runtime」で、C:\test 配下のファイルを読み書きしたい場合には、以下の手順でセキュリティポリシーを追加してください。
- ドメインディレクトリ\config\server.policyをテキストエディタで開きます。
- grant codeBase "file:C:/Program Files/NEC/WebOTX/JSP/Runtime/run/-" の{ }内に以下の記述を追加します。
permission java.io.FilePermission "C:${/}test${/}*", "read,write"; - ドメインを再起動します。
| a.3. 互換性 |
V5.3以前のWebAP JSPから移行される場合の注意事項
WebAP JSPV6.2以降では、V5.3以前のWebAP JSPで自動生成したWebアプリケーションも動作できるようになっています。ただし、V6.2からセキュリティ設定の強化を行ったため、既存のアプリケーションが次の条件のいずれかに該当する場合は、セキュリティ違反となり動作しない場合があります。
| 該当する条件 |
|
上記の条件のいずれかに該当する場合は、(a.2)の例を参考に必要なセキュリティ設定を行ってください。また、本番環境に適用する前に、事前に評価環境でWebアプリケーションを問題なく実行できることを確認してください。
※セキュリティについての詳細は、デザインガイド(WebAP JSPアプリケーション)を参照してください。
Webコンテナ起動用ファイル中のクラスパスの設定
WebOTXのWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合は、WOTXBS90.jarへのパスを以下の手順で追加してください。
- シングルプロセスモードの場合
- 以下のディレクトリ配下にコピーして下さい。
- otxadminコマンドのsetコマンドを利用して追加して下さい。
- マルチプロセスモードの場合
- 統合運用管理ツールを起動します。
- 左側のツリーから、 [<ドメイン名>] - [TPシステム] - [アプリケーショングループ] - [<アプリケーショングループ名>] - [プロセスグループ] から、 当該のWebコンテナが属するプロセスグループを選択します。
- 右上側のパネルから環境変数タブを選択し、行の追加ボタンを押下します。
- 1列目にCLASSPATH、2列目にWOTXBS90.jarのパスを入力して、OKボタンを押下します。
- 設定情報を更新し、ドメインを再起動します。
以下のどちらかの方法を利用して下さい。
| <WebOTXインストールディレクトリ>\domains\<ドメインディレクトリ>\lib\ |
otxadminコマンドについては、[WebOTX Applicaton Server 共通リファレンス] - [運用管理コマンドリファレンスマニュアル] - [運用管理(otxadmin)コマンドリファレンス] を参照して下さい。
統合運用管理ツールをを用いて以下の手順で行います。