geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Geronimo v2.2 > Add new HTTPS listener
Date Thu, 17 Sep 2009 06:45:03 GMT
<html>
<head>
    <base href="http://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1519/1/1/_/styles/combined.css?spaceKey=GMOxDOC22&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background-color: white" bgcolor="white">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
     <h2><a href="http://cwiki.apache.org/confluence/display/GMOxDOC22/Add+new+HTTPS+listener">Add
new HTTPS listener</a></h2>
     <h4>Page <b>edited</b> by             <a href="http://cwiki.apache.org/confluence/display/~chirunhua@gmail.com">Runhua
Chi</a>
    </h4>
     Update for APR HTTPS configuration
          <div id="versionComment" class="noteMacro" style="display:none; padding: 5px;">
     Update for APR HTTPS configuration<br />
     </div>
          <br/>
     <div class="notificationGreySide">
         <style type='text/css'>/*<![CDATA[*/
table.ScrollbarTable  {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color:
#f0f0f0}
table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}

/*]]>*/</style><div class="Scrollbar"><table class='ScrollbarTable'><tr><td
class='ScrollbarPrevIcon'><a href="/confluence/display/GMOxDOC22/Add+new+HTTP+Listener"><img
border='0' align='middle' src='/confluence/images/icons/back_16.gif' width='16' height='16'></a></td><td
width='33%' class='ScrollbarPrevName'><a href="/confluence/display/GMOxDOC22/Add+new+HTTP+Listener">Add
new HTTP Listener</a>&nbsp;</td><td width='33%' class='ScrollbarParent'><sup><a
href="/confluence/display/GMOxDOC22/Adding+new+listeners"><img border='0' align='middle'
src='/confluence/images/icons/up_16.gif' width='8' height='8'></a></sup><a
href="/confluence/display/GMOxDOC22/Adding+new+listeners">Adding new listeners</a></td><td
width='33%' class='ScrollbarNextName'>&nbsp;</td></tr></table></div>
<p>To add a new HTTPS listener click on the link <b>Tomcat|Jetty BIO|NIO|APR HTTPS
Connector</b>. The following figure illustrates some of the parameters possible for
creating a new Tomcat BIO HTTPS listener. Each parameter has a default value and an explanatory
text. Fill in with your values and click on <b>Save</b>.</p>

<p><img src="/confluence/download/attachments/93387/consoleHTTPSListener.png" align="absmiddle"
border="0" /></p>

<p>The required attributes are explained as followed:</p>
<ul>
	<li><b>uniqueName</b> A name that is different than the name for any other
web connectors in the server (no spaces in the name please).</li>
	<li><b>host</b> The host name or IP to bind to. The normal values are 0.0.0.0
(all interfaces) or localhost (local connections only)</li>
	<li><b>keystoreFile</b> The file that holds the keystore (relative to the
Geronimo install dir)</li>
	<li><b>port</b> The TCP port number on which this Connector will create
a server socket and await incoming connections. Your operating system will allow only one
server application to listen to a particular port number on a particular IP address.</li>
</ul>


<h1><a name="AddnewHTTPSlistener-ForaTomcatAPRHTTPSConnector"></a>For a
Tomcat APR HTTPS Connector</h1>

<p>Starting from v2.2, Geronimo uses <tt>server.xml</tt> to configure Tomcat.
You need to update <tt>server.xml</tt> to use HTTPS Connector with APR enabled.
Use the following code snippet as an example.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
       &lt;Connector name=<span class="code-quote">"TomcatWebSSLConnector"</span>

                   port=<span class="code-quote">"${HTTPSPort + PortOffset}"</span>
                   host=<span class="code-quote">"${ServerHostname}"</span>
                   SSLEnabled=<span class="code-quote">"<span class="code-keyword">true</span>"</span>
                   maxThreads=<span class="code-quote">"150"</span>
                   scheme=<span class="code-quote">"https"</span>
                   secure=<span class="code-quote">"<span class="code-keyword">true</span>"</span>
                   clientAuth=<span class="code-quote">"<span class="code-keyword">false</span>"</span>
                   SSLCertificateFile=<span class="code-quote">"/usr/local/ssl/server.crt"</span>

                   SSLCertificateKeyFile=<span class="code-quote">"/usr/local/ssl/server.pem"</span>
                   sslProtocol=<span class="code-quote">"TLS"</span>
                   executor=<span class="code-quote">"DefaultThreadPool"</span>/&gt;
</pre>
</div></div>

<p>Refer to <a href="http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html" title="SSL
Configuration HOW-TO" rel="nofollow">Tomcat SSL Support</a> for more information
about other attributes.</p>
     </div>
     <div id="commentsSection" class="wiki-content pageSection">
       <div style="float: right;">
            <a href="http://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
       </div>

       <a href="http://cwiki.apache.org/confluence/display/GMOxDOC22/Add+new+HTTPS+listener">View
Online</a>
       |
       <a href="http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=93387&revisedVersion=6&originalVersion=5">View
Change</a>
              |
       <a href="http://cwiki.apache.org/confluence/display/GMOxDOC22/Add+new+HTTPS+listener?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message