<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip
 laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen ne>
<?Pub Inc>
<refentry id="create-http-listener-1">
<refmeta><refentrytitle>create-http-listener</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="create-http-listener">create-http-listener &mdash;
adds a new HTTP listener socket</primary></indexterm><indexterm><primary sortas="adds a new HTTP listener socket">
adds a new HTTP listener socket &mdash; create-http-listener</primary></indexterm>
<refname>create-http-listener</refname><refpurpose>adds a new HTTP listener
socket</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-http-listener</command>&synopsis-common;
<?Pub Caret1><arg choice="plain">&Dash;&Dash;listeneraddress <replaceable>
address</replaceable></arg><arg choice="plain">&Dash;&Dash;listenerport <replaceable>
listener_port</replaceable></arg><arg choice="plain">&Dash;&Dash;defaultvs <replaceable>
virtual_server</replaceable></arg><arg choice="opt">&Dash;&Dash;servername <replaceable>
server_name</replaceable></arg><arg>&Dash;&Dash;acceptorthreads <replaceable>
1</replaceable></arg><arg>&Dash;&Dash;xpowered=<replaceable>true</replaceable></arg>
<arg>&Dash;&Dash;redirectport <replaceable>redirect_port</replaceable></arg>
<arg>&Dash;&Dash;securityenabled=<replaceable>false</replaceable></arg><arg
choice="opt">&Dash;&Dash;enabled=<replaceable>true</replaceable></arg><arg>&Dash;&Dash;target <replaceable>
server</replaceable></arg><arg choice="plain"><replaceable>listener_id</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>The <command>create-http-listener</command> command creates an HTTP
listener. This command is supported in remote mode only.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="nodash">&Dash;&Dash;listeneraddress</option></term>
<listitem><para>The IP address or the hostname (resolvable by DNS).</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;listenerport</option></term>
<listitem><para>The port number to create the listen socket on. Legal values
are 1&ndash;65535. On UNIX, creating sockets that listen on ports 1&ndash;1024
requires superuser privileges. Configuring an SSL listen socket to listen
on port 443 is recommended.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;defaultvs</option></term>
<listitem><para>The ID attribute of the default virtual server for this listener.
</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;servername</option></term>
<listitem><para>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 are appended, that port will be used in URLs that the server
sends to the client.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;acceptorthreads</option></term>
<listitem><para>The number of acceptor threads for the listen socket. The
recommended value is the number of processors in the machine. The default
value is 1.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;xpowered</option></term>
<listitem><para>If set to <literal>true</literal>, adds the <literal>X-Powered-By:
Servlet/2.4</literal> and <literal>X-Powered-By: JSP/2.0</literal> headers
to the appropriate responses. The Servlet 2.4 specification defines the <literal>
X-Powered-By: Servlet/2.4</literal> header, which containers may add to servlet-generated
responses. Similarly, the JSP 2.0 specification defines the <literal>X-Powered-By:
JSP/2.0</literal> header, which containers may add to responses that use JSP
technology.  The goal of these headers is to aid in gathering statistical
data  about the use of Servlet and JSP technology.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;redirectport</option></term>
<listitem><para>Port number for redirects. If the HTTP listener is supporting
non-SSL requests, and a request is received for which a matching security-constraint
requires SSL transport, the Application Server will automatically redirect
the request to this port number. This option is valid for Enterprise Edition
only.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;securityenabled</option></term>
<listitem><para>If set to true, 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. The default value is false.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;enabled</option></term>
<listitem><para>If set to true, the listener is enabled at runtime.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term>
<listitem><para>&se-ee-only; Specifies the target for which you are creating
the HTTP listener. Valid values are<itemizedlist>
<listitem><para><literal>server</literal>, which creates the listener for
the default server instance <literal>server</literal> and is the default value
</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which creates
the listener for the named configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
listener for every server instance in the cluster</para>
</listitem>
<listitem><para><replaceable>stand-alone_instance_name</replaceable>, which
creates the listener for a particular stand-alone server instance</para>
</listitem>
</itemizedlist></para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&oper-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>listener_id</replaceable></term><listitem>
<para>The listener ID of the HTTP listener.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the create-http-listener command</title>
<para>The following command creates an HTTP listener named <filename>sampleListener
</filename> that uses a nondefault number of acceptor threads and is not enabled
at runtime:</para>
<screen>asadmin> <userinput>create-http-listener --user admin1 
--passwordfile passwords.txt --host host1 --port 4848 
--listeneraddress 0.0.0.0 --listenerport 7272 
--defaultvs server --servername host1.sun.com 
--acceptorthreads 100 --securityenabled=false 
--enabled=false sampleListener</userinput>
Command create-http-listener executed successfully.</screen>
</example>
</refsect1>
<refsect1><title>&exit-tt;</title>
<variablelist termlength="medium">
<varlistentry><term>0</term><listitem><para>command executed successfully
</para>
</listitem></varlistentry>
<varlistentry><term>1</term><listitem><para>error in executing the command
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&also-tt;</title>
<para><link linkend="delete-http-listener-1"><citerefentry><refentrytitle>
delete-http-listener</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="list-http-listeners-1"><citerefentry><refentrytitle>list-http-listeners
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="create-virtual-server-1"><citerefentry>
<refentrytitle>create-virtual-server</refentrytitle><manvolnum>1</manvolnum>
</citerefentry></link>, <link linkend="create-ssl-1"><citerefentry><refentrytitle>
create-ssl</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000008552>
