Elastic Path Developer Site

Elastic Path CMS Demos Installation For Adobe Staff

Installing the EP CMS Demos (For Adobe Staff)

This document is for Adobe Employees with access to Adobe Package Share. This document describes how to install the Elastic Path Demo for AEM.

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 Geometrixx demo connects to.
  • 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 Demo for AEM Elastic-Path-Demo-AEM6.2-v1.zip Contains Elastic Path Demo Servers and Geometrixx Demo.

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
    • Ensure JAVA_HOME Environment Variable is set following the instruction Configure your System Environment Variables

Installation Steps

Installing Adobe Experience Manager

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

Installing Adobe Experience Manager 6.2

Download Adobe Experience Manager 6.2 from Adobe, see Adobe's Getting Started instructions, and set up the Adobe Experience Manager 6.2 cq-quickstart-6.2.0.jar with an Author instance following Adobe's Deploying and Maintaining instructions.

Disable ContextHub Shopping Cart

As of the AEM 6.2 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/etc/cloudsettings/default/contexthub.html
  2. Click Edit Shopping Cart.
  3. Disable Cart and then click Next and Save.

Install Elastic Path Demo for AEM

The Elastic Path Demo for AEM package contains everything needed to demonstrate Elastic Path's Commerce integration with AEM (Geometrixx storefront, embedded version of the Elastic Path Commerce Engine, Cortex API, and Commerce Manager Client. The Elastic Path Demo for AEM Demo Server is available on Adobe's Package Share and can be installed following these instructions:
  1. Open the Package Share at http://localhost:4502/crx/packageshare
  2. Search for and download the following package:
    • Elastic-Path-Demo-AEM6.2-v1.zip
  3. Open the Package Manager at http://localhost:4502/crx/packmgr/index.jsp
  4. In Package Manager, install the Elastic-Path-Demo-AEM6.2-v1.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.

  5. Open the Geometrixx demo at http://localhost:4502/content/geometrixx-outdoors/en_US.html
Elastic Path Demo for AEM Demo Servers automatically start and stop with AEM restarts.

Cortex Studio automatically launches in your default browser when Elastic Path Demo for AEM successfully starts.

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 correctly.

Solution - Uninstall the demo packages and then reinstall. 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.2.0.jar and install the package shown above.