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 can 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