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
- 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 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. --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

## SEE ALSO

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

| Go To Top | Last Changed April 2004

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