8 接続の管理

Oracle HTTP Serverの接続は、ポートの作成、ポート番号の使用状況の表示、および仮想ホストの構成を行うことによって管理およびモニターできます。

この章には、Oracle HTTP Serverの接続を管理するための手順を説明する次の項が含まれています。

デフォルトのリスニング・ポート

リスニング・ポート(SSLおよび非SSL)には、デフォルトの範囲のポート番号があります。

自動ポート割当ては、ohs_createInstance()またはFusion Middleware Controlを使用している場合のみ発生します。デフォルトの非SSLポートは7777です。ポート7777が占有されている場合は、7777から65535の範囲で次に使用可能なポート番号が割り当てられます。デフォルトのSSLポートは4443です。この場合も、ポート4443が占有されている場合は、4443から65535の範囲で次に使用可能なポート番号が割り当てられます。

Configuration Wizardを使用してインスタンスを生成する場合には、自分でポート管理を行う必要があります。Configuration Wizardには、自動ポート割当て機能はありません。

新しいOracle HTTP Serverコンポーネントを作成する際のポートの指定の詳細は、「Oracle HTTP Serverインスタンスの作成」を参照してください。

管理ポートの定義

管理ポートは、Oracle HTTP Serverにより内部的にノード・マネージャとの通信に使用されます。このポートは、admin.confに構成されています。

ノード・マネージャと管理ポートの通信はデフォルトでSSLで行われます。管理ポートでSSLを無効化してプレーン・テキスト通信を使用することは可能ですが、お薦めしません。SSLを無効にした場合、Oracle HTTP Serverの起動時にプレーン・テキスト通信を示す警告メッセージがコンソールとohs_nm.logに記録されてから、OHSが正常に起動します。サンプルの警告メッセージを次に示します。

“SSL is not enabled for the admin port of 'ohs1'. Thus,
the connection between NodeManager and the admin port of 'ohs1' is not
secure. SSL must be enabled for this connection. For more
information on how to enable SSL for this connection, refer to OHS
documentation”.

「管理ポート用のSSLの構成」を参照してください。

自動Adminポート割当ては、ohs_createInstance()またはFusion Middleware Controlを使用している場合のみ発生します。Configuration Wizardを使用してインスタンスを生成する場合には、自分で管理ポートの管理を行う必要があります。Configuration Wizardには、自動ポート割当て機能はありません。

なんらかの理由で別の目的のためにデフォルトのポートを使用する必要がある場合は、構成ウィザードを使用してドメインを更新し、そこでポートを手動でリセットすることによって、管理ポートを再構成できます。

ポート番号の使用状況の表示

ポートは、Fusion Middleware ControlまたはWLSTを使用して表示できます。

この項には次のトピックが含まれます:

Fusion Middleware Controlを使用したポート番号の使用状況の表示

Fusion Middleware Controlの「ポートの使用状況」詳細ページに、ポートの割当て方法を表示できます。Fusion Middleware Controlを使用してポート番号の使用状況を表示するには、次の手順を実行します。

  1. Oracle HTTP Serverのホームページに移動します。
  2. 「Oracle HTTP Server」メニューから「ポートの使用状況」を選択します。

    「ポートの使用状況」詳細ページには、コンポーネント、使用中のポート、ポートがバインドされているIPアドレス、および使用中のプロトコルが表示されます。

WLSTを使用したポート番号の使用状況の表示

Oracle HTTP Serverをコロケート・モードで使用している場合には、WLSTコマンドを使用して特定インスタンスのポート番号情報を表示できます。

  1. WLSTを起動します。
    $ORACLE_HOME/oracle_common/common/bin/wlst.sh
    
  2. AdminServerに接続します。
  3. editCustom()コマンドを使用して、oracle.ohs MBeanのルートに移動します。WLSTがAdministration Serverに接続されている場合にかぎり、editCustom()コマンドを使用できます。cdを使用して管理オブジェクト階層に移動し、get()Portsパラメータの値を取得します。
    editCustom()
    cd('oracle.ohs')
    cd('oracle.ohs:type=OHSInstance,name=ohs1')
    get('Ports')

WLSTは次のような値を返します。

array(java.lang.String,['7777', '4443', '127.0.0.1:9999']) 

ノート:

Unixでは、Oracle HTTP Server構成ファイルのマスター・コピーのディレクトリにcdして、Listenディレクティブに対してgrepすることもできます。

ポートの管理

Oracle HTTP Serverで使用するポートは、インストール中およびインストール後に設定できます。また、ポート番号は必要に応じて変更できます。

この項では、Fusion Middleware Controlを使用してポートを作成、編集および削除する方法について説明します。

注意:

admin.confファイル内に定義されているOracle HTTP Server管理仮想ホストおよびその構成は、WebLogic Scripting Tool (WLST)を使用して編集しないでください。

関連項目:

