J2EEサーバとHitachi Web Serverとの連携は，次に示す手順で設定します。

1. httpsd.conf（Hitachi Web Server定義ファイル）に次の行を追加します。
   
   • Windowsの場合
     Include "<Cosminexusのインストールディレクトリ>/CC/web/redirector/mod_jk.conf"
     
   • UNIXの場合
     Include /opt/Cosminexus/CC/web/redirector/mod_jk.conf
     
2. Hitachi Web Serverを再起動します。

httpsd.confの詳細，および再起動の方法については，マニュアル「Hitachi Web Server」を参照してください。

Webコンテナが提供する認証機能とWebサーバの認証機能^※を併用した場合，次の順序で認証が実施されます。

1. Webサーバでの認証
2. Webコンテナでの認証

注※

Webサーバの認証機能とは，Webサーバの基本認証，SSLのサーバ認証，SSLのクライアント認証を指します。Web認証機能の併用とは，Webコンテナが提供する認証機能を使用している場合に，Webサーバの基本認証，SSLのサーバ認証，SSLのクライアント認証のどれか一つ以上を使用しているときを指します。

認証機能の詳細については，マニュアル「Cosminexus　機能解説」のWebコンテナのセキュリティ管理に関する説明を参照してください。また，Hitachi Web Serverのユーザ認証機能，およびアクセス制御機能については，マニュアル「Hitachi Web Server」を参照してください。

●Hitachi Web Serverの再起動時の注意事項

Hitachi Web Serverの再起動に失敗した原因がmod_jk.conf（リダイレクタ定義ファイル），またはworkers.properties（ワーカ定義ファイル）にある場合，次のどちらかにメッセージが出力されます。

• Hitachi Web Serverの起動コマンド実行画面またはイベントログ
  
  • Hitachi Web Serverをコマンドプロンプトから起動，停止，または再起動するときは，起動コマンド実行画面に出力されます。
  • Hitachi Web Serverをサービスから起動，停止，または再起動するときは，イベントログに出力されます。Windowsの場合だけが該当します。
• Hitachi Web Serverのエラーログファイル
  エラーログファイルは，デフォルトでは次の場所に出力されます。
  
  • Windowsの場合
    <Hitachi Web Serverのインストールディレクトリ>\logs\error.log
    
  • UNIXの場合
    opt/hitachi/httpsd/logs/error.log
    

それぞれに出力されるメッセージを表に示します。

表18-5　Hitachi Web Serverの起動コマンド実行画面またはイベントログに出力されるメッセージ

メッセージ	原因・対策方法
JkWorkersFile file_name invalid※	JkWorkersFileキーに指定されたファイル名が無効です。JkWorkersFileキーに指定している値を修正したあと，Webサーバを再起動してください。
Can't find the workers file specified※	指定されたワーカ定義ファイルが見つかりません。JkWorkersFileキーに指定されているファイルの有無を確認したあと，Webサーバを再起動してください。
Content should start with /※	URLパターンの先頭文字が「/」（スラッシュ）以外です。JkMountキーに指定されているURLパターンの先頭文字を「/」（スラッシュ）に修正したあと，Webサーバを再起動してください。
JkOptions: Illegal option 'a...a'	JkOptionキーに指定された値（a...a）は不正です。 JkOptionキーに指定している値を修正したあと，Webサーバを再起動してください。
a...a takes b...b arguments,	a...aに示すキーに指定できる値の数はb...bです。 a...aに示すキーに指定している値の数を修正したあと，Webサーバを再起動してください。
a...a must be On or Off	a...aに示すキーに指定できる値はOnまたはOffです。 a...aに示すキーに指定している値をOnまたはOffにしたあと，Webサーバを再起動してください。
JkModulePriority: Invalid value specified.a...a	JkModulePriorityキーに設定された値a...aが不正です。JkModulePriorityキーに正しい値を設定して，Webサーバを再起動してください。

注※　UNIXの場合だけ出力されるメッセージです。

表18-6　Hitachi Web Serverのエラーログファイル

メッセージ	説明・対策方法
[時刻] [emerg] Memory error	メモリが不足しています。 システムが利用できるメモリ使用量を確保したあと，Webサーバを再起動してください。
[時刻] [emerg] Error while opening the workers※	次のどちらかの問題が発生しています。 ワーカ定義ファイルのオープンに失敗しました。 JkWorkersFileキーに指定されているファイルのアクセス権に読み取り権限があることを確認したあと，Webサーバを再起動してください。 ワーカ定義ファイルの内容が不正です。 ワーカ定義ファイルの内容を正しく修正したあと，Webサーバを再起動してください。
[時刻] [emerg] Error while checking the mod_jk.conf※	リダイレクタ定義ファイルに不適切な記述がありました。リダイレクタに出力されているメッセージを確認したあと，Webサーバを再起動してください。

注※　UNIXの場合だけ出力されるメッセージです。

●リダイレクタのログに関する注意事項

• ログ出力先ディレクトリにHitachi Web Serverの実行アカウントの書き込み権限がない場合，リクエストは正常に処理されますが，ログは出力されません。
• Windowsの場合，デフォルトの状態ではリダイレクタのログ出力先ディレクトリ（<Cosminexusのインストールディレクトリ>\CC\web\redirector\logs）がありません。このため，Hitachi Web Serverは，起動時に一つ上のディレクトリ（redirectorディレクトリ）のアクセス権を引き継いで，logsディレクトリを生成してログを出力しようとします。このとき，Hitachi Web Serverの実行アカウントの書き込み権限がないとログは出力されません。この場合は，logsディレクトリを生成してアクセス権を設定するか，または一つ上のディレクトリ（redirectorディレクトリ）にアクセス権を設定してください。
  また，リダイレクタのログ出力先ディレクトリを変更している場合に，指定しているパスが途中までしかないときは，存在する最下層のディレクトリに対してアクセス権を設定するか，または指定したパスに対応するディレクトリをすべて作成して，最下層のディレクトリにアクセス権を設定してください。