WebSphere Commerce Version or later

Updating the WebSphere Commerce XML configuration files by using the configMigration utility

Use the configMigration utility to update XML configuration files that were migrated from version 7.0 to version 8.0. The utility upgrades the configuration files while it preserves your customizations.

In a previous migration step, you deployed your customizations from your version 8.0 development environment to your runtime environment by using WCBD. That deployment contained the various XML configuration files that were modified specifically for your customizations. In their current state, those XML files are at the WebSphere Commerce Version 7.0 level. Those XML configuration files must be updated to WebSphere Commerce Version 8.0. The configMigration utility applies all of the version 8.0 XML configuration file changes to your version 7.0 XML configuration files, leaving your customizations in tact.

The configMigration utility updates the following configuration files:

Before you begin

  1. On your WebSphere Commerce Version 8.0 environment, back up the following configuration files:
    • WC_eardir/Content-Server.jar/META-INF/ibm-ejb-jar-bnd.xmi
    • WC_eardir/Stores.war/WEB-INF/web.xml
    • WC_eardir/xml/config/wc-attribute-masking.xml
    • WC_eardir/xml/config/BusinessAuditDataCapture.xml
    • WC_eardir/xml/config/bi/biConfig.xml
    • WC_eardir/xml/config/businessContext.xml
    • WC_eardir/xml/config/com.ibm.commerce.component_name-ext/*

      Where component_name is the name of the component you customized, for example, catalog or member.

    • WC_eardir/xml/config/com.ibm.commerce.order/wc-admin-component.xml
    • WC_eardir/xml/config/payments/edp/groups/default/PaymentMappings.xml
    • WC_eardir/xml/config/payments/edp/groups/default/PaymentMethodConfigurations.xml
    • WC_eardir/xml/config/payments/ppc/plugins/SimpleOffline/SimpleOfflinePlugin.xml
    • WC_eardir/xml/config/payments/ppc/plugins/PaymentSystemPluginMapping.xml
    • WC_eardir/xml/config/wc-post-publish.xml
    • WC_eardir/xml/content-management/wc-membergroup-resource-managers.xml
    • WC_eardir/xml/content-management/wc-resource-containers.xml
    Note: The configMigration utility updates these configuration files in addition to wc-server.xml.
  2. Review the previous list of configuration files to ensure that your customizations are present. If any of the previously listed files do not contain your version 7.0 customizations, retrieve these files from your version 7.0 environment, and then deploy the files to your version 8.0 environment. For more information about how to deploy configuration files, see Deploying Java EE assets for a partial application.


  1. Go to the WC_installdir/bin directory.
  2. Run the following command:
    • Windowsconfig_ant.bat -buildfile WC_installdir/migration/components/common/xmlUpdate/configMigrationTasks.xml -DinstanceName=instanceName
    • AIXLinuxconfig_ant.sh -buildfile WC_installdir/migration/components/common/xmlUpdate/configMigrationTasks.xml -DinstanceName=instanceName
    • For IBM i OS operating systemconfig_ant.sh -buildfile WC_installdir/migration/components/common/xmlUpdate/configMigrationTasks.xml -DinstanceName=instanceName
    The name of your WebSphere Commerce instance, for example, demo.
  3. Review the following log file after the utility completes: