Cosminexus V9 アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)
付録C.1 Microsoft IIS 7.0,Microsoft IIS 7.5,Microsoft IIS 8.0,またはMicrosoft IIS 8.5の設定
ここでは,Microsoft IISを使用してWebサーバと連携する場合のMicrosoft IIS 7.0,Microsoft IIS 7.5,Microsoft IIS 8.0,またはMicrosoft IIS 8.5の設定方法について説明します。
J2EEサーバとMicrosoft IISとの連携は,次に示す手順で設定します。
- Microsoft IISおよび役割サービスのインストール
- ISAPIおよびCGIの制限の追加
- ISAPIフィルタの追加
- ハンドラマッピングの設定
- 仮想ディレクトリの追加
- [サーバー]ノードでのアプリケーションプールの設定
- [サイト]ノードでのアプリケーションプールの設定
- リダイレクタログ出力先ディレクトリへのアクセス権の設定
- Webサイトの開始
- 参考
- Microsoft IIS 7.0とMicrosoft IIS 7.5以降では,画面表記が一部異なります。以降の手順では,Microsoft IIS 7.5以降の場合の表記で説明します。Microsoft IIS 7.0を使用している場合は,次の表に示すとおりに読み替えてください。
Microsoft IIS 7.5以降の画面表記 |
Microsoft IIS 7.0の画面表記 |
サーバーマネージャー |
サーバーマネージャ |
インターネット インフォメーション サービス(IIS)マネージャー |
インターネット インフォメーション サービス(IIS)マネージャ |
ISAPIフィルター |
ISAPIフィルタ |
フィルター名 |
フィルタ名 |
ハンドラー マッピング |
ハンドラ マッピング |
ワーカー プロセス |
ワーカ プロセス |
- Microsoft IISの設定で使用する,[インターネット インフォメーション サービス(IIS)マネージャー]の画面構成を次に示します。なお,以降で示す手順に従って,[接続]ウィンドウ,[機能ビュー],[操作]ウィンドウなどで設定を実施してください。
- <この項の構成>
- (1) Microsoft IISおよび役割サービスのインストール
- (2) ISAPIおよびCGIの制限の追加
- (3) ISAPIフィルタの追加
- (4) ハンドラマッピングの設定
- (5) 仮想ディレクトリの追加
- (6) [サーバー]ノードでのアプリケーションプールの設定
- (7) [サイト]ノードでのアプリケーションプールの設定
- (8) リダイレクタログ出力先ディレクトリへのアクセス権の設定
- (9) Webサイトの開始
- (10) 注意事項
(1) Microsoft IISおよび役割サービスのインストール
Microsoft IISを使用する場合,Microsoft IISおよび用途に応じた役割サービスをインストールする必要があります。IISおよび役割サービスをインストールする手順を次に示します。
Microsoft IISがインストール済みの場合,不足している役割サービスがあれば追加インストールしてください(必要な役割サービスについては後述)。
<Microsoft IIS 7.0またはMicrosoft IIS 7.5を使用する場合>
- [スタート]メニューの[すべてのプログラム]−[管理ツール]から,[サーバーマネージャー]を起動します。
- [サーバーマネージャー]の[役割]を選択し,[役割の追加]をクリックします。
- ウィザードが起動するので[次へ]をクリックします。
- [サーバーの役割]では,[Webサーバー(IIS)]を選択し,[次へ]をクリックします。
[Webサーバー(IIS)に必要な機能を追加しますか?]のポップアップが出た場合,[必要な機能を追加]をクリックします。
- [Webサーバー(IIS)]では[次へ]をクリックします。
- [役割サービス]では,最低限次の役割サービスを選択し,[次へ]をクリックします。
- 静的なコンテンツ
- 既定のドキュメント
- ディレクトリの参照
- HTTPエラー
- ISAPI拡張
- ISAPIフィルター
- IIS管理コンソール
指定した役割サービス以外も必要に応じて追加してください。特に[HTTPログ]や[トレース]は障害発生時のトラブルシュートに有益です。
- [インストール]をクリックします。
- [閉じる]をクリックします。
インストールが完了します。
<Microsoft IIS 8.0またはMicrosoft IIS 8.5を使用する場合>
- [サーバーマネージャー]を起動します。
(自動起動していない場合,スタート画面から起動できます)
- [サーバーマネージャー]の[役割と機能の追加]をクリックします。
- ウィザードが起動するので[次へ]をクリックします。
- [役割ベースまたは機能ベースのインストール]を選択し,[次へ]をクリックします。
- 対象のサーバを選択し,[次へ]をクリックします。
- [サーバーの役割]では,[Webサーバー(IIS)]を選択し,[次へ]をクリックします。
[Webサーバー(IIS)に必要な機能を追加しますか?]のポップアップが出た場合,[管理ツールを含める(存在する場合)]にチェックを入れて[機能の追加]をクリックします。
- [機能の選択]では[次へ]をクリックします。
- [Webサーバーの役割(IIS)]では[次へ]をクリックし,[役割サービスの選択]では最低限次の役割サービスを選択し,[次へ]をクリックします。
- HTTPエラー
- ディレクトリの参照
- 既定のドキュメント
- 静的なコンテンツ
- ISAPI拡張
- ISAPIフィルター
- IIS管理コンソール
指定した役割サービス以外も必要に応じて追加してください。特に[HTTPログ]や[トレース]は障害発生時のトラブルシュートに有益です。
- [インストール]をクリックします。
- [閉じる]をクリックします。
インストールが完了します。
(2) ISAPIおよびCGIの制限の追加
ISAPIおよびCGIの制限を追加する手順を次に示します。
- [インターネット インフォメーション サービス(IIS)マネージャー]を起動します。
Microsoft IIS 7.0またはMicrosoft IIS 7.5の場合は[スタート]メニューの[すべてのプログラム]−[管理ツール]から,Microsoft IIS 8.0またはMicrosoft IIS 8.5の場合は[サーバマネージャー]の[ツール]から起動できます。
- [機能ビュー]のサーバの[ホーム]ページで,[ISAPIおよびCGI制限]をダブルクリックします。
- [ISAPIおよびCGI制限]ページの[操作]ウィンドウで[追加]をクリックします。
- [ISAPIまたはCGIの制限の追加]ダイアログで次の操作をします。
- [ISAPIまたはCGIパス]にリダイレクタのDLL(<Application Serverのインストールディレクトリ>\CC\web\redirector\isapi_redirect.dll)を指定します。
- [説明]に「ISAPI」と入力します。
- [拡張パスの実行を許可する]をチェックします。
- [OK]ボタンをクリックします。
[ISAPIまたはCGIの制限の追加]ダイアログが閉じて,設定が反映されます。
(3) ISAPIフィルタの追加
ISAPIフィルタを追加する手順を次に示します。
- [機能ビュー]のサイトの[ホーム]ページで[ISAPIフィルター]をダブルクリックします。
- [ISAPIフィルター]ページの[操作]ウィンドウで[追加]をクリックします。
- [ISAPIフィルターの追加]ダイアログで次の操作をします。
- [フィルター名]に「hitachi_ccfj」と入力します。
- [実行可能ファイル]にリダイレクタのDLL(<Application Serverのインストールディレクトリ>\CC\web\redirector\isapi_redirect.dll)を指定します。
- [OK]ボタンをクリックします。
[ISAPIフィルターの追加]ダイアログが閉じて,設定が反映されます。
(4) ハンドラマッピングの設定
ハンドラマッピングを設定する手順を次に示します。
- [機能ビュー]のサイトの[ホーム]ページで[ハンドラー マッピング]をダブルクリックします。
- [ハンドラー マッピング]ページで「ISAPI-dll」を選択し,[操作]ウィンドウで[編集...]をクリックします。
- [モジュール マップの編集]ダイアログで次の操作をします。
- [要求パス]に「*.dll」と入力します。
- [実行可能ファイル]にリダイレクタのDLL(<Application Serverのインストールディレクトリ>\CC\web\redirector\isapi_redirect.dll)を指定します。
すでにハンドラマッピングが設定されている場合,[スクリプトマップの編集]ダイアログが起動しますが,操作内容は同じです。
- [OK]ボタンをクリックします。
- モジュールマップの編集を有効にするかどうかを確認するメッセージダイアログで,ISAPI拡張機能を有効にするために,[はい]ボタンをクリックします。
- [ハンドラー マッピング]ページで「ISAPI-dll」を選択し,[操作]ウィンドウで[機能のアクセス許可の編集...]をクリックします。
- [機能のアクセス許可の編集]ダイアログで「読み取り」,「スクリプト」および「実行」のすべてのアクセス許可をチェックします。
- [OK]ボタンをクリックします。
[機能のアクセス許可の編集]ダイアログが閉じて,設定が反映されます。
(5) 仮想ディレクトリの追加
「hitachi_ccfj」という名称の仮想ディレクトリを追加します。仮想ディレクトリを追加する手順を次に示します。
- [接続]ウィンドウで[サイト]ノードを展開し,仮想ディレクトリを追加するサイトをクリックします。
- [操作]ウィンドウで,[仮想ディレクトリの表示]をクリックします。
[仮想ディレクトリ]ページが表示されます。
- [仮想ディレクトリ]ページの[操作]ウィンドウで,[仮想ディレクトリの追加...]をクリックします。
- [仮想ディレクトリの追加]ダイアログで次の操作をします。
- [エイリアス]に「hitachi_ccfj」と入力します。
- [物理パス]にリダイレクタのDLL(<Application Serverのインストールディレクトリ>\CC\web\redirector\isapi_redirect.dll)が格納されているディレクトリを指定します。
- [OK]ボタンをクリックします。
[仮想ディレクトリの追加]ダイアログが閉じて,設定が反映されます。
(6) [サーバー]ノードでのアプリケーションプールの設定
[サーバー]ノードでのアプリケーションプールの設定手順を次に示します。
- [接続]ウィンドウでサーバノードを展開し,[アプリケーション プール]をクリックします。
- [アプリケーション プール]ページで,使用するアプリケーションプールを選択し,[操作]ウィンドウの[詳細設定]をクリックします。
- [詳細設定]ダイアログで次の操作をします。
- [32ビットアプリケーションの有効化]に「True」を指定します(Windows x86のリダイレクタをWindows x64のOSで動かす場合だけに必要な指定です)。
- [ワーカー プロセスの最大数]※に,Microsoft IIS内でリクエストを処理するプロセスの最大数を指定します。
- 注※
- このマニュアルでは,Webコンテナの実行プロセスのことも「ワーカプロセス」と表記していますが,ここで設定する「ワーカー プロセス」とはMicrosoft IIS内でリクエストを処理するプロセスを指します。
- [OK]ボタンをクリックします。
[詳細設定]ダイアログが閉じて,設定が反映されます。
(7) [サイト]ノードでのアプリケーションプールの設定
サイトノードでのアプリケーションプールの設定手順を次に示します。
- [接続]ウィンドウで[サイト]ノードを展開し,アプリケーションプールを指定するサイトをクリックします。
- [操作]ウィンドウで,[詳細設定]をクリックします。
- [詳細設定]ダイアログで,[アプリケーションプール]を入力します。
[アプリケーションプール]に,「(6) [サーバー]ノードでのアプリケーションプールの設定」で設定したアプリケーションプールの名称を指定します。
- [OK]ボタンをクリックします。
[詳細設定]ダイアログが閉じて,設定が反映されます。
(8) リダイレクタログ出力先ディレクトリへのアクセス権の設定
リダイレクタのログ出力先ディレクトリには,Microsoft IISのアプリケーションプールの実行アカウントに対する書き込み権限を付加しておく必要があります。エクスプローラから,リダイレクタのログ出力ディレクトリにアクセス権を設定してください。
アプリケーションプールの実行アカウントは,アプリケーションプールの[詳細設定]ダイアログの[ID]で指定します。デフォルトのIDを指定している場合は,「IIS_IUSRS」グループに対して書き込み権限を付加してください。
デフォルトのIDは次のとおりです。
- Microsoft IIS 7.0:「NetworkService」
- Microsoft IIS 7.5:「ApplicationPoolIdentity」
- Microsoft IIS 8.0:「ApplicationPoolIdentity」
- Microsoft IIS 8.5:「ApplicationPoolIdentity」
なお,新規インストール時には,デフォルトの状態ではリダイレクタのログ出力先ディレクトリ(<Application Serverのインストールディレクトリ>\CC\web\redirector\logs)がありません。このため,logsディレクトリを作成してアクセス権を設定するか,または一つ上のディレクトリ(redirectorディレクトリ)にアクセス権を設定してください。
また,リダイレクタのログ出力先ディレクトリを変更している場合に,指定しているパスが途中までしかないときは,存在する最下層のディレクトリに対してアクセス権を設定するか,または指定したパスに対応するディレクトリをすべて作成して,最下層のディレクトリにアクセス権を設定してください。
(9) Webサイトの開始
Microsoft IISのWebサイトの開始の手順を次に示します。
- [接続]ウィンドウで[サイト]ノードを展開し,開始するサイトをクリックします。
- [操作]ウィンドウで,[開始]をクリックします。開始済みの場合は,[再起動]をクリックします。
Webサイトが開始,または再起動します。
ここでは,Microsoft IISの設定時の注意事項について説明します。
(a) 構成設定の複数環境へのレプリケーションについての注意事項
Microsoft IISでは,構成設定をweb.configファイルに保存できます。また,保存したweb.configファイルを基に,xcopyを使用して複数環境に構成環境をレプリケーションできます。
ただし,リダイレクタを使用する構成環境の場合,xcopyでの複数環境へのレプリケーションでリダイレクタの設定はできません。xcopyで複数環境を同一の構成設定にする場合も,リダイレクタの設定は環境ごとに手動で同期してください。
(b) エラーページのカスタマイズについての注意事項
Microsoft IISでエラーページにカスタムエラーページを返す設定にしている場合,web.xmlの<error-page>タグによるエラーページのカスタマイズは無効となることがあります。web.xmlの<error-page>タグによるエラーページのカスタマイズを有効にしたい場合は,Microsoft IISのエラーページのカスタムエラーページの設定を無効にしてください。
(c) ほかのフィルタと共存させる場合の注意事項
Microsoft IISが受信したリクエストが,Webコンテナに転送するリクエストの場合,Microsoft IIS用リダイレクタはISAPIフィルタ内で使用するリクエストURL情報を変更します。そのため,Microsoft IIS用リダイレクタよりあとに実行されるISAPIフィルタでは,Microsoft IISが受信したリクエストURLを取得できません。Microsoft IISが受信したリクエストURLをフィルタで取得する場合は,Microsoft IIS用リダイレクタよりも順番が先になるように設定してください。順番を調整するために,Microsoft IIS用リダイレクタの優先順位を「中」または「低」に変更する必要がある場合は,isapi_redirect.conf(Microsoft IIS用リダイレクタ動作定義ファイル)のfilter_priorityキーで指定します。isapi_redirect.conf(Microsoft IIS用リダイレクタ動作定義ファイル)のfilter_priorityキーの詳細については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「9.2 isapi_redirect.conf(Microsoft IIS用リダイレクタ動作定義ファイル)」を参照してください。
All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.