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

User Commands | create-http-listener(1)

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- OPERANDS
- EXAMPLES
- EXIT STATUS
- INTERFACE EQUIVALENT
- 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 ][ --passwordfile filename ][ --secure|-s ]--address address [ --instance instance_name ]--listenerport listener_port --defaultvs virtual_server --servername server_name [ --family family ][ --acceptorthreads acceptor_threads ] [ --blockingenabled blocking_enabled ][ --security enabled security_enabled ] [ --enabled=enabled ]listener_ID`

## DESCRIPTION

> Creates the HTTP listener associated with the named identifier.

## OPTIONS

> --user

>   administrative user associated for the instance.

> --password

>   administrative password corresponding to the administrative user.

> --host

>   host name of the machine hosting the administrative instance.

> --port

>   administrative port number associated with the administrative host.

> --passwordfile

>   file containing passwords appropriate for the command (e.g., administrative instance).

> --secure

>   if true, uses SSL/TLS to communicate with the administrative instance.

> --instance

>   name of the instance.

> --listenerport

>   port number to create the listen socket on. Legal values are 165535. On UNIX, creating sockets that listen on ports 11024 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.

> --family

>   socket family type; defaults to `inet`. Legal values are: `inet`, `inet6`, and `nca`. Use the value `inet6` for IPv6 listen sockets. When using the value of `inet6`, IPv4 addresses are prefixed with ::ffff: in the log file. Specify `nca` to make use of the Solaris Network Cache and Accelerator.

> --acceptorthreads

>   number of acceptor threads for the listen socket. The recommended value is the number of processors in the machine.

> --blockingenabled

>   determines whether the HTTP listener socket and the accepted socket are put into blocking mode. Use of blocking mode may improve benchmark scores.

> --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 in the `init.conf` file globally enables or disables SSL by making certificates available to the server instance. Therefore, security in the `init.conf` file must be ON or security in the `server.xml` file does not work.

> --enabled

>   determines whether the resource is enabled at runtime or not.

## OPERANDS

> listener_id

>   listener ID of the HTTP listener.

## EXAMPLES

> Example 1. Using create-http-listener

> > >     asadmin> create-http-listener --user admin --password adminadmin --host fuyako --port 7070 --address 0.0.0.0 --instance server1 --listenerport 7272 --defaultvs server1 --servername fuyako.red.iplanet.com --family inet6 --acceptorthreads 2 --blockingenabled=true --securityenabled=false --enabled=false sampleListener
> > >     Created HTTP listener with id = sampleListener

> > Where: `sampleListener` is the HTTP listener created.

## EXIT STATUS

> 0

>   command executed successfully

> 1

>   error in executing the command

## INTERFACE EQUIVALENT

> HTTP Server folder, HTTP Listener page

## SEE ALSO

> `delete-http-listener`(1), `list-http-listeners`(1)

Sun Java System Application Server | Go To Top | Last Changed 24 Dec 2003

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.