Publishing store archives in a clustered environment
When clustering WebSphere Commerce, the WAS deployment manager automatically distributes the WebSphere Commerce EAR file to each node in your cluster. All file assets that are required for the WebSphere Commerce application to run are included in that EAR file. However, since the Store Archive files (SARs) contain content that may be added to the WebSphere Commerce EAR file, they are not included in the WebSphere Commerce enterprise application EAR file. This section applies only to publishing on horizontal cluster members.
If you wish to publish the 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 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
- AIX|Linux|Solaris|Windows:
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.
- I5/OS:
You must recreate 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, refer to the WebSphere Application Server information center:
- AIX|Linux|Solaris|Windows:
- I5/OS:
If you are using a remote Web server, then update the Web server machine 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.
If you are using Microsoft IIS, 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.
Windows:
Remove any JSP and JAR files from the Stores.war directory on the Web server. Only static-content files should be in this directory on the Web server.
Related Concepts
WAS ND clustering mechanism
Related tasks
Cluster with vertical cluster members
Cluster with horizontal cluster members
Prepare additional nodes
Create the WebSphere Commerce cluster
Define the JDBC driver path
Add additional cluster members
Start or stopping a WebSphere Commerce cluster
Remove a cluster member