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.

Oracle Weblogic 11g

Oracle Weblogic 11g

This section explains how to deploy Elastic Path web applications on a Weblogic production server.

Note: Before you begin

Make sure that:

  • You have synchronized the date and time of all application servers with the date and time of your database server.

Installing Java Advanced Imaging

If you are using Storefront, you must install Java Advanced Imaging into your production server's JDK as detailed below:

  1. Go to:
  2. Download and unzip
  3. Copy the contents of JAI_HOME\lib to your Java_HOME\jre\lib\ext directory.

Preparing the Weblogic Domain

Creating the Domain

  1. Start the WebLogic Configuration Wizard.
    • On Windows, from the Start menu, choose All Programs -> Oracle Weblogic -> Quickstart and select Getting Started with Weblogic Server 10.3.
    • On Linux, launch <WEBLOGIC_HOME>/wlserver_10.3/common/bin/
      Note: GUI Configuration Note

      You must have an X server configured to use the GUI configuration tool.

  2. Select Create a new WebLogic domain and click Next.
  3. Select Generate a domain configured automatically to support the following Products and click Next.
  4. Enter a domain name and click Next.
  5. Enter a user name and password for the WebLogic administrator account and click Next.
  6. Select Sun SDK 1.7 in the Available JDKs list or select Other JDK and specify the Java Development Kit with Java Advanced Imaging installed.
  7. Make sure Production Mode is selected and click Next.
  8. Click Next without selecting any optional configurations.
  9. Review the Configuration Summary and click Create. WebLogic creates the domain in the <WEBLOGIC_HOME>/user_projects/domains directory.
  10. Click Done.

Installing a JDBC Driver

  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-
  2. Place the JDBC Driver JAR file in <DOMAIN_HOME>/lib

Configuring Startup Scripts

  • On Windows, open <DOMAIN_HOME>\bin\setDomainEnv.cmdwith a text editor and add the following:
    set JAVA_OPTIONS=%JAVA_OPTIONS% -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0
    set USER_MEM_ARGS=-Xms256m -Xmx1536m -XX:MaxPermSize=512m
    set EXTRA_JAVA_PROPERTIES=%EXTRA_JAVA_PROPERTIES% -Dsun.lang.ClassLoader.allowArraySyntax=true
  • On Linux, open <DOMAIN_HOME>/bin/setDomainEnv.shwith a text editor and add the following:
    JAVA_OPTIONS="${JAVA_OPTIONS} -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0"
    export JAVA_OPTIONS
    USER_MEM_ARGS=-Xms256m -Xmx1536m -XX:MaxPermSize=512m
    export USER_MEM_ARGS
    EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -Dsun.lang.ClassLoader.allowArraySyntax=true

Extracting the Application Archives

The Elastic Path web applications need direct access to the file system, which means that they must be deployed in exploded form.

  1. In <DOMAIN_HOME>, create a directory (ie. EPWARs) for deploying Elastic Path WAR files.
  2. For each web application you want to deploy:
    1. Create a subdirectory inside the directory you just created. Name these subdirectories after the web application. (ie. storefront)
    2. Copy the web application's WAR file into your new subdirectory.
    3. In the command prompt, navigate to your subdirectory.
    4. Enter the following command to extract the WAR file's contents:
      jar -xvf storefront.war

Configuring the Weblogic Domain

  1. Start WebLogic Server from the command prompt.
    • On Windows, launch <DOMAIN_HOME>\startWebLogic.cmd.
    • On Linux, launch <DOMAIN_HOME>/
  2. In a web browser, go to http://localhost:7001/console. This opens the Weblogic Administration Console.
  3. Log in using your domain's username and password.
  4. In the WebLogic Administration Console, under Change Center, click Lock & Edit.

Configuring SSL

  1. In the Domain Structure tree, expand the Elastic Path domain and click Environment -> Servers.
  2. In the Servers list, click AdminServer(admin).
  3. In Configuration -> General, select SSL Listen Port Enabled.
  4. Click Save.

Configuring the JNDI data source

  1. In the Domain Structure tree, expand the Elastic Path domain and select Services -> JDBC -> Data Sources.
  2. In the Summary of JDBC Data Sources pane, under Data Sources, click New.
  3. In the JDBC Data Source Properties page, enter the following information and click Next:
    Table 2.
    Name Property
    Name jdbc/epjndi
    JNDI Name jdbc/epjndi
    Database Type Select your database platform (Oracle, MySQL, MS SQL Server).
    Database Driver Select the database driver name. (See the table below)
    Table 3.
    Database Property
    MySQL 5.6 MySQL's Driver (Type 4) Versions:using com.mysql.jdbc.Driver
    MS SQL 2008 Microsoft's MS SQL Server Driver (Type 4) Versions:2005
    Oracle 11g Select your database platform (Oracle, MySQL, MS SQL Server).
  4. In the Transaction Options page, click Next.
  5. In the Connection Properties page, enter your database connection information and click Next.
    Note: MySQL Database Note

    If you are using a MySQL Database, enter the following Properties under the Properties box in the Test Database Connection page:

    In the Test Database Connection page, click Test Configuration. If your connection information is correct, you will see a success message.WeblogicTestSuccessful.png
  6. Click Next.
  7. In the Select Targets page, select AdminServer and click Next.
  8. Click Finish.

Deploying Path Web Applications

  1. In the Domain Structure tree, expand the Elastic Path domain and click Deployments.
  2. Do the following for each Elastic Path web application you want to deploy:
    1. In the Summary of Deployments pane, click Install.
    2. Locate the directory where you extracted the war files. Click the radio button next to the subdirectory name and click Next.
    3. Select Install this deployment as an application and click Next.
    4. In the Optional Settings page, under Source accessibility, select the I will make the deployment accessible from the following location option. Then click Finish.
    Note: Deploy the Search Server to use Cortex Search

    You must have the search server deployed and running to use Cortex API's search functionality.

  3. When you are done, click Activate Changes under Change Center.
    Note: Restart WebLogic

    You may need to restart your WebLogic server before the new settings take effect.