create-http-listener

Syntax

tadm create-http-listener common_options [--no_enabled] 
[--ip=address] [--acceptor-threads=count] [--blocking-io=true|false] [--handle-protocol-mismatch=true|false][--family=[name] [--listen-queue-size=size] [--receive-buffer-size=size]
[--send-buffer-size=size] [--description=text] --listener-port=number --config=config_name --server-name=server_name --default-virtual-server-name=vs_name 
listener_name

Description

Use this command to create a new HTTP listener socket. All virtual servers have an HTTP listener specified. When a new request comes in, Oracle Traffic Director determines which virtual server to send it to, based on the configured HTTP listener.

Options

For information about common_options, run the help command.

--no-enabled|-n: Specify this option if you want to disable the HTTP listener at runtime.
--ip|-I: Indicates the IP address of the host computer. Specify an asterisk (*) for the HTTP listener to listen to all the available IP addresses on the host computer.
--acceptor-threads|-a: Specify the number of threads dedicated to accept the connections received by this listener. The range of values is 1 to 128.
--blocking-io|-b: If you specify this option, the HTTP listener socket is in the blocking mode.
--handle-protocol-mismatch|-m: If you specify this option, the server responds to Secure Sockets Layer (SSL) or non-SSL protocol mismatches in client requests with an HTTP redirect or SSL alert. The default is true, meaning that the server attempts to detect SSL or non-SSL protocol mismatches and send an HTTP redirect or SSL alert when a mismatch is detected.
--family|-f: Specify the internet protocol family, for example: IPV4, and IPV6. The default is IPv4(family=inet). To use the IPv6 address, specify family=inet6.
--listen-queue-size|-l: Specify the size (in bytes) of the operating system listen queue back log. The range of values is 1 to 65536.
--receive-buffer-size|-r: Specify the size (in bytes) of the operating system socket receive buffer. The range of values is 1 to 1048576.
--send-buffer-size|-B: Specify the size (in bytes) of the operating system socket send buffer. The range of values is 1 to 1048576.
--description|-D: Enter a description of the HTTP listener.
--listener-port|-P: Specify the port number where the configuration binds to and listens for requests. The range of values is 1 to 65535.
--config|-c: Specify the name of the configuration for which you want to create the new HTTP listener socket.
--server-name|-s: Specify the name of the default server.
--default-virtual-server-name|-d: Specify the name of the default virtual server that processes requests that do not match a host-pattern. host-pattern defines a list of hosts to be added to the new virtual server. To specify multiple URLs, separate them by a comma (,).

Operands

listener-name

Specify the name of the HTTP listener that you want to create.

Example

tadm create-http-listener --user=admin --host=admin.example.com 
--password-file=./admin.passwd --port=8989 
--no-prompt  --listener-port=18033 
--config=www.example.org --server-name=config1.com --default-virtual-server-name=config1 
http-listener-1

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.