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.

Managing Assets

Managing Assets

Application and store assets are located in extensions/assets/.

Application Assets

The following application assets are required to run Commerce Manager.

  • cmassets - Commerce Manager assets, containing velocity templates used in the Commerce Manager.
  • import - Commerce Manager .csv files, (used for importing products, jobs, catalogs, etc)

Store Assets

Store assets are used by the Integration Server. These assets include:

  • themes (Velocity templates and properties used for formatting email messages)

Using Assets Locally

To use local assets for development:

  1. In your settings.xml, configure the ep.local.asset.path property to point to the assets source folder as described in Configure Maven settings.xml.
  2. Re-populate your local database following the Populate the Database instructions. This updates the COMMERCE/STORE/ASSETS/assetLocation setting value in the database.

Deploying Assets for Production

When you build a deployment package using the extensions/packager module, an ext-assets.zip package is included in the the deployment package.

Assets are typically deployed to a local file system directory on each VM running Elastic Path servers. The asset location is specified by the ep.local.asset.path property in the Data Population filtering.properties file. For more information, see Data Population Acccelerator Kit.

Specifying the Asset Path

You can change the asset path by modifying the assetLocation setting in Commerce Manager.

To change assetLocation:
  1. Log on to the Commerce Manager.
  2. Click on Configuration icon, choose System Configuration.
  3. In the Filter, enter COMMERCE/STORE/ASSETS/assetLocation.
  4. In the Setting Name menu, select the assetLocation setting.
  5. Under Defined Values, select the default setting and click the Edit... button.
  6. Under Value, enter your new asset location.
  7. Click Save to apply your changes.