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.

Configuring Environment Specific Settings

Configuring Environment Specific Settings

Elastic Path provides two files to configure your web application settings in your deployed .WAR files:

  • ep.properties -> Overwrites the web application settings defined in the Web App's module.properties file.
  • ep.override.properties ->Overwrites the values of any bean running in your Web App.

ep.properties

Using the ep.properties file provides a convenient way to customize your deployed web applications. This section describes how to create the ep.properties file and lists the web application settings this file can override.

To create an ep.properties file:

  1. Create a directory named ep in the following location:
    • Windows: C:\etc\ep
    • Linux: /etc/ep
  2. In ep, create a file named ep.properties.
  3. In ep.properties, define the property values and save your changes.
  4. Restart your server for the changes to take effect.

Configurable ep.properties

Property

Description

Developer default

bundle.environment

Specifies Cortex API work environment. Possible values are dev-bundles or prod-bundles.

dev-bundles

bundle.location

Specifies where Cortex API Resource Extensions are deployed.

${project.build.directory}/extensions

ep.properties Variable Values

Some of the ep.properties values are variables whose values are pre-configured. The following table describes these variables and their values.

Variable

Definition

dev-bundles
  • WEB-INF/bundles
  • /var/elasticpath/rest/bundles
  • /usr/local/elasticpath/rest/bundles
  • /etc/elasticpath/rest/bundles
  • C:/elasticpath/rest/bundles
  • D:/elasticpath/rest/bundles
prod-bundles
  • WEB-INF/bundles
  • ${bundle.location}

ep.override.properties

The ep.override.properties file provides a convenient way to override the values of any bean running in your Web App. This section describes how to create the ep.override.properties file and provides some example of beans you can override.

Warning: Experienced Developers

Only knowledgeable developers should override bean values.

To create an ep.override.properties file:

  1. Create a directory named epin the following location:
    • Windows : C:\etc\ep
    • Linux: /etc/ep
  2. In ep, create a file named ep.override.properties.
  3. In ep.properties, define the property values you want to set and save your changes.
  4. Restart your server for the changes to take effect.

ep.override.properties Syntax

ep.override.properties uses the following syntax:

beanName.propertyName=value

For example, the following settings override OpenJPA's DataCache and RemoteCommitProvider beans:

entityManagerFactory.jpaPropertyMap[openjpa.DataCache]=true
entityManagerFactory.jpaPropertyMap[openjpa.RemoteCommitProvider]=sjvm