create-http-listener.1


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
OPERANDS
EXAMPLES
EXIT STATUS
SEE ALSO

NAME

create-http-listener - adds a new HTTP listener socket

SYNOPSIS

create-http-listener --user admin_user [ --password admin_password ] [ --host localhost ] [ --port 4848 ] [ --secure|-s ] [ --passwordfile filename ] --listeneraddress address [ --terse=false ] [ --echo=false ] [ --interactive=true ] --listenerport listener_port --defaultvs virtual_server --servername server_name [ --acceptorthreads acceptor_threads ] [ --securityenabled=false ] [ --enabled=true ]listener_ID

DESCRIPTION

Creates the HTTP listener. This command is supported in remote mode only.

OPTIONS

--user: authorized domain application server administrative username.
--password: password to administer the domain application server.
--host: machine name where the domain application server is running.
--port: port number of the domain application server listening for administration requests.
--secure: if true, uses SSL/TLS to communicate with the domain application server.
--passwordfile: file containing the domain application server password.
--terse: indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.
--echo: setting to true will echo the command line statement on the standard output. Default is false.
--interactive: if set to true (default), only the required password options are prompted.
--listeneraddress: IP address of the listener address.
--listenerport: port number to create the listen socket on. Legal values are 1-65535. On UNIX, creating sockets that listen on ports 1-1024 requires superuser privileges. Configuring an SSL listen socket to listen on port 443 is recommended.
--defaultvs: ID attribute of the default virtual server for this particular connection group.
--servername: tells the server what to put in the host name section of any URLs it sends to the client. This affects URLs the server automatically generates; it doesn't affect the URLs for directories and files stored in the server. This name should be the alias name if your server uses an alias. If a colon and port number is appended, that port will be used in URLs that the server sends to the client.
--acceptorthreads: number of acceptor threads for the listen socket. The recommended value is the number of processors in the machine.
--securityenabled: determines whether the HTTP listener runs SSL. You can turn SSL2 or SSL3 ON or OFF and set ciphers using an SSL element. The security setting globally enables or disables SSL by making certificates available to the server instance.
--enabled: determines if the resource is enabled at runtime.

OPERANDS

listener_id: listener ID of the HTTP listener.

EXAMPLES

Example 1. Using create-http-listener

asadmin> create-http-listener --user admin1 --password adminadmin1 
--host pigeon --port 5001 --listeneraddress 0.0.0.0 
--listenerport 7272 --defaultvs server --servername pigeon.red.iplanet.com
--acceptorthreads 2 --securityenabled=false --enabled=false sampleListener
Command create-http-listener executed successfully

Where: sampleListener is the HTTP listener created.

EXIT STATUS

0: command executed successfully
1: error in executing the command