Elastic Path Developer Site

Elastic Path CMS Demos Installation For Partners

Installing the EP CMS Demos 6.15.2 (For Partners)

This document is for Elastic Path Partners with access to the Elastic Path Partner Portal. This document describes how to install the Elastic Path Adobe Showcase Britney Broden Demo and the Elastic Path Commerce for Adobe Marketing Cloud Geometrixx Demo.

What are the Elastic Path CMS Demos?

  • Elastic Path Commerce for Adobe Marketing Cloud Demo Servers - Servers for Elastic Path Commerce (Core Commerce and Commerce Manager Client) and the Elastic Path Commerce Integration Platform (Cortex). These servers are the back end e-commerce system that the Showcase and Geometrixx demos connect to.
  • Elastic Path Adobe Showcase Demo - An extensible, configurable framework between EP and Adobe AEM that showcases the best practices in Experience Driven Commerce and responsive design. This demo uses Britney Broden, a fictional high-end women's fashion store, to highlight the flexibility and functionality of AEM and Elastic Path.
  • Elastic Path Commerce for Adobe Marketing Cloud Geometrixx Demo - The out-of-the-box Adobe AEM demo that connects to through Cortex to Elastic Path Core Commerce. This demo uses Geometrixx, a fictional outdoor equipment store, to showcase the deep integration between Elastic Path Commerce and AEM.

Demo Packages

Package Name Zip File Description
Elastic Path Commerce for Adobe Marketing Cloud Demo 6.15 zip (Embedded Demo Server) EP-Commerce-AMC-Demo-6.15.2.zip Contains Elastic Path Commerce (Core Commerce and Commerce Manager Client) and the Elastic Path Commerce Integration Platform (Cortex).
Geometrixx EP Content 1.4 zip ep-geometrixx-content-XXXX.zip Contains Adobe Geometrixx demo code and product data.
Elastic Path Adobe Showcase Demo Elastic-Path-Showcase-Demo-XXX.zip Contains Elastic Path Adobe Showcase demo code and product data.

Software and Hardware Requirements

Running the demos requires the following:
  • User Accounts:
  • Compatible Computer
    • Operating System:
      • Windows 7
      • Windows 8.1
      • Mac OS X 10.9
      • Mac OS X 10.10
    • CPU:
      • Dual Core 2.0 GHz or equivalent processor minimum
      • Quad Core 2.0 GHz or equivalent processor recommended
    • System Memory:
      • 8 GB ram minimum
      • 16 GB ram recommended
    • Disk Space: 10 GB
    • Java 8 installed as default

Installation Steps

Warning: Installation Order

You must install the software in the exact order shown below.

Installing Adobe Experience Manager

Installing Adobe Experience Manager

This section describes how to set up and install AEM 6.1 and the corresponding updates required for EP Commerce for Adobe Marketing Cloud.

Installing Adobe Experience Manager 6.1

Download Adobe Experience Manager 6.1 from Adobe, see Adobe's Download and Start Working instructions, and set up the Adobe Experience Manager 6.1 cq-quickstart-6.1.0.jar with an Author instance following Adobe's Deploying and Maintaining instructions.

Disable ContextHub Shopping Cart

As of the AEM 6.1 release, a bug exists in the ContextHub Shopping Cart so items placed in your cart may disappear. We recommend turning this off.

To disable ContextHub Shopping Cart:
  1. Go to http://localhost:4502/projects.html
  2. Navigate to: Tools -> Operations -> Cloud -> ContextHub -> default -> ContextHub Configuration
  3. Click Edit Shopping Cart.
  4. Disable Cart and then click Next and Save.

Install EP Commerce for Adobe Marketing Cloud Demo Server

The EP Commerce for Adobe Marketing Cloud Demo Server package contains an embedded version of the Elastic Path Commerce Engine, Cortex API, and Commerce Manager Client. The EP Commerce for Adobe Marketing Cloud Demo Server is available on Elastic Path Portal and can be installed following these instructions:
  1. Log on to the Elastic Path Portal and download the Elastic Path Commerce for Adobe Marketing Cloud Demo 6.15 zip (Embedded Demo Server) [EP-Commerce-AMC-Demo-6.15.2.zip]
  2. Open Adobe Package Manager at http://localhost:4502/crx/packmgr/index.jsp.
  3. In Package Manager, click Upload Package and upload the EP-Commerce-AMC-Demo-6.15.2.zip package, which is preconfigured to start EP Commerce for Adobe Marketing Cloud Demo Servers.
  4. In Package Manager, install the EP-Commerce-AMC-Demo-6.15.2.zip, which is preconfigured to start the four EP Commerce for Adobe Marketing Cloud Demo Servers.
    Note: Startup Delay

    It may take a few moments for the servers to start up. Please wait until the four servers (Search, JMS, CMSServer, and Cortex) start up before continuing with the rest of the installation instructions.