Oracle Fusion Middlewareの管理のOracle HTTP Serverのリスニング・ポートの変更

この項には次のトピックが含まれます:

ノート:

ポートを削除するときに、削除するポートを使用するように構成されている仮想ホストがある場合は、ポートの削除前にその仮想ホストを削除する必要があります。

Fusion Middleware Controlを使用したポートの作成

Fusion Middleware Control Createの「ポートの作成」ページでOracle HTTP Serverエンドポイントのポートを作成します。Fusion Middleware Controlを使用してポートを作成するには、次の手順を実行します。

  1. Oracle HTTP Serverのホームページに移動します。
  2. 「Oracle HTTP Server」メニューから「管理」を選択します。
  3. 「管理」メニューから「ポート構成」を選択します。
  4. 「作成」をクリックします。
  5. 「IPアドレス」メニューを使用して、新しいポートのIPアドレスを選択します。ポートは、関連付けられたホストのローカルIPアドレス、または使用可能なネットワーク・インタフェースでリスニングできます。

    ポートのSSLは、「仮想ホスト」ページで構成できます(Fusion Middleware Controlを使用した仮想ホストの構成を参照)。

  6. 「ポート」にポート番号を入力します。
  7. 「OK」をクリックします。
  8. Oracle HTTP Serverを再起動します。Oracle HTTP Serverインスタンスの再起動を参照してください。

ノート:

ポート番号の変更や、URLに影響を与えるその他の変更(ホスト名の変更、SSLの有効化または無効化など)を行う場合、新しいURLを使用してパートナ・アプリケーションをSSOサーバーに再登録する必要があります。Oracle HTTP Server mod_ossoのOSSOサーバーへの登録に関する項を参照してください。

Fusion Middleware Controlを使用したポートの編集

Fusion Middleware Controlの「ポートの編集」ページで既存のポートの値を編集できます。Fusion Middleware Controlを使用してポートを編集するには、次の手順を実行します。

  1. Oracle HTTP Serverのホームページに移動します。
  2. 「Oracle HTTP Server」メニューから「管理」を選択します。
  3. 「管理」メニューから「ポート構成」を選択します。
  4. ポート番号を変更するポートを選択します。

    Fusion Middleware Controlを使用して管理ポートを編集することはできません。これはOracle HTTP Serverがノード・マネージャとの内部通信に使用するポートですが、ほとんどの場合、変更する必要はありません。本当にこれを変更する必要がある場合は、手動でDOMAIN_HOME/config/fmwconfig/components/OHS/componentName/admin.confファイルを編集します。

  5. 「編集」をクリックします。
  6. ポートの「IPアドレス」または「ポート」(あるいはその両方)の番号を編集します。

    ポートのSSLは、「仮想ホスト」ページで構成できます(「Fusion Middleware Controlを使用した仮想ホストの構成」を参照)。

  7. 「OK」をクリックします。
  8. Oracle HTTP Serverを再起動します。Oracle HTTP Serverインスタンスの再起動を参照してください。

ノート:

ポート番号の変更や、URLに影響を与えるその他の変更(ホスト名の変更、SSLの有効化または無効化など)を行う場合、新しいURLを使用してパートナ・アプリケーションをSSOサーバーに再登録する必要があります。

スタンドアロン環境でのリスニング・ポートの無効化

WebLogic Server環境のリスニング・ポートはFusion Middleware Controlを使用して無効化できますが、これをスタンドアロン環境で行う場合は、ポートが公開されている行をコメントアウトすることによって、ステージング構成ファイルを直接更新する必要があります。たとえば:

#Listen slc01qtd.us.myCo.com:7777

ノート:

.confファイルを編集しようとする前に、構成ファイル・ディレクトリのレイアウト、ファイル編集のメカニズムおよびファイル自体についてさらに学習する必要があります。「構成ファイルの理解」を参照してください。

仮想ホストの構成

1つのマシンで複数のWebサイト(www.company1.comwww.company2.comなど)を実行する仮想ホストを作成できます。仮想ホストはIPベース(各Webサイトが固有のIPアドレスを持つ)にすることも、名前ベース(各IPアドレスで複数の名前が機能する)にすることもできます。仮想ポートが同じ物理サーバー上で動作しているという事実は、エンド・ユーザーにはわかりません。

注意:

admin.confファイル内に定義されているOracle HTTP Server管理仮想ホストおよびその構成は、WebLogic Scripting Tool (WLST)を使用して編集しないでください。

Oracle HTTP Serverの現在のリリースでは、仮想ホスト名としてIPv6およびIPv4のアドレスを使用できます。

同じ仮想ホストに対して複数のアドレスを構成することもできます。つまり、複数のアドレスに対してサービスを提供するように1つの仮想ホストを構成できます。これにより、同じ仮想ホストから同じコンテンツを使用して、異なるアドレスへの要求に対応することができます。

