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.

The Pusher - Quick Start - EP for AEM

The Pusher - Quick Start - EP for AEM

Overview

These instructions detail the configuration steps needed to deploy EP Commerce API and Geometrixx Demo store to AEM instances. Note that the deployment is intended for installing EP artifacts on AEM - not AEM itself.

AEM Requirements

  1. AEM Author or Publish instance(s) are installed already. They must be active and responsive during the course of deployment
  2. AEM Author or Publish instance(s) must have the same admin credentials
  3. SSH keys are configured for the deployer account. The account's public key has been added to the authorized_keys file on all AEM Author and Publish servers
  4. Directories for AEM Author or Publish instance(s) must be accessible remotely by the deployer account

Configure the Pusher

All Pusher configurations for a specific environment are located in the corresponding devops/the-pusher/environments/<environment-name> folder.

Configure the EP for AEM bundle properties in pusher.conf.

Property Usage Format and example
installEPForAemPackage Turns the AEM deployment installEPForAemPackage=true
cortexLoadBalancer The URI to the cortex load balancer to be used by AEM instances. cortexLoadBalancer=http://load.balancer.url:12345
aem.admin.user The admin user ID used to login to the AEM author instance. All instances must share the same credentials aem.admin.user=admin
aem.admin.pass The admin password used to login to the AEM author instance. All instances must share the same credentials aem.admin.pass=admin
aemAuthorInstances The AEM author instance URL. For multiple AEM servers, list the URLs separated by a space aemAuthorInstances=10.10.50.1
aemPublishInstances The AEM publish URLs. For multiple AEM servers, list the URLs separated by a space aemPublishInstances=10.10.50.2 10.10.50.3
aemAuthorLocalUsers A local user account that could be used to SSH into the AEM author server and access the AEM directory. For every AEM server listed above, a user must be provided

aemAuthorLocalUsers=rootuser1

aemPublishLocalUsers A local user account that could be used to SSH into the AEM publish servers and access the AEM directory. For every AEM server listed above, a user must be provided aemPublishLocalUsers=rootuser2 rootuser3
aemAuthorFolderPaths The AEM directory on the author server. For every AEM server listed, a path must be specified aemAuthorFolderPaths=/home/rootuser1/aem
aemPublishFolderPaths The AEM directory on the publish servers. For every AEM server listed, a path must be specified aemPublishFolderPaths=/home/rootuser2/aem /home/rootuser3/aem
aemAuthorPort The port on the author server. By default this is 4502. aemAuthorPort=4502
aemPublishPort The port on the publish servers. By default this is 4503. The AEM servers should be configured so that they all listen at the same port aemPublishPort=4503

Execute the Pusher

Follow the instruction on The Pusher - Quick Start to deploy Elastic Path environment and EP artifacts for AEM.

Effectively, this will:

  • Uninstall and delete previous EP Commerce API and Geometrixx Demo bundles across all listed author and publish instances
  • Install new bundles from the deployment package
  • Restart AEM server(s) to take effect