Announcement: You can find the guides for Commerce 7.5 and later on the new Elastic Path Documentation site. This Developer Center contains the guides for Commerce 6.13.0 through 7.4.1.Visit new site

This version of Elastic Path Commerce is no longer supported or maintained. To upgrade to the latest version, contact your Elastic Path representative.

1. Configuring Tomcat 6.0

1. Configuring Tomcat 6.0

Installing a JDBC Driver in Tomcat

  1. Download the JDBC Driver for your chosen database:
    Table 1.
    Database JDBC Driver JAR file
    MySQL 5.6 mysql-connector-java-5.1.25.jar
    MS SQL 2008 sqljdbc.jar
    Oracle 11g ojdbc15-11.1.0.7.0.jar
  2. Install the JDBC Driver JAR file in <Tomcat_HOME>\lib

Installing a JMS Driver in Tomcat

  1. Download the JMS driver for the Commerce Engine's Asynchronous Event Messaging service.
    JMS Driver JAR file Links
    activemq-client-5.8.0.jar http://activemq.apache.org/activemq-580-release.html
    geronimo-j2ee-management_1.1_spec-1.0.1.jar http://mvnrepository.com/artifact/org.apache.geronimo.specs/geronimo-j2ee-management_1.1_spec/1.0.1
    geronimo-jms_1.1_spec-1.1.1.jar http://mvnrepository.com/artifact/org.apache.geronimo.specs/geronimo-jms_1.1_spec/1.1.1
    slf4j-api-1.6.6.jar http://mvnrepository.com/artifact/org.slf4j/slf4j-api/1.6.6
  2. Install the JMS Driver JAR files in 
    <Tomcat_HOME>\lib

Configuring Tomcat's HTTP Connector

  1. With an XML editor, open server.xml, found in <Tomcat_HOME>\conf
  2. In server.xml, replace the Connector element as shown below:
    Before After
    <Tomcat_HOME>\conf\server.xml 
    <Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />

    <Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000" 
redirectPort="8443"
URIEncoding="UTF-8"/commerce-legacy/>

Configuring SSL in Tomcat

  1. Open the Command Prompt and input the following command to begin creating the .keystore file.
    keytool -genkey -alias tomcat -keyalg RSA
  2. Enter in a password (this can be any password you want your keystore encoded with) , full name, organizational unit, organization, city, state, and country code to generate the .keystore file. Configuring SSL in Tomcat (64).png
  3. Copy the generated .keystore file from your home directory and paste the file into <Tomcat_HOME>\conf
  4. With an XML editor, open server.xml, found in <Tomcat_HOME>\conf
  5. In server.xml, replace the Connector element as shown below:
    Before After
    <Tomcat_HOME>\conf\server.xml 
    <!-- 
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
   maxThreads="150" scheme="https" secure="true"
   clientAuth="false" sslProtocol="TLS" />
-->

    <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
		SSLEnabled="true" secure="true" enableLookups="false"
		disableUploadTimeout="true"
		keystoreFile="<Tomcat_HOME>\conf\.keystore"
		keystorePass="PASSWORD"
		acceptCount="100" maxThreads="25" scheme="https"
		clientAuth="false" sslProtocol="TLS"
		URIEncoding="UTF-8"/commerce-legacy/>

    where PASSWORD is the password you entered into the .keystore file and Tomcat_HOME is your Tomcat installation directory.