set-http-prop

Syntax

tadm set-http-prop common_options --config=config_name (property_name=property_value)+

Description

Use this command to set the HTTP properties.

Options

For information about common_options, run the help command.

--config|-c

Specify the name of the configuration to set the HTTP properties.

Operands

property-name=property-value

Specify name=value pairs for one or more properties that you want to define. The name=value pairs should be separated by spaces.

You can set the following HTTP properties:

version: Specifies the highest HTTP protocol version the server supports.
Values: The default HTTP version string is HTTP/1.1

server-header: Specifies the server header information such as server software and version.
Values: The default server header is Oracle-Traffic-Director/11.1.1.6.0.

etag: Indicates if the server includes an Etag header field in its responses.
Values: true, false. Default: true.

request-header-buffer-size: Specifies the size (in bytes) of the buffer used to read HTTP request headers.
Values: 0 to 2147483647

strict-request-headers: Indicates whether the server rejects certain malformed HTTP request headers.
Values: true, false. Default: false.

max-request-headers: Specifies the maximum number of header fields in an HTTP request header.
Values: 1 to 512

output-buffer-size: Specifies the size (in bytes) of the buffer for HTTP responses.
Values: 0 to 2147483647

max-unchunk-size: Specifies the maximum size (in bytes) of a chunked HTTP request body that the server will unchunk.
Values: 0 to 2147483647

unchunk-timeout: Specifies the maximum time (in seconds) that the server waits for a chunked HTTP request body to arrive.
Values: 0 to 3600, or -1 for no timeout. Default: 60

io-timeout: Specifies the maximum time (in seconds) that the server waits for an individual packet.
Values: 0 to 3600, or -1 for no timeout.

request-body-timeout: Specifies the maximum time (in seconds) that the server waits for a complete HTTP request body.
Values: 0 to 604800, or -1 for no timeout.

request-header-timeout: Specifies the maximum time (in seconds) that the server waits for a complete HTTP request header.
Values: 0 to 604800, or -1 for no timeout. Default: 30.

ecid: Specifies whether the server generates, propagates, and logs the execution context. The value of the ECID is a unique identifier that can be used to correlate individual events as being part of the same request execution flow.

For example, events that are identified as being related to a particular request typically have the same ECID value. However, the format of the ECID string itself is determined by an internal mechanism that is subject to change; therefore, you should not have or place any dependencies on that format.
Values: true, false. Default: true

websocket-strict-upgrade: Enables/disables strict adherence to RFC 6455 during a websocket upgrade request. When websocket-strict-upgrade is true, additional rules are checked, as prescribed by the RFC 6455, to ensure that only clients that adhere strictly to RFC 6455 are allowed.
Values: true, false. Default: false.

To reset a property to its default value, do not provide a property value.
For example, property-name=<empty_string>

Example

tadm set-http-prop --user=admin --host=admin.example.com 
--password-file=./admin.passwd --port=8989 
--no-prompt --config=www.example.org 
server-header=OTD-server-header request-header-buffer-size=278

Exit Codes

The following exit values are returned:

0: command executed successfully

>0: error in executing the command

For more information about exit codes and syntax notations, run the help command.

See Also

help, get-http-prop