Serverにリクエストをプロキシするために使用するWebLogicプロキシ・プラグイン(mod_wl_ohs)の構成方法について説明します。12.1.2のインストールに含まれています。これを別途ダウンロードしてインストールする必要はありません。Server用のプラグインのそれと似ています。Controlを使用するかmod_wl_ohs.conf構成ファイルを手動で編集することで構成できます。この章の内容は次のとおりです。WebLogicプロキシ・プラグインの構成の前提条件WebLogicプロキシ・プラグインの構成を開始する前に、次のことを行います。Serverの管理コンソールにアクセスできることを確認してください。Managerコンソールにアクセスできることを確認してください。Control提供のグラフィカル・インタフェースを使用してWebLogicプロキシ・プラグインを構成する際に必要となります。Serverまたはクラスタにデプロイされており、アクセス可能であることを確認してください。Serverのインスタンスが10.3.4以降の場合、「WebLogicプラグインの有効化」パラメータを設定する必要があります。Serverの管理コンソールにログインします。「ドメイン構造」ペインで、「環境」ノードを展開します。Serverからリクエストをプロキシするサーバー・インスタンスがクラスタにある場合、「クラスタ」を選択します。その他の場合は、「サーバー」を選択します。Serverからリクエストをプロキシするサーバーまたはクラスタを選択します。一般」タブが表示されます。「詳細」セクションまでスクロール・ダウンし、セクションを展開して「WebLogicプラグインの有効化」チェックボックスを選択します。Serverからリクエストをプロキシする他のサーバーに対してステップ3および4を繰り返します。「保存」をクリックします。サーバー・インスタンスを再起動したら変更が適用されます。Controlを使用してmod_wl_ohsモジュールを構成するには、次を実行します。2.1項に記載されている前提条件を満たしていることを確認してください。Serverメニューで「管理」を選択します。「管理」メニューでmod_wl_ohs構成を選択します。「mod_wl_ohs構成」ページが表示されます。次の表に示す構成設定を指定します。サーバーまたはクラスタのリストは、「ホスト:ポート」エントリのリストです。複数のクラスタと単一サーバーの組合せを指定すると、このパラメータに戻される動的リストは、クラスタ化されたサーバーのみを戻します。適切なクラスタかどうかが不明な場合は、検索アイコンをクリックしてすべての関連クラスタのリストを確認できます。詳細は、第2.2.1項「検索機能の使用」を参照してください。モジュールは、すべての利用可能なサーバー間で単純なラウンドロビンを行います。このプロパティで指定するサーバー・リストは、サーバーとモジュールが保持する動的サーバー・リストの起点になります。Serverとこのモジュールは連携して自動的にサーバー・リストを自動的に更新します。動的クラスタ・リストの使用を無効にするには、「動的サーバー・リストをオン」フィールドを無効にします。モジュールは、Cookie、URLエンコードされたセッション、またはPOSTデータに格納されたセッションを含むHTTPリクエストを、最初にCookieを作成したクラスタ内のサーバーに転送します。「WebLogicクラスタ」と「WebLogicホスト」は相互排他的フィールドであるため、どちらか1つのみを指定してください。両方のフィールドに値を指定した場合は、「WebLogicクラスタ」が優先されます。Serverで定義された仮想ホスト名)。Clusterパラメータを使用します。適切なサーバーかどうかが不明な場合は、検索アイコンをクリックしてすべての関連クラスタのリストを確認できます。詳細は、第2.2.1項「検索機能の使用」を参照してください。「WebLogicホスト」と「WebLogicクラスタ」は相互排他的フィールドであるため、どちらか1つのみを指定してください。両方のフィールドに値を指定した場合は、「WebLogicクラスタ」が優先されます。Serverホストがリスニングするポート。Serverの間でSSLを使用している場合、このパラメータをSSLのリスニング・ポートに設定します。オフ「オフ」に設定すると、モジュールからプロキシされるリクエストをロード・バランシングするために使用される動的クラスタ・リストが無視され、「WebLogicクラスタ」パラメータで指定された静的リストのみが使用されます。通常、このパラメータはオンに設定する必要があります。このパラメータをオフに設定すると、いくつかの影響があります。静的リストの1つまたは複数のサーバーで障害が発生した場合、モジュールは応答不能のサーバーへの接続に時間を費やし、その結果としてパフォーマンスが低下する可能性があります。クラスタに新しいサーバーを追加した場合は、このパラメータを再定義するまでモジュールはその新しいサーバーにリクエストをプロキシできません。Serverは、新しいサーバーがクラスタに追加されたときに動的サーバー・リストにその新しいサーバーを自動的に追加します。Serverに転送できなかった場合に表示される、ユーザー独自のエラー・ページを作成できます。WebLogic一時ディレクトリPOSTデータ・ファイルの_wl_proxyディレクトリの場所を指定します。パスまたはMIMEタイプの除外このパラメータを使用すると、特定のリクエストをプロキシ処理から除外できます。このパラメータは、Locationタグ・レベルでローカルに定義することも、グローバルに定義することもできます。このプロパティをローカルに定義した場合、グローバルなプロパティはオーバーライドされず、2つのパラメータの結合が定義されます。一致式この領域では、式のオーバーライドを指定します。MIMEタイプでプロキシする場合は、次のように入力します。WebLogicHost=myHost|paramName=value次の構文を使用して、一致式の新しいパラメータを定義できます。PathTrim=/foo場所この表は、場所のオーバーライドの指定に使用します。次のステップ6を参照してください。必要に応じて、「一致式」フィールドに式のオーバーライドを追加します。必要に応じて、「場所」表に場所のオーバーライドを追加します。これを行うには:「行の追加」をクリックして、新しい行を作成します。関連するディレクティブが有効になる基本URIを入力します。「WebLogicクラスタ」、「WebLogicホスト」および「WebLogicポート」の各フィールドに値を入力します。自動入力をクリックしてこれらの値を自動的に入力できます(第2.2.2項「自動入力機能の使用」を参照)。「パスの切捨て」フィールドについては、RFC仕様により、URLの一般的な構文は次のとおりです。Serverにリクエストが転送される前に、元のURLの{PATH}/{FILENAME}の部分から取り除く文字列を指定します。Serverに転送されるURLは次になります。Serverにリクエストをプロキシする場合、/fooへのアプリケーション・パスを変更してweblogic/fooを含めるようにする必要があります。「パスの切捨て」と「パスの付加」を組み合せることで、このパスを変更できます。「パスの付加」フィールドについては、RFC仕様により、URLの一般的な構文は次のとおりです。Serverにリクエストが転送される前に、元のURLの{PATH}の部分の先頭に付加されるパスを指定します。注意:ファイル名を末尾に追加する必要がある場合は、「パスの付加」ではなく、DefaultFileNameモジュール・パラメータを使用します。新規の行を保存するには「行の追加」を再度クリックします。設定が正しければ、「適用」をクリックして変更を適用します。設定が正しくないか、変更を適用しない場合は、「元に戻す」をクリックして元の設定に戻します。Serverメニューから「制御」を選択し、「起動」を選択します。mod_wl_ohsモジュールの構成が保存され、「mod_wl_ohs構成」ページに表示されます。Serverインスタンスで使用可能なクラスタまたはサーバーのリストを表示できます。検索機能を使用するには、次のことを行います。「WebLogicクラスタ」または「WebLogicホスト」の検索アイコンをクリックします。Serverの選択」ダイアログ・ボックスが表示されます。使用するクラスタまたはサーバーを選択して、「OK」をクリックします。選択したクラスタまたはサーバーの名前が、該当するフィールドに表示されます。Serverとエンドポイントの位置を、WebLogicプロキシ・プラグインの「構成」画面の「ロケーション」表に簡単に追加できます。これを行うには:「追加」をクリックして、新しい場所を追加します。「場所」フィールドに場所名を入力します。自動入力をクリックします。同じ名前の場所のデータが更新され、新しい場所が表に追加されます。WebLogicプロキシ・プラグインの手動による構成WebLogicプロキシ・プラグインを手動で構成するには、mod_wl_ohs.confファイルでディレクティブを指定します。2.1項に記載されている前提条件を満たしていることを確認してください。次のディレクトリに配置されているmod_wl_ohs.confファイルをテキスト・エディタで開きます。weblogic_module>要素を見つけます。weblogic_module>要素にディレクティブを追加します。weblogic_module>要素の中に指定することをお薦めします。Controlに表示されるように、mod_wl_ohs.conf構成ファイルの中に指定したディレクティブと矛盾する可能性があります。Serverインスタンス上で実行されるアプリケーションにリクエストを転送するには、その宛先サーバーの詳細を<location>要素の中に指定します。Serverのリスニング・ポートlocalhost:7001の/myapp1へと転送されます。Serverインスタンスのクラスタで実行されるアプリケーションにリクエストを転送するには、その宛先クラスタの詳細を新しい<location>要素の中に指定します。Serverクラスタの/myapp2へと転送されます。Serverインスタンスとクラスタで実行されるアプリケーションなど、複数の宛先を構成する場合は、各宛先を異なる<location>子要素の中に指定する必要があります。weblogic_module>要素内のすべての<location>子要素は同じレベルにある必要があります。Serverの高可用性デプロイメントを有効にする目的などでWebLogicプロキシ・プラグインを管理対象サーバーにリンクできるように構成するには、mod_wl_ohs.confを次のように編集します。index.jsp</Location>注意:SSL終端を使用していて、リクエストをWebLogicにルーティングする場合は、次の追加の構成が必要になります。WebLogicコンソールで、ドメイン、クラスタまたは管理対象サーバーのレベルで「WebLogicプラグインの有効化」をtrueに設定する必要があります。WebLogic管理対象サーバーにリクエストを送信するLocationブロックで、次の行も追加する必要があります。index.jsp</Location>WebLogicプラグインを有効にした後に、管理サーバーを再起動する必要があります。WebLogic管理対象サーバーにリクエストをルーティングする2種類の方法を示しています。<ifModule>ブロックは、Apphost1およびApphost2にあるWebLogic管理対象サーバー・クラスタに*.jspで終わるリクエストを送信します。<Location>ブロックは、Apphost1およびApphost2にあるWebLogic管理対象サーバー・クラスタに、/weblogicで始まるURLを持つリクエストを送信します。Server間の一方向SSLおよび双方向SSLをサポートするようにWebLogicプロキシ・プラグインを構成する方法の詳細は、「プラグインでのSSLの使用」を参照してください。mod_wl_ohs.confファイルで指定できるその他のディレクティブの詳細は、第7章「Webサーバー・プラグインのパラメータ」を参照してください。Serverを再起動します。Serverエラー・ログ・メカニズムの一部です。参照先には、簡単に識別できるように接頭辞weblogic:が付いています。https://example.com/app/fileUploadAction.doディレクティブWLLogFileとDebugは非推奨になりました。構成でこれらのディレクティブがまだ使用されている場合、次の注意がコンソールのログ・ファイルに表示されます。instead.プラグイン・ログを有効にするには:OraLogModeをODLテキストに設定した場合、OraLogSeverityをTRACE:32に設定します。これらのログは、OraLogDirディレクトリに表示されます(instance-name.log)。これがデフォルトです。OraLogModeをapacheに設定した場合、LogLevelをdebugに設定します。ErrorLogディレクティブは、エラー・ログの出力先ファイルを示します。Serverログの管理」を参照してください。WebLogicプロキシ・プラグイン実装のトラブルシューティングこの項では、WebLogicプロキシ・プラグインの使用時に発生する可能性のある一般的な問題とその解決方法について説明します。内容は次のとおりです。WLSセッションの問題WebLogicプロキシ・プラグインは、バックエンドWLSサーバー/クラスタにリクエストをルーティングします。WLSはセッションは、同じクライアントからの後続のリクエストが同じWLSサーバーにルーティングされるように接続を維持します。様々な原因でWebLogicプロキシ・プラグインがWLSサーバーと通信できなくなった場合には次のことが起きます。Serverインスタンスへの接続を試行し続けます。503エラー・メッセージがクライアントに戻されます。リクエストがWebLogicクラスタにルーティングされた場合は、現在のWLSサーバーが「bad」とマークされ、そのリクエストは次に使用可能なWLSサーバーにルーティングされます。503エラー・メッセージがクライアントに戻されます。503エラー・メッセージが送信されるほかに、HTTPクライアントにレスポンスとして次のメッセージが表示されます。CONNECTION_REFUSEDエラーストレス条件下では、少数のリクエストが失敗し、エラー・ログ・ファイルに次のエラーが記録されることがあります。port=xxxx'第6.4.2項「Connection_Refusedエラーを減らすためのヒント」で説明されているように、WLSサーバーのバックログ接続数が最大許容値に達した可能性があります。解決するには、第6.4.2項「Connection_Refusedエラーを減らすためのヒント」に記載されている手順に従ってください。NO_RESOURCESエラーストレス条件下では、少数のリクエストが失敗し、エラー・ログ・ファイルに次のエラーが記録されることがあります。URL.cppこれは通常、WLSサーバーがビジー状態でWebLogicプロキシ・プラグインからの接続リクエストにレスポンスできない場合に発生します。WLSocketTimeoutSecsにより高い値を設定することで解決する場合があります。これにより、WebLogicプロキシ・プラグインが接続リクエストに対するWLSサーバーからのレスポンスを待機する時間が長くなります。reserved.法律上の注意点ライブラリ。