Ask a Question

Advanced Search

Solution ID : SO25670

Last Modified : 05/22/2018

Installation Instructions for Apache Tomcat

Solution

This document provides instructions for installing an SSL certificate on Tomcat using the PKCS#7 formatted certificate.
 
Step 1:  Download the SSL certificate
  1. Download your certificate from the unique secure link we provide your technical contact via order fulfillment email.
  2. The ZIP file you download contain the SSL and Intermediate CA certificate in PKCS#7 file (i.e. ssl_certificate.p7b).
  3. Unzip the files onto the server where you will install the certificate.
     
Step 2: Import the SSL certificate into the keystore
  1. At the command prompt, enter:
     
    keytool -import -alias your_alias_name -trustcacerts -file ssl_certificate.p7b -keystore your_keystore_filename


    NOTE: The alias name and keystore name in this command must be the same as the alias name and keystore name used during the generation of the private key and certificate signing request (CSR). During the import you might encounter the following error: Error: "java.lang.Exception: Input not an X.509 certificate." To troubleshoot this error, refer to solution: SO8159.

If you are unable to use these instructions for your server, GeoTrust recommends that you contact either the vendor of your software or an organization that supports Tomcat. 
 
Step 3: Confirm contents of the keystore
  1. At the command prompt, enter:
     
    keytool -list -v -keystore  your_keystore_filename >output_filename


    For Example:

     
  2. View the contents of the keystore.



    Verify the following information:

    The end entity certificate is imported into the alias with the "Entry Type" of PrivateKeyEntry or KeyEntry.  If not, import the certificate into the Private Key alias.

    NOTE: The Certificate chain length: tells you the keystore was successful in establishing the certificate chain, and your keystore is ready for use.
 
Step 4: Configure Tomcat Server

Once the certificates are imported into the keystore, configure your server.xml to enable SSL. Refer to solution: SO26512.


Step 5: Verify certificate installation

To verify if your certificate is installed correctly, use the GeoTrust Installation Checker


Tomcat
 
For more information, see Tomcat Support website.