サーブレットエンジンモードでは，Webコンテナサーバ用のusrconf.propertiesやusrconf.cfgを編集し，cjwebsetupなどのコマンドを実行してシステムを構築しますが，J2EEサーバモードでは次の3種類のシステム構築方法があります。

• Smart Composer機能を使用して構築する
  Smart Composer機能で提供するファイルおよびコマンドを使用し，推奨構成でシステムを構築します。システム構築の概要については，「16.　システムの構築」を参照してください。システム構築の詳細については，マニュアル「Cosminexus　簡易構築・運用ガイド」を参照してください。
  
• 運用管理ポータルを使用して構築する
  運用管理ポータルに設定内容を入力し，任意の構成でシステムを構築します。システム構築の概要については，「16.　システムの構築」を参照してください。運用管理ポータルでのシステム構築方法については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。
  
• ファイル編集とコマンド実行によってシステムを構築する
  J2EEサーバ用のusrconf.propertiesやusrconf.cfgを編集し，cjsetupなどのコマンドを実行し，任意の構成でシステムを構築します。システム構築の概要については，「16.　システムの構築」を参照してください。また，ファイル編集とコマンド実行でのシステム構築方法については，マニュアル「Cosminexus　システム構築ガイド」を参照してください。
  

どの方法でシステムを構築するかは，どのようなシステムを構築してどのように運用するかによって決定します。システム構築方法の検討については，マニュアル「Cosminexus　システム設計ガイド」を参照してください。

サーブレットエンジンモードとJ2EEサーバモードでは，Webアプリケーションのデプロイおよび属性の設定方法が異なります。

(a)　Webアプリケーションのデプロイ

サーブレットエンジンモードとJ2EEサーバモードでは，Webアプリケーションのデプロイ方法が異なります。

• サーブレットエンジンモードの場合
  次のどちらかの方法で，WebアプリケーションをWebコンテナサーバにデプロイします。
  
  • WARファイルのコピー
  • ディレクトリのコピー
  また，WARファイル，またはディレクトリを削除することで，アンデプロイできます。
  
• J2EEサーバモードの場合
  WebアプリケーションをJ2EEサーバにデプロイするためには，Webアプリケーションをアーカイブ形式，または展開ディレクトリ形式のJ2EEアプリケーションにしてからデプロイします。
  
  • Webアプリケーションからアーカイブ形式のJ2EEアプリケーションを作成し，J2EEサーバにインポートおよびデプロイします。
  • Webアプリケーションから展開ディレクトリ形式のJ2EEアプリケーションを作成し，J2EEサーバにインポートおよびデプロイします。
  また，アーカイブ形式，または展開ディレクトリ形式のJ2EEアプリケーションをアンデプロイします。
  

サーブレットエンジンモードとJ2EEサーバモードのWebアプリケーションのデプロイおよびアンデプロイ方法の違いを次に示します。

サーブレットエンジンモードからJ2EEサーバモードへ移行する場合には，サーブレットエンジンモードでのWebアプリケーションのデプロイ方法と操作性が近い，展開ディレクトリ形式によるデプロイ方法をお勧めします。

アーカイブ形式，または展開ディレクトリ形式のJ2EEアプリケーションについては，「7.　J2EEアプリケーションの実行」を参照してください。

(b)　Webアプリケーションの属性の設定

サーブレットエンジンモードの場合は，アプリケーション開発時にWebアプリケーションのDD（web.xml）を直接編集するか，またはhitachi_web.propertiesのキーを設定して，Webアプリケーションの属性を設定します。なお，WebアプリケーションのDD（web.xml）とhitachi_web.propertiesは，WebアプリケーションのWEB-INFディレクトリ下に置きます。

J2EEサーバモードの場合は，これらに加えて，次の方法でもWebアプリケーションの属性を設定できます。

• システム構築時に，サーバ管理コマンドでJ2EEアプリケーションをJ2EEサーバにインポートし，属性ファイルを編集して属性を設定します。
• システム構築時に，Server Plug-inでJ2EEアプリケーションをJ2EEサーバにインポートし，属性を設定します。

