 |
|
|
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 |
|
Creates the HTTP listener associated with the named identifier.
|
|
- --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.
|
|
-
listener_id
- listener ID of the HTTP listener.
|
| 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.
|
|
|
- 0
- command executed successfully
- 1
- error in executing the command
|
Company Info
|
Contact
|
Copyright 2003 Sun Microsystems, Inc. All rights reserved.
Use is subject to license terms.
|