EP Commerce for Adobe Marketing Cloud Demo Servers automatically start and stop with AEM restarts.

Install the EP Commerce for Adobe Marketing Cloud Geometrixx Demo

This section describes how to install EP Commerce for Adobe Marketing Cloud Geometrixx demo. The EP Commerce for Adobe Marketing Cloud Geometrixx demo is available on Elastic Path Portal and can be installed following these instructions:
  1. Log on to the Elastic Path Portal and download the following:
    • Geometrixx EP Content 1.4 zip [ep-geometrixx-content-XXXX.zip]
    • Elastic Path Commerce API Integration 1.4 zip[ep-commerce-api-XXXX.zip]
  2. Open the Package Manager at http://localhost:4502/crx/packmgr/index.jsp
  3. In Package Manager, click Upload Package and upload the ep-geometrixx-content-XXXX.zip and the ep-commerce-api-XXXX.zip packages.
  4. In Package Manager, install the packages in this order:
    • ep-commerce-api-XXXX.zip
    • ep-geometrixx-content-XXXX.zip
  5. Open the Geometrixx demo at http://localhost:4502/content/geometrixx-outdoors/en_US.html

Install the EP Adobe Showcase Demo (Britney Broden)

This section describes how to setup and install EP Adobe Showcase demo. This demo is available on Adobe's Package Share and can be installed following these instructions:
  1. Log on to the Elastic Path Portal and download the following:
    • Elastic Path Showcase Demo zip [Elastic-Path-Showcase-Demo-XXX.zip]
    • Elastic Path Commerce API Integration 1.4 zip[ep-commerce-api-XXXX.zip]
  2. Open the Package Manager at http://localhost:4502/crx/packmgr/index.jsp
  3. In Package Manager, click Upload Package and upload the Elastic-Path-Showcase-Demo-XXX.zip and the ep-commerce-api-XXXX.zip packages.
  4. In Package Manager, install the packages in this order:
    • ep-commerce-api-XXXX.zip
    • Elastic-Path-Showcase-Demo-XXX.zip
  5. Open the Showcase demo at http://localhost:4502/content/showcase-demo/en_US.html

Running Commerce Manager Client

To create products, updating pricing, and so on, use the Commerce Manager Client, which was installed to the AEM install folder under this sub-directory: EP-Commerce-Demo\commerce-manager-clients.

To run Commerce Manager Client:

  1. Navigate to EP-Commerce-Demo\commerce-manager-clients.
  2. Unzip the zip file for your supported platform into the current directory:
    • Windows: commercemanager-{version-number}-win32.win32.x86_64.zip
    • Mac: commercemanager-{version-number}-macosx.cocoa.x86_64.zip
  3. Run Commerce Manager:
    • Windows: Double-click Commerce Manager.exe
    • Mac: Double-click Commerce Manager
      Note: Warning Message on Mac

      A warning message may display when opening Commerce Manager for the first time: "Commerce Manager can’t be opened because it is from an unidentified developer." To avoid this error, right-click on Commerce Manager Client and then select open.

  4. When prompted by the application, enter the following credentials:
    • User ID: admin
    • Password: 111111
    • Server URL: http://localhost:38081/cmserver

CMS Demo Installation Troubleshooting

This document outlines some of the common problems you can experience when installing the Elastic Path CMS demos.

Items Disappearing from your Cart

Problem - Items disappear from your cart.

Solution - ContextHub Shopping Cart has a known issue. We recommend disabling ContextHub shopping cart until the issue has been resolved. The instructions above describe how to disable it.

Demos Not Starting

Problem - Demos may fail to start if they are not installed in the exact order shown above.

Solution - Uninstall the demo packages and then reinstall in the proper order. We recommend deleting the crx-quickstart folder and installing the packages again to ensure a fresh install.
  1. Delete the quickstart folder from <aem_install_folder>\author\crx-quickstart
  2. Start cq-quickstart-6.1.0.jar and install the packages following the order shown above.