サーバ管理コマンドまたはServer Plug-inでは，J2EEアプリケーションの実行時間の監視や同時実行スレッド数の制御など，J2EEサーバの拡張機能の設定ができます。J2EEサーバモードの場合は，システム構築時にサーバ管理コマンドまたはServer Plug-inで設定する方法をお勧めします。サーバ管理コマンドまたはServer Plug-inの操作方法，および設定内容については，マニュアル「Cosminexus　アプリケーション設定操作ガイド」を参照してください。

なお，hitachi_web.propertiesの設定内容は，サーブレットエンジンモードとJ2EEサーバモードで異なります。

• サーブレットエンジンモードとJ2EEサーバモードで同じ場合
  JSPファイルのコンパイル結果の保持（webserver.jsp.keepgenerated）とTLDファイルの妥当性チェック（webserver.xml.validate）は，hitachi_web.propertiesまたはusrconf.propertiesで設定します。
  
• サーブレットエンジンモードとJ2EEサーバモードで異なる場合
  サーブレットエンジンモードの場合，Webアプリケーションのリロードの設定は，hitachi_web.propertiesまたはusrconf.propertiesで設定します。
  J2EEサーバモードの場合，Webアプリケーションのリロードの設定は，usrconf.propertiesで設定します。J2EEサーバ用のhitachi_web.propertiesでは，Webアプリケーションのリロードの設定はできません。
  

サーブレットエンジンモードとJ2EEサーバモードでは，Webサーバの使用方法が異なります。

Webサーバと連携して使用する方法の場合，サーブレットエンジンモードからJ2EEサーバモードに移行するときは，設定内容には差異はありません。ただし，システムの構築方法によって設定方法が異なります。

• Smart Composer機能を使用してシステムを構築する場合，Smart Composer機能で提供するファイルでWebサーバの設定をします。
• 運用管理ポータルを使用してシステムを構築する場合，運用管理ポータル上でWebサーバの設定をします。また，論理Webサーバとして使用できるのは，Hitachi Web Serverです。
• ファイル編集とコマンド実行によってシステムを構築する場合，設定方法はサーブレットエンジンモードと同じです。設定の変更などは必要はありません。

簡易Webサーバを使用する方法の場合，J2EEサーバモードのインプロセスHTTPサーバに移行するときは，設定内容および設定方法が異なります。

• Smart Composer機能を使用してシステムを構築する場合，インプロセスHTTPサーバは使用できません。
• 運用管理ポータルを使用してシステムを構築する場合，運用管理ポータル上でインプロセスHTTPサーバの設定をします。
• ファイル編集とコマンド実行によってシステムを構築する場合，J2EEサーバ用のusrconf.propertiesにインプロセスHTTPサーバの設定をします。なお，簡易Webサーバを使用する方法でWebコンテナサーバ用のusrconf.propertiesのwebserver.connector.http.で始まるキーに設定していた内容は，インプロセスHTTPサーバではJ2EEサーバ用のusrconf.propertiesのwebserver.connector.inprocess_http.で始まるキーに設定します。

なお，インプロセスHTTPサーバでは，サーブレットエンジンモードの簡易Webサーバよりも機能が多く，同時実行スレッド数の制御などの機能も使用できます。インプロセスHTTPサーバについては，「4.3　インプロセスHTTPサーバによるリクエストの受け付け」を参照してください。

WebアプリケーションからJDBCを使用してデータベースに接続をする場合，サーブレットエンジンモードとJ2EEサーバモードではWebアプリケーションの実装方法および設定方法が異なります。

(a)　データベースとの接続に使用できるクラスとインタフェース

サーブレットエンジンモードのWebアプリケーションの場合，使用できるのはjava.sqlパッケージで定義されたクラス，インタフェースだけです。java.sql.DriverManagerクラスのgetConnectionメソッドを使ってデータベースコネクションを取得し，コネクションプール機能が使用できます。

