Cosminexus V9 アプリケーションサーバ 機能解説 互換編
3.7.7 Webアプリケーションの設定
Webアプリケーションのデプロイ方法は,次の2種類あります。
- WARファイルのコピーによるデプロイ
- ディレクトリのコピーによるデプロイ
それぞれのデプロイ方法について説明します。また,ルートコンテキストを使用し,ドメイン名を指定してWebアプリケーションのトップページを表示させる方法についても説明します。
(a) WARファイルのコピーによるデプロイ
WARファイルのコピーによるデプロイの手順を次に示します。
- WARファイルを次に示す場所にコピーします。
- Windowsの場合
"<製品のインストールディレクトリ>\CC\web\containers\<サーバ名称>\webapps"
- UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps
- cjstartwebコマンドを実行して,Webコンテナサーバを起動します。
- Windowsの場合
"<製品のインストールディレクトリ>\CC\web\bin\cjstartweb <サーバ名称>"
- UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstartweb <サーバ名称>
これによって,WARファイルが自動展開され,Webアプリケーションを利用できるようになります。デプロイ後は,手順1.で示した場所にWARファイル名の拡張子(.war)を除いた名前のディレクトリが作成されます。このディレクトリ名が,コンテキスト名として使用されます。
(b) ディレクトリのコピーによるデプロイ
ディレクトリのコピーによるデプロイの手順を次に示します。
- 次に示す場所にWebアプリケーションのディレクトリ階層をコピーします。
- Windowsの場合
"<製品のインストールディレクトリ>\CC\web\containers\<サーバ名称>\webapps"
- UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps
- cjstartwebコマンドを実行して,Webコンテナサーバを起動します。
- Windowsの場合
"<製品のインストールディレクトリ>\CC\web\bin\cjstartweb <サーバ名称>"
- UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstartweb <サーバ名称>
これによって,Webアプリケーションを利用できるようになります。コンテキスト名としては,コピーされたディレクトリ名がそのまま使用されます。
デプロイしたWebアプリケーションにアクセスするとき,URLにドメイン名を指定するだけで,Webアプリケーションのトップページを表示させるには,次の設定が必要です。
- リダイレクタのURLマッピング定義で,ルートコンテキストにリクエストが振り分けられるように設定する必要があります。リダイレクタでの設定については,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「4.2 Webサーバ(リダイレクタ)によるリクエストの振り分け」を参照してください。
なお,サーブレットエンジンモードの場合は,Webアプリケーションをデプロイするときにルートコンテキストを指定します。
- index.htmlやindex.jspなどのWebアプリケーションのトップページをルートコンテキストに配置する必要があります。Webアプリケーションのコンテキストルートを「ROOT」にしてデプロイしてください。
- WARファイルのコピーによるデプロイの場合
- WARファイル名を「ROOT.war」にしてデプロイしてください。
- なお,拡張子(.war)を除いたWARの名前はすべて大文字の「ROOT」にします。「Root」や「root」のように小文字を含んでいる場合は,拡張子(.war)を除いたWARの名前がコンテキストルートとなります。例えば,WARファイル名が「Root.war」の場合,ルートコンテキストではなく,コンテキストルートが「Root」のコンテキストになります。
- ディレクトリのコピーによるデプロイの場合
- ディレクトリ名を「ROOT」にしてデプロイしてください。
- なお,ディレクトリ名「ROOT」はすべて大文字にします。「Root」や「root」のように小文字を含んでいる場合は,指定したディレクトリの名前がコンテキストルートとなります。例えば,ディレクトリ名が「Root」の場合,ルートコンテキストではなく,コンテキストルートが「Root」のコンテキストになります。
Webアプリケーションのアンデプロイ方法は,次の2種類あります。
- WARファイルの削除によるアンデプロイ
- ディレクトリの削除によるアンデプロイ
それぞれのアンデプロイ方法について説明します。
(a) WARファイルの削除によるアンデプロイ
WARファイルの削除によるアンデプロイの手順を次に示します。
- cjstopwebコマンドを実行して,Webコンテナサーバを停止します。
- Windowsの場合
"<製品のインストールディレクトリ>\CC\web\bin\cjstopweb <サーバ名称>"
- UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstopweb <サーバ名称>
- 該当するWARファイル,および次に示す場所に自動展開されたディレクトリを削除します。
- Windowsの場合
"<製品のインストールディレクトリ>\CC\web\containers\<サーバ名称>\webapps"
- UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps
- Webコンテナサーバを再起動します。
- Windowsの場合
"<製品のインストールディレクトリ>\CC\web\bin\cjstartweb <サーバ名称>"
- UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstartweb <サーバ名称>
これによって,Webアプリケーションのアンデプロイが有効になります。
(b) ディレクトリの削除によるアンデプロイ
ディレクトリの削除によるアンデプロイの手順を次に示します。
- cjstopwebコマンドを実行して,Webコンテナサーバを停止します。
- Windowsの場合
"<製品のインストールディレクトリ>\CC\web\bin\cjstopweb <サーバ名称>"
- UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstopweb <サーバ名称>
- 次に示す場所にコピーしたディレクトリを削除します。
- Windowsの場合
"<製品のインストールディレクトリ>\CC\web\containers\<サーバ名称>\webapps"
- UNIXの場合
/opt/Cosminexus/CC/web/containers/<サーバ名称>/webapps
- Webコンテナサーバを再起動します。
- Windowsの場合
"<製品のインストールディレクトリ>\CC\web\bin\cjstartweb <サーバ名称>"
- UNIXの場合
/opt/Cosminexus/CC/web/bin/cjstartweb <サーバ名称>
これによって,Webアプリケーションのアンデプロイが有効になります。
(3) Webアプリケーションに組み込むサーブレットフィルタの設定
アプリケーションサーバでは,アプリケーションサーバ独自の機能を使用するためのサーブレットフィルタを提供しています。アプリケーションサーバが提供するサーブレットフィルタをbuilt-inフィルタといいます。
アプリケーションサーバで提供しているbuilt-inフィルタのうち,サーブレットエンジンモードで使用できるフィルタは,HTTPレスポンス圧縮フィルタだけです。
各built-inフィルタの処理内容,およびbuilt-inフィルタの組み込み順序については,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「2.9.1 アプリケーションサーバが提供するサーブレットフィルタ(built-inフィルタ)」を参照してください。
サーブレットエンジンモードの場合は,WebアプリケーションのDD(web.xml)を直接編集してフィルタを組み込む必要があります。built-inフィルタの組み込みについては,マニュアル「アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)」の「2.10.3 HTTPレスポンス圧縮フィルタを使用するアプリケーションの実装」を参照してください。
All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.