Announcement: You can find the guides for Commerce 7.5 and later on the new Elastic Path Documentation site. This site 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 Commerce for Adobe Marketing Cloud

In this document

Installing EP Commerce for Adobe Marketing Cloud

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

Prepare the Source Code Directory

To create your EP Commerce for Adobe Marketing Cloud source code repository:
  1. Create a folder to contain your source code.
  2. Clone EP Commerce for Adobe Marketing Cloud from your source repository to your source folder.

Build Source Modules

To build EP Commerce for Adobe Marketing Cloud 6.3:

  • Navigate to the ep-aem-commerce directory and run: 
    1. mvn clean install
    Copy

To build the geometrixx-demo:

  • Navigate to geometrixx-demo directory and run: 
    1. mvn clean install
    Copy

Deploy Packages using Maven

To deploy the built packages to AEM:

  • Navigate to the ep-aem-commerce directory and run: 
    1. mvn clean install -Pdeploy-author
    Copy

To deploy the built geometrixx-demo package to AEM:

  • Navigate to the geometrixx-demo directory and run: 
    1. mvn clean install -Pdeploy-author
    Copy
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:
  1. mvn clean install -Pdeploy-author -Daem.author.user=admin -Daem.author.password=password
Copy

Deploy Packages with the Package Manager

Alternately, you can deploy EP Commerce 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 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 geometrixx-demo/deployment-package/target directory.

Configure Packages

The following configuration steps are required after EP Commerce for Adobe Marketing Cloud packages are installed.

  1. Open the OSGi Configuration Manager at http://localhost:4502/system/console/configMgr.
  2. Add a service mapping for EP authentication:
    1. Select "Apache Sling Service User Mapper Service" and click edit
    2. Click "+" under "Service Mappings"
    3. Paste com.elasticpath.aem.commerce.aem-authentication:epAemUser=oauthservice
    4. Save the changes
  3. Whitelist the EP authentication bundle:
    1. Select "Apache Sling Login Admin Whitelist" and click edit
    2. Paste com.elasticpath.aem.commerce.aem-authentication into the "Whitelist bundles additional" edit box.
    3. Save the changes

Connect to Cortex

Once EP Commerce 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.