J2EEサーバモードのWebアプリケーションの場合，java.sqlパッケージとjavax.sqlパッケージで定義されたクラス，インタフェースが使用できます。このうち，javax.sql.DataSourceクラスのgetConnectionメソッドを使ってデータベースコネクションを取得する方法をお勧めします。この場合，コネクションプール機能が使用でき，さらにローカルトランザクションやグローバルトランザクション配下でデータベースコネクションを使用できるようになります。

javax.sql.DataSourceクラスを使用してデータベースコネクションを取得する例を次に示します。

 
import javax.naming.InitialContext;
import javax.sql.DataSource;
import java.sql.Connection;
 
public void doPost(HttpServletRequest req, HttpServletResponse resp)
   throws ServletException, java.io.IOException {
 
・・・
  InitialContext ic = new InitialContext();              // JNDIの初期コンテキストの生成
  DataSource ds = (DataSource)ic.lookup(“java:comp/env/MyDB”);    // DataSourceをlookupにより取得
  Connection con = ds.getConnection();                   // DataSourceからコネクションを取得・・・
}
 

(b)　ルックアップの方法

J2EEサーバモードではjavax.sql.DataSourceクラスをJNDIのルックアップで取得します。ルックアップの実装および設定方法を次に示します。なお，ここでは，サーバ管理コマンドを使用した設定方法について説明します。

• ルックアップ名称の定義
  Webアプリケーションの開発時に，Webアプリケーションのlookupメソッドの引数に「java:comp/env/<<res-ref-name>タグ指定値>」と指定して実装します。
  
• リソースの参照の定義
  次のどちらかの方法でリソースの参照を定義します。
  
  • Webアプリケーションの開発時に定義します。WebアプリケーションのDD（web.xml）を編集し，<resource-ref>タグでリソースの参照を定義します。
  • システム構築時に定義します。サーバ管理コマンドでJ2EEアプリケーションをJ2EEサーバにインポートし，WebアプリケーションのWAR属性ファイルの<resource-ref>タグで，リソースの参照を定義します。
• DB Connectorへの関連づけ
  システム構築時に定義します。サーバ管理コマンドでJ2EEアプリケーションをJ2EEサーバにインポートし，WebアプリケーションのWAR属性ファイルの<resource-ref>タグ下の<linked-to>タグで，関連づけるDB Connectorの表示名を定義します。
  

なお，DB Connectorでは，ルックアップされるための設定は必要ありません。

(c)　コネクションプーリングの方法

J2EEサーバモードでは，WebアプリケーションはDB Connectorというリソースアダプタを経由してデータベースに接続します。DB Connectorは，Webアプリケーションに対してJDBCのインタフェースを提供します。また，DB Connectorを使用する場合，Webアプリケーションで開始したトランザクションの配下でデータベースに接続できます。

サーブレットエンジンモードで使用するjava.sql.DriverManagerでは，getConnectionメソッドの引数に与えるデータベースURLによって接続先データベースを指定しますが，J2EEサーバモードで使用するDB Connectorは，データベースとの接続方法やトランザクションの形態によって実装が分かれています。このため，用途に合わせてDB Connectorを選択し，接続先データベースやコネクションプーリングなどをDB Connectorのプロパティ（サーバ管理コマンドを使用する場合は，Connector属性ファイルに設定）に定義します。

サーブレットエンジンモードと同様にJ2EEサーバモードでもトランザクション管理なしでデータベースを使用する場合に，Cosminexus DABroker Libraryを使用するときは，次のDB Connectorを選択します。

• DBConnector_DABJ_CP.rar
  Cosminexus DABroker Library用のDB Connectorです。ローカルトランザクションを使用する場合，またはトランザクション管理なしで使用する場合（トランザクションのサポートレベルにLocalTransactionまたはNoTransactionを指定する場合）に選択します。Cosminexus DABroker LibraryのConnectionPoolDataSourceを使用してデータベースに接続します。接続可能なデータベースは，HiRDBとOracleです。
  

