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.

Deployment Guidelines

Deployment Guidelines

Note: Before you begin

You should be familiar with the concepts and deployment process used by the Pusher deployment scripts. These are applicable to all deployment scenarios, regardless of whether the Pusher is being used.

General Considerations

These considerations apply to all deployments.

  1. With the exception of Cortex Studio, each Web App should be deployed to a separate application server instance. This simplifies the management, tuning, and monitoring of the Web Apps.
  2. The Cortex Studio Web App should be deployed to the same application server as the Cortex Server to avoid CORS (cross-origin resource sharing) issues. Cortex Studio is normally only deployed to test environments, as it is not required in production environments.
  3. The deployment package contains all artifacts required to deploy Elastic Path Commerce. See Deployment package structure

Clustering and Scaling

  1. The Cortex Server is sessionless and can be scaled horizontally behind a load balancer for availability and throughput.
    • Auto-scaling may be used to handle peak volumes, based on your Elastic Path license conditions.
  2. The Integration Server is also sessionless and can be scaled horizontally for availability.
    • Normally two instances are sufficient unless there are very high order volumes or extensive back-end integration processing.
    • A load balancer is needed only when exposing web services through the Integration Server.
    • An alternative is to run one instance and automatically restart it on failure.
  3. The Search Server depends on Solr Master/Slave architecture. See Search Server Clustering for configuration and management details.
    • The Search Master can be deployed to the same VM as the Commerce Manager Server for small installations, or to a separate VM to handle larger catalogs.
    • Only one Search Master instance can be running at a time. Search Master failure does not impact Cortex availability or back-end integration processing.
    • For Search Slaves, the simplest approach is to deploy a Slave instance to each Cortex node. This works well for smaller installations, but may not scale for a large number of Cortex nodes or for very large catalogs. The overhead of replicating search indexes to multiple slaves needs to be weighed against deployment complexity.
  4. Only one Commerce Manager Server can be running at a time. Customizations are required to run multiple instances.

Configuration

This section describes the major configuration points for deployment. See System Configuration for additional details.

  1. The database connection and JMS broker are defined using JNDI. For examples, see the pusher-package/the-pusher/templates/tomcat-<database>-context.xml files in the devops project.
    • The Commerce Database JDBC data source is defined by the jdbc/epjndi JNDI resource
    • The JMS broker connection is defined by the jms/JMSConnectionFactory JNDI resource.
  2. Application ports are defined using property files. See Configuring Environment Specific Settings.
  3. Cortex is also configured using property files. See Cortex Configuration Files.
  4. Additonal application configuration is contained in the database. See Configuring System Settings.
  5. The default application context paths are:
    Web Application Context Path
    Cortex cortex
    Cortex Studio studio
    Commerce Manager Server cmserver
    Search Server searchserver
    Integration Server integration

Additional JARs

Additonal JARs may need to be deployed to the application server depending on the database and JMS broker being used. These JARs are normally included in the deployment package. By default:
  1. The JDBC driver is packaged in the database/jdbc directory.
  2. Active MQ JARs are packaged in the tools/activemq/lib directory.