この章では、リスナーを作成、表示、変更および削除する方法を説明します。次の項目が含まれます。
Fusion Middleware ControlまたはWLSTのいずれかを使用して、リスナーを作成できます。
始める前に
リスナーの作成を開始する前に、次の項目を決定します。
リスナーの一意の名前。名前は慎重に選択してください。リスナーの作成後に名前を変更することはできません。
リスナーに対する、IPアドレス(またはホスト名)とポート番号の一意の組合せ。
同じIPアドレスと様々なポート番号の組合せ、または単一のポート番号と様々なIPアドレスの組合せを持つ複数のリスナーを定義できます。次のIPアドレスとポート番号の組合せそれぞれが、一意のリスナーと見なされます。
10.10.10.1:80 10.10.10.1:81 10.10.10.2:80 10.10.10.2:81
HTTPリスナーの場合: リスナーのデフォルトの仮想サーバー。
Oracle Traffic Directorは、リクエスト・ヘッダーのHost
値が、リスナーにバインドされている仮想サーバーに指定されたホスト・パターンと一致しない場合、デフォルトの仮想サーバーにリクエストをルーティングします。
仮想サーバーのホスト・パターンの指定の詳細は、「仮想サーバーの作成」を参照してください。
HTTPリスナーの場合: サーバーによって自動的に生成され、クライアントに送信されるURLに含まれるサーバー名。このサーバー名は、仮想ホスト名であるか、またはサーバーで別名が使用されている場合、別名である必要があります。コロンとポート番号がサーバー名に追加されている場合、このポート番号は自動生成されたURLで使用されます。
TCPリスナーの場合: リスナーのTCPプロキシ。
トラフィック・トンネリングを行うためTCPプロキシはTCPリスナーを介してTCPリクエストを処理します。TCPプロキシには複数のTCPリスナーを関連付けることができます。TCPリスナーを関連付け、このページでTCPプロキシの設定を構成します。
TCPプロキシの作成の詳細は、「TCPプロキシの作成」を参照してください。
Fusion Middleware Controlを使用したHTTPリスナーの作成
Fusion Middleware Controlを使用してHTTPリスナーを作成するには、次を実行します。
「Fusion Middleware Controlの表示」の説明に従って、Fusion Middleware Controlにログインします。
ページの左上隅にある「WebLogicドメイン」ボタンをクリックします。
「管理」→「OTD構成」を選択します。
使用可能な構成のリストが表示されます。
HTTPリスナーを作成する構成を選択します。
「共通タスク」ペインの「Traffic Director構成」をクリックします。
「管理」→「リスナー」を選択します。
「共通タスク」ペインで、「HTTPリスナー」の下にある「作成」をクリックします。
新規HTTPリスナー・ウィザードが開始されます。
画面上のプロンプトに従い、前に決定済の詳細(リスナー名、IPアドレス、ポートなど)を使用して、HTTPリスナーの作成を完了します。
注意:
構成で証明書を使用できる場合は、ウィザードの2つ目の画面で「SSL/TLS」チェック・ボックスが使用可能になります。HTTPSリクエストを受信する新しいリクエストが必要な場合は、このチェック・ボックスを選択してSSL/TLSを有効にし、ドロップダウン・リストから適切な証明書を選択します。
HTTPリスナーが作成された後、新規HTTPリスナー・ウィザードの「結果」画面にリスナーの作成が成功したことを示すメッセージが表示されます。
「結果」画面で、「OK」をクリックします。
作成したリスナーの詳細が、「リスナー」ページに表示されます。
Fusion Middleware Controlを使用したTCPリスナーの作成
Fusion Middleware Controlを使用してTCPリスナーを作成するには、次を実行します。
WLSTを使用したリスナーの作成
HTTPリスナーを作成するには、otd_createHttpListener
コマンドを実行します。
たとえば、次のコマンドでは、構成foo
にポート番号が23456
、デフォルト仮想サーバーがbar
であるhttp-listener-1
という名前のHTTPリスナーが作成されます。
props = {} props['configuration'] = 'foo' props['http-listener'] = 'http-listener-1' props['port'] = '23456' props['server-name'] = 'example.com' props['default-virtual-server-name'] = 'bar' otd_createHttpListener(props)
TCPリスナーを作成するには、otd_createTcpListener
コマンドを実行します。
たとえば、次のコマンドでは、構成foo
にポート番号が34567
、TCPプロキシがtcp_proxy-1
であるtcp_listener_1
という名前のTCPリスナーが作成されます。
props = {} props['configuration'] = 'foo' props['tcp-listener'] = 'tcp-listener-1' props['port'] = '34567' props['tcp-proxy-name'] = 'tcp-proxy-1' otd_createTcpListener(props)
詳細は、Oracle Traffic Director WebLogic Scripting Toolコマンド・リファレンスのotd_createHttpListener
およびotd_createTcpListener
コマンドを参照してください。
Fusion Middleware ControlまたはWLSTのいずれかを使用して、HTTPまたはTCPリスナーのリストを表示できます。
Fusion Middleware Controlを使用したリスナーのリストの表示
Fusion Middleware Controlを使用してHTTPまたはTCPリスナーのリストを表示するには、次を実行します。
名前をクリックすると、リスナーのプロパティの詳細を表示できます。
WLSTを使用したリスナーのリストの表示
HTTPリスナー・リストを表示するには、次の例に示すように、otd_listHttpListeners
コマンドを実行します。
props = {} props['configuration'] = 'foo' otd_listHttpListeners(props)
listener-1 listener-2
otd_getHttpListenerProperties
コマンドを実行することで、HTTPリスナーのプロパティの詳細を表示できます。
詳細は、Oracle Traffic Director WebLogic Scripting Toolコマンド・リファレンスのotd_listHttpListeners
およびotd_getHttpListenerProperties
コマンドを参照してください。
TCPリスナー・リストを表示するには、次の例に示すように、otd_listTcpListeners
コマンドを実行します。
props = {} props['configuration'] = 'foo' otd_listTcpListeners(props)
listener-1 listener-2
otd_getTcpListenerProperties
コマンドを実行することで、TCPリスナーのプロパティの詳細を表示できます。
otd_listTcpListeners
およびotd_getTcpListenerProperties
コマンドの詳細は、Oracle Traffic Director WebLogic Scripting Toolコマンド・リファレンスを参照してください。
Fusion Middleware ControlまたはWLSTのいずれかを使用して、リスナーを変更できます。
Fusion Middleware Controlを使用したリスナーの変更
Fusion Middleware Controlを使用してHTTPまたはTCPリスナーを変更するには、次を実行します。
WLSTを使用したリスナーの変更
HTTPリスナーのプロパティを変更するには、otd_setHttpListenerProperties
コマンドを実行します。たとえば、次のコマンドでは、構成foo
内のリスナーhttp-listener-1
の1接続当たりの最大リクエスト数が1024
に変更されます。
props = {} props['configuration'] = 'foo' props['http-listener'] = 'http-listener-1' props['max-requests-per-connection'] = '1024' otd_setHttpListenerProperties(props)
HTTPリスナーのSSL/TLS設定を変更するには、otd_setHttpListenerSslProperties
コマンドを実行します。たとえば、次のコマンドを実行すると、構成foo
のリスナーhttp-listener-1
のTLS 1.0サポートが無効になります。
props = {} props['configuration'] = 'foo' props['http-listener'] = 'http-listener-1' props['tls10'] = 'false' otd_setHttpListenerSslProperties(props)
TCPリスナーのプロパティを変更するには、otd_setTcpListenerProperties
コマンドを実行します。たとえば、次のコマンドでは、構成foo
内のリスナーtcp-listener-1
の1接続当たりの最大リクエスト数が1024
に変更されます。
props = {} props['configuration'] = 'foo' props['tcp-listener'] = 'tcp-listener-1' props['max-requests-per-connection'] = '1024' otd_setTcpListenerProperties(props)
TCPリスナーのSSL/TLS設定を変更するには、otd_setTcpListenerSslProperties
コマンドを実行します。たとえば、次のコマンドを実行すると、構成foo
のリスナーtcp-listener-1
のTLS 1.0サポートが無効になります。
props = {} props['configuration'] = 'foo' props['tcp-listener'] = 'tcp-listener-1' props['tls10'] = 'false' otd_setTcpListenerSslProperties(props)
設定または変更できるプロパティのリストは、Oracle Traffic Director WebLogic Scripting Toolコマンド・リファレンスのotd_setTcpListenerProperties
コマンドを参照してください。
Fusion Middleware ControlまたはWLSTのいずれかを使用して、HTTPまたはTCPリスナーを削除できます。
Fusion Middleware Controlを使用したリスナーの削除
Fusion Middleware Controlを使用してHTTPまたはTCPリスナーを削除するには、次を実行します。
WLSTを使用したリスナーの削除
HTTPリスナーを削除するには、次の例に示すように、otd_deleteHttpListener
コマンドを実行します。
props = {} props['configuration'] = 'foo' props['http-listener'] = 'http-listener-1' otd_deleteHttpListener(props)
TCPリスナーを削除するには、次の例に示すように、otd_deleteTcpListener
コマンドを実行します。
props = {} props['configuration'] = 'foo' props['tcp-listener'] = 'tcp-listener-1' otd_deleteTcpListener(props)
詳細は、Oracle Traffic Director WebLogic Scripting Toolコマンド・リファレンスのotd_deleteHttpListener
およびotd_deleteTcpListener
を参照してください。
Oracle Traffic Directorインスタンスのステータスをチェックする専用のステータス・リスナーを構成できるようになりました。Oracle Traffic Directorのステータスを提供する専用ポートを使用すると、Oracle Traffic Directorがロードされている場合であっても、必ずステータス・リクエストの処理に使用できます。
さらに、そのポートに対してSSL設定を構成することで、ステータス・リスナーを保護できます。
Fusion Middleware ControlまたはWLSTのいずれかを使用して、リスナーを構成できます。
Fusion Middleware Controlを使用してステータス・リスナーを構成するには、次を実行します。
ステータス・リスナーのプロパティを有効化/変更します
ステータス・リスナーを有効化するか、あるいはステータス・リスナーの非SSLプロパティを変更するには、例に示すように、otd_enableStatusListener
コマンドを実行します。
ステータス・リスナーを有効化するには、次のようにします
props = {} props['configuration'] = 'foo' props['port'] = '12345' otd_enableStatusListener(props)
ステータス・リスナーの非SSLプロパティを変更するには、次のようにします
前の例で示したように、有効化されたステータス・リスナーについて考えてみます。これは、ip
およびfamily
の値がそれぞれ*
およびdefault
であることを意味しています。このステータス・リスナーのIPアドレスおよびポートを再構成するには、例に示すように、otd_enableStatusListener
コマンドを実行します。
props = {} props['configuration'] = 'foo' props['ip'] = '127.0.0.1' props['port'] = '2016' otd_enableStatusListener(props)
ステータス・リスナーを無効化します
ステータス・リスナーを無効化するには、例に示すように、otd_disableStatusListener
コマンドを実行します。
props = {} props['configuration'] = 'foo' otd_disableStatusListener(props)
ステータス・リスナーのプロパティを表示します
ステータス・リスナーのプロパティを表示するには、例に示すように、otd_getStatusListenerProperties
コマンドを実行します。
props = {} props['configuration'] = 'foo' otd_getStatusListenerProperties(props)
ステータス・リスナーのSSLプロパティを変更します
ステータス・リスナーのSSLプロパティを変更するには、例に示すように、otd_setStatusListenerSslProperties
コマンドを実行します。
ステータス・リスナーのSSLを無効にするには、enabled
プロパティをfalseに設定します。
props = {} props['configuration'] = 'foo' props['enabled'] = 'false' otd_setStatusListenerSslProperties(props)
ステータス・リスナーのSSLプロパティを表示します
ステータス・リスナーのSSLプロパティを表示するには、例に示すように、otd_getStatusListenerSslProperties
コマンドを実行します。
props = {} props['configuration'] = 'foo' otd_getStatusListenerSslProperties(props)
この項で説明したWLSTコマンドの詳細は、Oracle Traffic Director Oracle Traffic Director WebLogic Scripting Toolコマンド・リファレンスを参照してください