なお，DBConnector_DABJ_CP.rar以外のDB Connectorについては，「9.4.1　DB Connectorによる接続の概要」を参照してください。

サーブレットエンジンモードとJ2EEサーバモードでは，使用できるサーブレットフィルタ（built-inフィルタ）の種類と設定方法が異なります。

(a)　built-inフィルタの種類

サーブレットエンジンモードでは，HTTPレスポンス圧縮フィルタを使用できますが，J2EEサーバモードの場合は，これらに加えて，次のbuilt-inフィルタも使用できます。

• セッションフェイルオーバ用フィルタ
  セッションフェイルオーバ機能で使用するフィルタです。J2EEアプリケーションで実行中のセッション情報を管理します。
  

built-inフィルタについては，「4.11.1　Cosminexusが提供するサーブレットフィルタ（built-inフィルタ）」を参照してください。

(b)　built-inフィルタの設定

サーブレットエンジンモードの場合は，アプリケーション開発時にWebアプリケーションのDD（web.xml）を直接編集し，built-inフィルタをWebアプリケーションに組み込みます。J2EEサーバモードの場合は，これに加えて，次の方法でもbuilt-inフィルタをWebアプリケーションに組み込むことができます。

• システム構築時に，サーバ管理コマンドでJ2EEアプリケーションをJ2EEサーバにインポートし，属性ファイルを編集してフィルタを組み込みます。
• システム構築時に，Server Plug-inでJ2EEアプリケーションをJ2EEサーバにインポートし，属性を設定してフィルタを組み込みます。

J2EEサーバモードの場合は，システム構築時にサーバ管理コマンドまたはServer Plug-inで設定する方法をお勧めします。

サーブレットエンジンモードとJ2EEサーバモードでは，Webアプリケーションのリロード機能が異なります。サーブレットエンジンモードとJ2EEサーバモードでのリロード機能の違いを次に示します。

注※1

参照先のファイルが更新された場合，参照元のファイルは更新されません。

注※2

Smart Composer機能でシステムを構築する場合には，Smart Composer機能で提供するファイルにリロード機能の設定をします。運用管理ポータルでシステムを構築する場合には，運用管理ポータル上でリロード機能の設定をします。

リロード時のリクエストの処理や遅延実行など，このほかのWebアプリケーションのリロード機能には，違いはありません。

サーブレットエンジンモードのリロード機能については，「付録C.2　Webアプリケーションの更新検知とリロード」を参照してください。J2EEサーバモードのリロード機能については，「7.5　J2EEアプリケーションの更新検知とリロード」を参照してください。

サーブレットエンジンモードとJ2EEサーバモードのusrconf.propertiesで指定する，リロード機能のキーとそのデフォルト値の対応を次に示します。

注※1

hitachi_web.propertiesでもデフォルト値は同じです。ただし，webserver.context.check_intervalとwebserver.jsp.check_intervalは，hitachi_web.propertiesでは設定できません。

注※2

J2EEサーバモードのusrconf.propertiesには，対応するキーはありません。常にセッション情報が引き継がれます。JSPがリロード対象となっていて対象ファイルが更新された場合には，再コンパイルが実行されます。

サーブレットエンジンモードでの，Webアプリケーションの更新検知の有無（webserver.context.reloadable），およびJSPの再コンパイルの有無（webserver.jsp.recompilable）の組み合わせを次に示します。

J2EEサーバモードでの，J2EEアプリケーションの適用の有無と適用範囲（ejbserver.deploy.context.reload_scope），Webアプリケーションの更新検知インターバル（webserver.context.check_interval），およびJSPの更新検知インターバル（webserver.jsp.check_interval）の組み合わせを次に示します。

サーブレットエンジンモードでシステムを起動および停止する場合には，cjstartwebコマンド，cjstopwebコマンド，cprfstartコマンドなどを使用します。

