付録E.1 Microsoft IIS 10.0の設定
ここでは,Microsoft IISを使用してWebサーバと連携する場合のMicrosoft IIS 10.0の設定方法について説明します。
J2EEサーバとMicrosoft IISとの連携は,次に示す手順で設定します。
-
Microsoft IISおよび役割サービスのインストール
-
ISAPIおよびCGIの制限の追加
-
ISAPIフィルタの追加
-
ハンドラマッピングの設定
-
仮想ディレクトリの追加
-
Webサーバの認証機能の解除
-
[サーバー]ノードでのアプリケーションプールの設定
-
[サイト]ノードでのアプリケーションプールの設定
-
リダイレクタログ出力先ディレクトリへのアクセス権の設定
-
Webサイトの開始
- 参考
-
Microsoft IISの設定で使用する,[インターネット インフォメーション サービス(IIS)マネージャー]の画面構成を次に示します。なお,以降で示す手順に従って,[接続]ウィンドウ,[機能ビュー],[操作]ウィンドウなどで設定を実施してください。
- 〈この項の構成〉
(1) Microsoft IISおよび役割サービスのインストール
Microsoft IISを使用する場合,Microsoft IISおよび用途に応じた役割サービスをインストールする必要があります。IISおよび役割サービスをインストールする手順を次に示します。
Microsoft IISがインストール済みの場合,不足している役割サービスがあれば追加インストールしてください(必要な役割サービスについては後述)。
-
[サーバーマネージャー]を起動します。
(自動起動していない場合,スタート画面から起動できます)
-
[サーバーマネージャー]の[役割と機能の追加]をクリックします。
-
ウィザードが起動するので[次へ]をクリックします。
-
[役割ベースまたは機能ベースのインストール]を選択し,[次へ]をクリックします。
-
対象のサーバを選択し,[次へ]をクリックします。
-
[サーバーの役割]では,[Webサーバー(IIS)]を選択し,[次へ]をクリックします。
[Webサーバー(IIS)に必要な機能を追加しますか?]のポップアップが出た場合,[管理ツールを含める(存在する場合)]にチェックを入れて[機能の追加]をクリックします。
-
[機能の選択]では[次へ]をクリックします。
-
[Webサーバーの役割(IIS)]では[次へ]をクリックし,[役割サービスの選択]では最低限次の役割サービスを選択し,[次へ]をクリックします。
-
HTTPエラー
-
ディレクトリの参照
-
既定のドキュメント
-
静的なコンテンツ
-
ISAPI拡張
-
ISAPIフィルター
-
IIS管理コンソール
指定した役割サービス以外も必要に応じて追加してください。特に[HTTPログ]や[トレース]は障害発生時のトラブルシュートに有益です。
-
-
[インストール]をクリックします。
-
[閉じる]をクリックします。
インストールが完了します。
(2) ISAPIおよびCGIの制限の追加
ISAPIおよびCGIの制限を追加する手順を次に示します。
-
[インターネット インフォメーション サービス(IIS)マネージャー]を起動します。
[サーバマネージャー]の[ツール]から起動できます。
-
[機能ビュー]のサーバの[ホーム]ページで,[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) Webサーバの認証機能の解除
Webコンテナの認証機能を使用する場合,次に示すWebサーバの認証機能の解除が必要になります。
-
Active Directory クライアント証明書の認証
Webコンテナが管理するリソースへアクセスする場合は解除してください。
-
ダイジェスト認証
Webコンテナの認証機能の使用の有無に関係なく,必ず解除してください。
-
Windows認証
Webコンテナの認証機能(Basic認証)を使用する場合は解除してください。
-
APS.NET偽装
Webコンテナが管理するリソースへアクセスする場合は解除してください。
Active Directory クライアント証明書の認証,ダイジェスト認証,Windows認証,フォーム認証およびAPS.NET偽装を解除する手順を次に示します。
-
[接続]ウィンドウでサーバの[ホーム]ページを選択し,[認証]をダブルクリックします。
-
[認証]画面で,[Active Directory クライアント証明書の認証]を選択し,[操作]ウィンドウで[無効にする]をクリックします(任意)。
-
[接続]ウィンドウで[サイト]ノードを展開し,「hitachi_ccfj」をクリックします。
-
[ホーム]ページで[認証]をダブルクリックします。
-
[認証]画面で,[フォーム認証]を選択し,[操作]ウィンドウで[無効にする]をクリックします(任意)。
Webコンテナが管理するリソースへアクセスする場合は解除してください。
-
[認証]画面で,[ダイジェスト認証]を選択し,[操作]ウィンドウで[無効にする]をクリックします(必須)。
Webコンテナの認証機能の使用の有無に関係なく,ダイジェスト認証は必ず無効にしてください。
-
[認証]画面で,[Windows認証]を選択し,[操作]ウィンドウで[無効にする]をクリックします(任意)。
WebコンテナのBasic認証を設定している場合は,必ず解除してください。
-
[認証]画面で,[APS.NET偽装]を選択し,[操作]ウィンドウで[無効にする]をクリックします(任意)。
Webコンテナが管理するリソースへアクセスする場合は解除してください。
-
[OK]ボタンをクリックして各ウィンドウを閉じます。
(7) [サーバー]ノードでのアプリケーションプールの設定
[サーバー]ノードでのアプリケーションプールの設定手順を次に示します。
-
[接続]ウィンドウでサーバノードを展開し,[アプリケーション プール]をクリックします。
-
[アプリケーション プール]ページで,使用するアプリケーションプールを選択し,[操作]ウィンドウの[詳細設定]をクリックします。
-
[詳細設定]ダイアログで次の操作をします。
[ワーカー プロセスの最大数]※に,Microsoft IIS内でリクエストを処理するプロセスの最大数を指定します。
- 注※
-
このマニュアルでは,Webコンテナの実行プロセスのことも「ワーカプロセス」と表記していますが,ここで設定する「ワーカー プロセス」とはMicrosoft IIS内でリクエストを処理するプロセスを指します。
-
[OK]ボタンをクリックします。
[詳細設定]ダイアログが閉じて,設定が反映されます。
(8) [サイト]ノードでのアプリケーションプールの設定
サイトノードでのアプリケーションプールの設定手順を次に示します。
-
[接続]ウィンドウで[サイト]ノードを展開し,アプリケーションプールを指定するサイトをクリックします。
-
[操作]ウィンドウで,[詳細設定]をクリックします。
-
[詳細設定]ダイアログで,[アプリケーションプール]を入力します。
[アプリケーションプール]に,「(7) [サーバー]ノードでのアプリケーションプールの設定」で設定したアプリケーションプールの名称を指定します。
-
[OK]ボタンをクリックします。
[詳細設定]ダイアログが閉じて,設定が反映されます。
(9) リダイレクタログ出力先ディレクトリへのアクセス権の設定
リダイレクタのログ出力先ディレクトリには,Microsoft IISのアプリケーションプールの実行アカウントに対する書き込み権限を付加しておく必要があります。エクスプローラから,リダイレクタのログ出力ディレクトリにアクセス権を設定してください。
アプリケーションプールの実行アカウントは,アプリケーションプールの[詳細設定]ダイアログの[ID]で指定します。デフォルトのIDを指定している場合は,「IIS_IUSRS」グループに対して書き込み権限を付加してください。
デフォルトのIDは次のとおりです。
-
Microsoft IIS 10.0:「ApplicationPoolIdentity」
なお,新規インストール時には,デフォルトの状態ではリダイレクタのログ出力先ディレクトリ(<Application Serverのインストールディレクトリ>\CC\web\redirector\logs)がありません。このため,logsディレクトリを作成してアクセス権を設定するか,または一つ上のディレクトリ(redirectorディレクトリ)にアクセス権を設定してください。
また,リダイレクタのログ出力先ディレクトリを変更している場合に,指定しているパスが途中までしかないときは,存在する最下層のディレクトリに対してアクセス権を設定するか,または指定したパスに対応するディレクトリをすべて作成して,最下層のディレクトリにアクセス権を設定してください。
(10) Webサイトの開始
Microsoft IISのWebサイトの開始の手順を次に示します。
-
[接続]ウィンドウで[サイト]ノードを展開し,開始するサイトをクリックします。
-
[操作]ウィンドウで,[開始]をクリックします。開始済みの場合は,[再起動]をクリックします。
Webサイトが開始,または再起動します。
(11) 注意事項
ここでは,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キーの詳細については,「13.2.1 isapi_redirect.conf(Microsoft IIS用リダイレクタ動作定義ファイル)」を参照してください。