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.

Installing EP for Adobe Marketing Cloud

Installing EP for Adobe Marketing Cloud

This section describes how to build EP for Adobe Marketing Cloud and install it on Adobe Experience Manager.

Prepare the Source Code Directory

Warning: Windows File Path Limitation

Do not checkout your source code to a directory that is greater than 20 characters in length. Windows file paths are limited to 260 characters. The longest file path in the source code is greater than 230 characters so be careful where you deploy your source files.

To create your EP for Adobe Marketing Cloud source code repository:
  1. Create a folder with a short name to house your source code. For example, C:\source
  2. Checkout the EP for Adobe Marketing Cloud from your source repository to your source folder.

Building EP for Adobe Marketing Cloud

To build EP for Adobe Marketing Cloud 6.0:

  • Navigate to source_directory\ep-aem-commerce and run: 
    mvn clean install

To build geometrixx-demo

  • Navigate to source_directory\geometrixx-demo and run: 
    mvn clean install

Deploying EP for Adobe Marketing Cloud Packages

To deploy the built packages to AEM:

  • Navigate to source_directory\ep-aem-commerce and run: 
    mvn clean install -Pdeploy-author

To deploy the built geometrixx-demo package to AEM:

  • Navigate to source_directory\geometrixx-demo and run: 
    mvn clean install -Pdeploy-author
You can set the following maven properties during deploy:
Property Description
aem.author.user The user name used to log in to the AEM instance.
aem.author.password The password used to log in to the AEM instance.
aem.author.host The host of the server to deploy to.
aem.author.port The port of the server to deploy to.
For example, to set the author user name and password:
mvn clean install -Pdeploy-author -Daem.author.user=admin -Daem.author.password=password
Alternately, deploy EP for Adobe Marketing Cloud using the CRX Package Manager GUI:
  1. In AEM, open the Package Manager at http://localhost:4502/crx/packmgr/index.jsp
  2. Install the ep-commerce-api-{version}.zip file, which is located in the source_directory\ep-aem-commerce\deployment-package\target directory.
  3. If you wish to use the Geometrixx demo, also install the ep-geometrixx-content-{version}.zip file located in the source_directory\geometrixx-demo\deployment-package\target directory.

Running EP for Adobe Marketing Cloud

Once EP for Adobe Marketing Cloud successfully deploys, do the following:
  1. Start up Cortex following these instructions.
  2. Open the Geometrixx demo at http://localhost:4502/content/geometrixx-outdoors/en_US.html.