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.

Appendix E - Troubleshooting

Appendix E - Troubleshooting



The export or import operation fails and the error log contains this message: java.sql.SQLException: Access denied for user 'root'@'localhost'

Make sure the database is running and that the database connection properties in conf/misc/importexporttool.config are set correctly.

The export or import operation fails and the error log contains a message similar to the following: java.lang.ClassNotFoundException: com.mysql.jdbc.Driver

Make sure the appropriate JDBC library is on the Import-Export tool's class path. Copy the JDBC library used by the Elastic Path web applications to the Import-Export tool's lib directory.

The export or import operation fails and the error log contains ConfigurationException and/or SAXParseException messages.

Make sure that the export or import configuration file contains well formed XML and that it validates against the corresponding schema in the schema directory (schemaExportConfig.xsd or schemaImportConfig.xsd).

The export or import operation fails and the error log contains this message: Connection refused: connect

  • Make sure the database and the Elastic Path search web application are available and the search server URL is correct.
  • If you are attempting to connect to a database and a search server on a remote host (not your local environment) make sure either the COMMERCE/SYSTEM/SEARCH/searchHost setting or the Java system property value is set to the search server URL.

The export operation completes successfully, but the wrong data or no data is exported.

Make sure that the search query in the search configuration file is correct.

The export operation fails and the error log contains the following: EpQLParseException: Cannot parse

There is a syntax error in the search query string. Check the syntax of your query against the syntax described in Appendix D - Query Language.

The export operation completes successfully, but no files are created or the files are in the wrong location.

Verify the package name and delivery target settings in the export configuration file.

The import operation fails because it can't find the data files to be imported.

Verify the retrieval source setting in the import configuration file.

The export operation completes successfully, but the summary report indicates that the total number of objects is 0 and the generated files contain no data.

Make sure that the type of the exporter in the export configuration file matches the export criteria in the search configuration file. If the types do not match, no data will be exported.

A product or category fails to import because the parent catalog does not exist. However, the parent catalog exists in the package.

Make sure that the import strategy for the parent object type is set to use Insert or Insert or Update. For more information, see the section Combining Import Strategies.

The export operation fails and the log contains a message indicating that the currency code could not be found.

This is may be caused by conflicts between the JVM used by Import-Export and the JVM that was used by the Commerce Manager when the data was originally created in Elastic Path. Newer versions of the JVM include currency code updates for several countries and the older currency codes are no longer recognized. To prevent the problem, make sure the Commerce Manager and Import-Export tool are both using the most recent JVM supported by Elastic Path. For more information, see the following:

The import operation fails when a data point is imported with the same GUID but any other different attribute. Verify data in the data_policies.xml file or clean up your database.