付録A.1 バージョンアップインストール
SOAPアプリケーション開発支援機能/SOAP通信基盤,JAX-WS機能,およびJAX-RS機能は,Application Serverのインストール時に同時にインストールされます。
ここでは,旧バージョンがインストールされているマシンに対して,バージョンアップインストールする場合の手順および注意事項について説明します。
(1) J2EEサーバの移行
Application Serverをバージョンアップインストールする場合,マニュアル「アプリケーションサーバ 機能解説 保守/移行編」の「10.2.2 更新インストールの場合」に記載されている移行手順に従ってインストールしてください。
バージョンアップインストールすると,SOAPアプリケーション開発支援機能およびSOAP通信基盤を利用するように設定されます。
(2) Webサービスのアンデプロイ
Webサービス(またはSOAPアプリケーション)を移行する場合,あらかじめJ2EEサーバにデプロイされているWebサービス(またはSOAPアプリケーション)をアンデプロイしてください。
(3) 動作環境の切り替え
SOAPアプリケーション開発支援機能/SOAP通信基盤,JAX-WSエンジン,およびJAX-RSエンジンの切り替えは,J2EEサーバ用オプション定義ファイルで定義します。ここでは,J2EEサーバ用オプション定義ファイルの指定内容,および指定方法について説明します。
J2EEサーバ用オプション定義ファイルについては,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「2.2.2 usrconf.cfg(J2EEサーバ用オプション定義ファイル)」を参照してください。
-
JAX-WSエンジンおよびJAX-RSエンジンを利用する場合
JAX-WSエンジンおよびJAX-RSエンジンを利用する場合,J2EEサーバ用オプション定義ファイルのadd.class.pathの「cjjaxws.jar」と「cjjaxrs.jar」の行を有効にし,「hitsaaj.jar」の行を無効にします。次の例に従って定義してください。
... #add.class.path=<cosminexus.home>\c4web\lib\hitsaaj.jar add.class.path=<cosminexus.home>\jaxws\lib\cjjaxws.jar add.class.path=<cosminexus.home>\jaxrs\lib\cjjaxrs.jar ...
-
SOAPアプリケーション開発支援機能/SOAP通信基盤を利用する場合
SOAPアプリケーション開発支援機能/SOAP通信基盤を利用する場合,J2EEサーバ用オプション定義ファイルのadd.class.pathの「hitsaaj.jar」の行を有効にし,「cjjaxws.jar」の行を無効にします。次の例に従って定義してください。
... add.class.path=<cosminexus.home>\c4web\lib\hitsaaj.jar #add.class.path=<cosminexus.home>\jaxws\lib\cjjaxws.jar ...
- 注意事項
-
有効,無効にする行に矛盾がないように設定してください。例えば,「hitsaaj.jar」,「cjjaxws.jar」,および「cjjaxrs.jar」すべての行を無効にした場合,またはすべての行を有効にした場合の動作は保証されません。
J2EEサーバ用オプション定義ファイルの編集方法を説明します。
ここで説明するどの方法でも,J2EEサーバ用オプション定義ファイルを編集(保存)したあとに,J2EEサーバを再起動してください。J2EEサーバを再起動しない場合は,編集内容が反映されません。
(a) 直接編集する場合
直接編集する場合,次の場所に格納されたJ2EEサーバ用オプション定義ファイルをテキストエディタで開き,内容を変更します。
<Application Serverのインストールディレクトリ>/CC/server/usrconf/ejb/<J2EEサーバ名>/usrconf.cfg
(b) Management Serverの運用管理ポータルを利用する場合
Management Serverの運用管理ポータルを利用する場合,[J2EEコンテナの設定]画面の「拡張パラメタ」で設定します。
JAX-WSエンジンおよびJAX-RSエンジンを利用する場合の設定例を次に示します。
SOAPアプリケーション開発支援機能およびSOAP通信基盤を利用する場合の設定例を次に示します。
運用管理ポータルの[J2EEコンテナの設定]画面については,マニュアル「アプリケーションサーバ 運用管理ポータル操作ガイド」の「10.8.2 J2EEコンテナの設定」を参照してください。
(c) Smart Composer機能を利用する場合
Smart Composer機能を利用する場合は,簡易構築定義ファイルに,J2EEの拡張パラメタとして追加します。Smart Composer機能については,マニュアル「アプリケーションサーバ システム構築・運用ガイド」を参照してください。簡易構築定義ファイルについては,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4. Smart Composer機能で使用するファイル」を参照してください。
JAX-WSエンジンおよびJAX-RSエンジンを利用する場合の設定例を次に示します。
<param> <param-name>add.class.path</param-name> <param-value><cosminexus.home>\jaxws\lib\cjjaxws.jar</param-value> </param> <param> <param-name>add.class.path</param-name> <param-value><cosminexus.home>\jaxrs\lib\cjjaxrs.jar</param-value> </param>
SOAPアプリケーション開発支援機能およびSOAP通信基盤を利用する場合の設定例を次に示します。
<param> <param-name>add.class.path</param-name> <param-value><cosminexus.home>\c4web\lib\hitsaaj.jar</param-value> </param>