set-http-listener-prop

構文

tadm set-http-listener-prop common_options --config=config_name --http-listener=name (property_name=property_alue)+

説明

このコマンドを使用して、HTTPリスナーのプロパティを設定します。

オプション

common_optionsの詳細は、helpコマンドを実行してください。

--config|-c: HTTPリスナーのプロパティを設定する構成の名前を指定します。
--http-listener|-r: HTTPリスナーの名前を指定します。

オペランド

property-name=property-value

定義する1つ以上のプロパティに対してname=valueペアを指定します。name=valueペアは、スペースで区切る必要があります。

HTTPリスナーの次のプロパティを設定できます。

enabled: HTTPリスナーを有効にするかどうかを指定します。
値: true、false。デフォルト: true。

ip: リスニングするIPアドレスを指定します。
値: 有効なIPアドレス、またはすべてのIPアドレスでリスニングする場合はアスタリスク(*)。

port: リスニングするポートを指定します。
値: 有効なポート番号。

acceptor-threads: このリスナーが受信する接続の受入れ専用スレッドの数を指定します。
値: 1 - 128。

注意:

プロパティacceptor-threadsには、値としてauto-tunedを指定できます。auto-tunedは、サーバーが実行時にこのプロパティの値を計算することを示します。

server-name: デフォルトのサーバー名を指定します。クライアントに送信するURLのホスト名セクションに配置する内容をサーバーに指示します。これは、サーバーが自動的に生成するURLに影響しますが、サーバーに格納されているディレクトリおよびファイルのURLには影響しません。サーバーで別名を使用する場合、この名前は別名にする必要があります。コロンとポート番号を追加すると、サーバーがクライアントに送信するURLでそのポートが使用されます。
値: 値には、スキーム(接頭辞http://など)とポート接尾辞(:80など)を含めることができます。

blocking-io: サーバーでブロッキングI/Oを使用するかどうかを示します。このオプションを指定すると、HTTPリスナー・ソケットがブロッキング・モードになります。
値: true、false。デフォルト: false。

handle-protocol-mismatch: サーバーでクライアント・リクエストのSSLまたは非SSLプロトコルの不一致に応答するかどうかを示します。デフォルト値はtrueです。つまり、サーバーは、SSLまたは非SSLプロトコルの不一致を検出しようとし、不一致が検出されるとHTTPリダイレクトまたはSSLアラートを送信します。
値: true、false。デフォルト: true。

family: オリジン・サーバーに接続するために使用するソケット・ファミリを指定します。
値: inet、inet6およびinet-sdp。inetおよびinet6の値は、それぞれIPV4プロトコルとIPV6プロトコルを表します。inet-sdpの値は、Sockets Direct Protocol (SDP)で使用されます。デフォルト: inet。

注意:

プロパティfamilyには、値としてdefaultを指定できます。defaultは、サーバーが実行時にこのプロパティの値を計算することを示します。

listen-queue-size: リスニング・キューのサイズ(バイト単位)を指定します。
値: 1 - 1048576。

receive-buffer-size: オペレーティング・システムのソケット受信バッファのサイズ(バイト単位)を指定します。
値: 0 - 2147483647。

send-buffer-size: オペレーティング・システムのソケット送信バッファのサイズ(バイト単位)を指定します。
値: 0 - 2147483647。

default-virtual-server-name: ホストに一致しないリクエストを処理する仮想サーバーの名前を指定します。
値: virtual server要素からname値を取得。

description: HTTPリスナーの説明を指定します。
値: テキスト文字列。

max-requests-per-connection: キープ・アライブ接続が閉じられるまでにHTTP接続ごとに処理されるキープアライブ・リクエストの最大数。0は、制限がないことを示します。

値: 任意の正の整数。デフォルトは0です。

プロパティをデフォルト値にリセットするには、プロパティ値を指定しないでください。
例: property-name=<empty_string>

例

tadm set-http-listener-prop --user=admin --host=admin.example.com --password-file=./admin.passwd --port=8989  
--no-prompt --config=www.example.org --http-listener=http_listen1 
IP=192.19.1.10 port=1895

終了コード

次の終了値が戻されます。

0: コマンドの実行に成功しました。

>0: コマンドの実行時にエラーが発生しました。

終了コードと構文表記の詳細は、helpコマンドを実行してください。