Updating the WebSphere Commerce configuration file

Many aspects of the WebSphere Commerce runtime application are configured in an XML file. This XML file is inside the WebSphere Commerce Java Platform, Enterprise Edition EAR.

The WebSphere Commerce configuration file, wc-server.xml, is located within the following directory:

  • LinuxAIXWindowsFor IBM i OS operating systemWC_eardir/xml/config/
  • WebSphere Commerce Developerworkspace_dir\WC\xml\config\
LinuxAIXWindowsFor IBM i OS operating systemThe Configuration Manager can be used to modify most WebSphere Commerce configuration parameters. However, some parameters must be changed through the WebSphere Commerce configuration file. To determine whether to configure an individual component through the Configuration Manager or through the WebSphere Commerce configuration file, see the documentation for that component.
  • Option B: Edit manually.
    1. Edit the file.

      Modify the master copy of the file per whatever instructions you are following. The master configuration file that is managed by the Configuration Manager can be found at the following location:

      • LinuxAIXWindowsWC_installdir /instances/instance_name/xml/instance_name.xml
      • For IBM i OS operating systemWC_userdir/instances/instance_name/xml/instance_name.xml
    2. Deploy the file to the WebSphere Commerce EAR.

      After manually changing the master configuration file, ensure that you properly deploy it to the WebSphere Commerce Java Platform, Enterprise Edition application that is running on WebSphere Application Server. For detailed steps, see Propagating changes to the WebSphere Commerce configuration file.

Note:
  1. Ensure server1 is started successfully before you modify instance-specific properties in Configuration Manager.
  2. The wc-server.xml file is also updated if you run the setdbtype command to configure the database type that is used with WebSphere Commerce. The file is updated with the newest database information. If you are copying and moving files, you might need to rerun setdbtype to update the database information.
WebSphere Commerce DeveloperFor WebSphere Commerce Developer, there is one option:
  1. Edit the file workspace_dir\WC\xml\config\wc-server.xml
  2. Republish the WebSphere Commerce application.