From: markt Date: Wed, 27 Jul 2011 15:11:35 +0000 (+0000) Subject: Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=48997 X-Git-Url: https://git.internetallee.de/?a=commitdiff_plain;h=f175967d89dcbcd69b805b0b500825d9b6c01033;p=tomcat7.0 Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=48997 Fixed some typos and correct cross-referencing to the HTTP Connector documentation with the SSL How-To page of the documentation web application. git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1151493 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml index 0c45b5c28..788f8502a 100644 --- a/webapps/docs/changelog.xml +++ b/webapps/docs/changelog.xml @@ -142,6 +142,11 @@ configuration page in the documentation web application. (markt) + 48997: Fixed some typos and correct cross-referencing to the + HTTP Connector documentation with the SSL How-To page of the + documentation web application. (markt) + + 49122: Improvements and fixes for index page for ROOT web application. Based on a patch provided by pidster. (markt) diff --git a/webapps/docs/ssl-howto.xml b/webapps/docs/ssl-howto.xml index a9cda5bf0..e8f0c2e7d 100644 --- a/webapps/docs/ssl-howto.xml +++ b/webapps/docs/ssl-howto.xml @@ -47,7 +47,8 @@

To install and configure SSL support on Tomcat, you need to follow these simple steps. For more information, read the rest of this HOW-TO.

    -
  1. Create a certificate keystore by executing the following command: +
  2. Create a certificate keystore file to store the servers private key and +self-signed certificate by executing the following command:

    Windows:

    %JAVA_HOME%\bin\keytool -genkey -alias tomcat -keyalg RSA @@ -370,13 +371,16 @@ file installed with Tomcat. For JSSE, it should look something like this:

    -

    You will note that the Connector element itself is commented out by default, -so you will need to remove the comment tags around it. Then, you can -customize the specified attributes as necessary. For detailed information -about the various options, consult the -Server Configuration Reference. The -following discussion covers only those attributes of most interest when -setting up SSL communication.

    +

    You will note that the example SSL connector elements are commented out by +default. You can either remove the comment tags from around the the example SSL +connector you wish to use or add a new Connector element of your own. In either +case, you will need to configure the SSL Connector for your requirements +and environment. The configuration options and information on which attributes +are mandatory, are documented in the SSL Support section of the +HTTP connector configuration +reference. Make sure that you use the correct attributes for the connector you +are using. The BIO and NIO connectors use JSSE whereas the APR/native connector +uses APR.

    The port attribute (default value is 8443) is the TCP/IP port number on which Tomcat will listen for secure connections. You can @@ -393,22 +397,12 @@ numbers lower than 1024 on many operating systems.

    that SSL is required, as required by the Servlet Specification.

    -

    There are additional options used to configure the SSL protocol. You may -need to add or change some attributes, depending on how you configured your -keystore earlier. If you are using a Java JSSE based SSL connector then -configuration options are documented in the -Java HTTP connector configuration -reference. If you are using the APR/native connector then refer to the -APR connector configuration guide for details of the -available configuration options.

    -

    After completing these configuration changes, you must restart Tomcat as you normally do, and you should be in business. You should be able to access any web application supported by Tomcat via SSL. For example, try:

    https://localhost:8443 -

    and you should see the usual Tomcat splash page (unless you have modified the ROOT web application). If this does not work, the following section contains some troubleshooting tips.

    @@ -477,13 +471,6 @@ SSL communications, and what to do about them.

      -
    • I get "java.security.NoSuchAlgorithmException" errors in my - log files. -
      -

      The JVM cannot find the JSSE JAR files. Follow all of the directions to - download and install JSSE.

      -
      • -
    • When Tomcat starts up, I get an exception like "java.io.FileNotFoundException: {some-directory}/{some-file} not found".
      @@ -518,7 +505,7 @@ SSL communications, and what to do about them.

      enabled."

      A likely explanation is that Tomcat cannot find the alias for the server - key withinthe specified keystore. Check that the correct + key within the specified keystore. Check that the correct keystoreFile and keyAlias are specified in the <Connector> element in the Tomcat configuration file.