この項では、Fusion Middleware Controlを使用して仮想ホストを作成および編集する方法について説明します。

関連項目:

仮想ホストの詳細は、Apache HTTP Serverのドキュメントを参照してください。

Fusion Middleware Controlを使用した仮想ホストの作成

Fusion Middleware Control Createの「仮想ホストの作成」ページでOracle HTTP Serverの仮想ホストを作成できます。Fusion Middleware Controlを使用して仮想ホストを作成するには、次の手順を実行します。

  1. Oracle HTTP Serverのホームページに移動します。
  2. 「Oracle HTTP Server」メニューから「管理」を選択します。
  3. 「管理」メニューから「仮想ホスト」を選択します。
  4. 「作成」をクリックします。
  5. 「仮想ホストの作成」画面で、仮想ホスト・フィールドに名前を入力し、新規のリスニング・アドレスを入力するか、既存のリスニング・アドレスを使用するかを選択します。
    • 新規リスニング・アドレス - 特定のホスト名、IPアドレス、またはIPv6アドレス(たとえば、mymachine.com:8080など)にマップされる仮想ホストを作成する場合は、このオプションを使用します。このオプションを使用すると、次のVirtualHostディレクティブが作成されます。

      <VirtualHost mymachine.com:8080>
      
    • 既存のリスニング・アドレスの使用 - 既存のリスニング・ポートを使用して、すべてのIPアドレスにマップされる仮想ホストを作成する場合は、このオプションを使用します。このオプションを使用すると、次のタイプのVirtualHostディレクティブが作成されます。

      <VirtualHost *:8080>
      

    ノート:

    ワイルドカード文字を使用して仮想ホストを作成しようとしているときに(たとえば、*:ポート)、そのポートにlistenディレクティブが存在しない場合、仮想ホストの作成は失敗します。

    この場合、最初にlistenディレクティブを追加し、次に仮想ホストを追加するようにする必要があります。

  6. 新規の仮想ホストの場合、残りの属性を入力します。
    • サーバー名 - Oracle HTTP Serverのサーバー名

    • ドキュメント・ルート - Webサイトから表示できるメイン・ドキュメント・ツリーを構成するドキュメント・ルート・ディレクトリ

    • ディレクトリの索引 - クライアントが最初にWebページにアクセスしたときに表示されるメイン(索引)ページ

    • 管理者の電子メール・アドレス - サーバーがクライアントに送信するエラー・メッセージに挿入する電子メール・アドレス

  7. 「OK」をクリックします。
  8. Oracle HTTP Serverを再起動します。Oracle HTTP Serverインスタンスの再起動を参照してください。

不要なListenディレクティブの削除

Fusion Middleware Controlを使用して仮想ホストを作成すると、その仮想ホストのListenディレクティブも追加されます。ただし、次のような状況で仮想ホストを作成すると、不要なListenディレクティブが追加されます。

  • 仮想ホストをある1つのホスト名に対して作成中で、それと同じIPアドレスに解決される異なるホスト名にListenディレクティブがすでに存在する。

  • 仮想ホストをある1つのホスト名に対して作成中で、そのホスト名の解決先となるIPアドレスにListenディレクティブがすでに存在する。

  • 仮想ホストを複数のホスト名に対して作成中で、それらのホスト名が同じIPアドレスに解決される。

これらの状況では、同じIPアドレスに対して複数のListenディレクティブが存在するため、Oracle HTTP Serverは起動に失敗します。同じIPアドレスに対して構成された余計なListenディレクティブがある場合は、削除する必要があります。

Fusion Middleware Controlを使用した仮想ホストの構成

「仮想ホスト」ページの「構成」メニューのオプションを使用して、選択した仮想ホストの「サーバー構成」、「MIME構成」、「ログ構成」、「SSL構成」および「mod_wl_ohs構成」を指定できます。

Fusion Middleware Controlを使用して仮想ホストを構成するには、次の手順を実行します。

  1. Oracle HTTP Serverのホームページに移動します。
  2. 「Oracle HTTP Server」メニューから「管理」を選択します。
  3. 「管理」メニューから「仮想ホスト」を選択します。
  4. 表内の既存の仮想ホストを強調表示します。
  5. 「構成」をクリックします。
  6. 「構成」メニューから次のいずれかのオプションを選択し、それに対応する構成ページを開きます。これらのページの値は、仮想ホストのみに適用されます。フィールドが空白の場合、仮想ホストはサーバー・レベルで構成されている値を使用します。
  7. 各構成ページの設定を確認します。設定に問題がない場合、「OK」をクリックして変更を適用します。設定に問題がある場合、または変更を適用しない場合、「取消」をクリックして元の設定に戻します。
  8. Oracle HTTP Serverを再起動します。Oracle HTTP Serverインスタンスの再起動を参照してください。