WebSphere Commerce EnterpriseWebSphere Commerce Professional

Publishing store archives in a clustered environment

This topic applies only to publishing on horizontal cluster members. When WebSphere Commerce is clustered, the WebSphere Application Server deployment manager automatically distributes the WebSphere Commerce EAR file to each node in your cluster, but the store archive files (SARs) must be manually copied to each clustered member. The store publishing process uses local paths to the SAR files, which normally reside in the WC_installdir directory. In a clustered environment, however, the SAR files might need to be accessed from a system other than where WebSphere Commerce was originally installed. Copying the SAR files to every cluster member ensures that the SAR files will be found when needed.

About this task

To publish starter stores in a cluster, copy the stores to each node of your cluster. To ensure that the SAR files are copied from your reference node properly, ensure that the following conditions are met:
  • The SAR files must reside under the same directory on each cluster member. The SAR files reside in the following directory on your reference node: WC_installdir/starterstores
  • SolarisLinuxAIXWindows You must recreate that directory on each node that has a cluster member running the WebSphere Commerce application. The WebSphere Commerce user must have execute (*X) permission to the WC_installdir/starterstores directory on each node that has a cluster member running the WebSphere Commerce application.
  • For IBM i OS operating system You must re-create that directory on each node that has a cluster member running the WebSphere Commerce application. The QEJBSVR user must have execute (*X) permission to the WC_installdir/starterstores directory on each node that has a cluster member running the WebSphere Commerce application.
  • Copy the WC_installdir/starterstores directory to each cluster member.
  • The WebSphere Commerce user must have permission to read the SAR files that reside on each cluster member.
  • After publishing the store, synchronize all cluster members. To synchronize the cluster members, see the Adding, managing, and removing nodes.
  • Restart the cluster for Solr purposes.

If you are using a remote Web server, then update the Web server with a new Stores.war file every time that you publish a new store. The Stores.war is located in the following directory:WC_eardir/Stores.war

Ensure that the path to this file is the same on the Web server node and the WebSphere Commerce node. You must also restart the Web Server each time you update the Stores.war file.

Note: If you are using Microsoft IIS, you must stop and restart all Microsoft IIS-related services and applications. See Microsoft IIS documentation for instructions on how to stop and start these services and servers.
WindowsImportant: Remove any JSP and JAR files from the Stores.war directory on the Web server. On the Web server, only static-content files are in this directory.