Sun Java System Web Server 7.0 Update 2 >> Sun Java System Web Server 7.0 Update 2 CLI Reference Manual >> User Commands >> create-http-listener(1) – creates HTTP listener socket

create-http-listener(1)

NAME | Synopsis | Description | Options | Operands | Examples | Exit Status | See Also

NAME

create-http-listener – creates HTTP listener socket

Synopsis

create-http-listener <connect_options> [--echo|-e] [--no-prompt|-Q] 
[--verbose|-v] [--no-enabled|-n] [--ip|-I address] 
[--acceptor-threads|-a count] [--blocking-io|-b] [--family|-f name] 
[--listen-queue-size|-l size] [--receive-buffer-size|-r size] 
[--send-buffer-size|-B size] [--description|-D text] 
[--handle-protocol-mismatch|-m] --listener-port|-P number 
--config|-c name --server-name|-s name 
--default-virtual-server-name|-d 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, Web Server determines which virtual server to send it to based on the configured HTTP listener.

Options

For connect_options description, see help(1).

--echo|-e

Specify this option to print this command on the standard output before executing. This option also prints the default value for all the non-mandatory options that you do not provide in the command.

--no-prompt|-Q

If you specify this option, wadm will not prompt you for passwords while executing this command. Use this option if you have defined all passwords in a password file and specified the file using the --password-file connect_option.

--verbose|-v

Specify this option to display a verbose output.

--no-enabled|-n

Specify this option if you want to disable the HTTP listener at runtime.

--ip|-I

Specify the IP address of the host machine. Type `*' to set all available IP addresses.

--acceptor-threads|-a

Specify the number of threads dedicated to accept the connections received by this listener. The range of values is 1–128.

--blocking-io|-b

If you specify this option, the HTTP listener socket is in the blocking mode.

--family|-f

Specify the HTTP protocol family.

--listen-queue-size|-l

Specify the size (in bytes) of the operating system listen queue back log. The range of values is 1 - 65536.

--receive-buffer-size|-r

Specify the size (in bytes) of the operating system socket receive buffer. The range of values is 1 - 1048576.

--send-buffer-size|-B

Specify the size (in bytes) of the operating system socket send buffer. The range of values is 1 - 1048576.

--description|-D

Enter a description of the HTTP listener.

--handle-protocol-mismatch
-m

If you specify this option, the server responds to SSL or non-SSL protocol mismatches in client requests with an HTTP redirect or SSL alert. The default is true, meaning the server will attempt to detect SSL or non-SSL protocol mismatches and send an HTTP redirect or SSL alert when a mismatch is detected.

--listener-port|-P

Specify the port number where the configuration binds to and listens for requests. The range of values is 1–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 which do not match a host-pattern.

Operands

listener-name

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

Examples

wadm create-http-listener --user=admin --host=serverhost --password-file=../admin.passwd --port=8989 --ssl=true --no-prompt --rcfile=null --listener-port=18033 --config=config1 --server-name=config1.com --default-virtual-server-name=config1 --enabled=true --ip=* --acceptor-threads=10 --blocking-io=false --listen-queue-size=10 --receive-buffer-size=10 --send-buffer-size=10 --description=HTTP_Listener config1_ls

Exit Status

The following exit values are returned:

0

command executed successfully

>0

error in executing the command

See Also

help(1), set-http-listener-prop(1), list-http-listeners(1), delete-http-listener(1), get-http-listener-prop(1)

NAME | Synopsis | Description | Options | Operands | Examples | Exit Status | See Also