J2EEサーバモードの場合には，システムの構築方法によって，システムの起動および停止方法が異なります。

• Smart Composer機能を使用して構築する場合
  cmx_start_target，cmx_stop_targetなどのSmart Composer機能で提供するコマンドを使用して，Webシステム（サービスユニット，J2EEアプリケーション，リソースアダプタ）を一括起動，一括停止します。
  
• 運用管理ポータルを使用して構築する場合
  運用管理ポータルの「論理サーバの起動／停止」と「論理サーバのアプリケーション管理」で，論理サーバ，J2EEアプリケーション，リソースアダプタを一括起動，一括停止します。
  
• ファイル編集とコマンド実行によってシステムを構築する場合
  cjstartsvコマンド，cjstopsvコマンドなどのコマンドを使用して，J2EEサーバなどの各サーバを一つずつ起動，停止します。サーバ管理コマンドを使用して，J2EEアプリケーション，リソースアダプタを起動，停止します。
  

  注意

  サーブレットエンジンモードとJ2EEサーバモードで，サーバ起動時の実行時保護機能のデフォルト値が異なるので注意してください。

  • サーブレットエンジンモードで，cjstartwebコマンドを使用してWebコンテナサーバを起動する場合，デフォルトでは実行時保護機能は無効（有効にする場合には-securityを指定）となっています。
  • J2EEサーバモードで，cjstartsvコマンドやcjstartrecoverコマンドを使用してJ2EEサーバを起動する場合，デフォルトでは実行時保護機能は有効（無効にする場合には-nosecurityを指定）となっています。

サーブレットエンジンモードとJ2EEサーバモードを比較する場合，J2EEサーバモードの方が，機能が多く，メモリやスレッド，ポートなどのリソースを多く消費します。このため，サーブレットエンジンモードからJ2EEサーバモードへ移行する場合には，注意してください。

各プロセスで使用するポートを次に示します。

• WebコンテナサーバとJ2EEサーバのポートの対応
  

  デフォルトのポート	説明	Webコンテナサーバプロセス	J2EEサーバプロセス※1
  80（TCP）	インプロセスHTTPサーバのhttpポート	−	○
  8080（TCP）	簡易Webサーバのhttpポート	○	−
  	管理用通信ポート	−	○
  8007（TCP）	Webサーバ（リダイレクタ）からのリクエスト受付ポート	○	○
  8005（TCP）	cjstopwebコマンドからのプロセス終了要求の受付ポート	○	−
  900（TCP）	ネーミングサービスのリクエスト受付ポート	−	○
  浮動（TCP）※2	EJBコンテナのリクエスト受付ポート	−	○
  浮動（TCP）※2	サーバ管理コマンドのCUIとの通信ポート。	−	○
  23152（TCP）	RMIレジストリのリクエスト受付ポート	−	○
  浮動（TCP）※2	運用監視エージェントの通信ポート	−	○※3

  （凡例）

  ○：使用する　−：使用しない

  注※1

  ここではJ2EEサーバプロセスのポートだけを説明しています。J2EEサーバモードの場合，CTMを使用する場合などで使用するポートが増えます。

  注※2

  デフォルトの設定です。固定に変更できます。

  注※3

  Management Serverと連携する場合だけ使用するポートです。

  
  　
  
• Hitachi Web Serverのポート
  

  デフォルトのポート	説明
  80（TCP）	Hitachi Web Serverのhttpポート
  443（TCP）	Hitachi Web Serverのhttpsポート

  　
  
• Management Serverのポート
  

  デフォルトのポート	説明
  28080（TCP）	Management Serverのhttpポート
  28005（TCP）	Management Serverの終了要求ポート（ホスト内通信に必要）
  28009（TCP）	Management Serverの内部通信ポート（ホスト内通信に必要）

  　
  
• 運用管理エージェントのポート
  

  デフォルトのポート	説明
  20295（TCP）	Management Serverとの通信に使用するポート