ZK Installation Guide/Setting up Servers/WebLogic Cluster

Before You Start

You have to configure the following setting for ZK and Weblogic.

zk.xml

• Turn on Serializable UI Factory for ZK, please refer to this documentation.

<zk>
	<system-config>
		<ui-factory-class>org.zkoss.zk.ui.http.SerializableUiFactory</ui-factory-class>
	</system-config>
</zk>

Turn on ClusterSessionPath for WebLogic

[Since 5.0.8]

WebLogic clustering server and GAE (Google App Engine) minimize the synchronization of the session states by assuming nothing changed, if no session attribute has been modified in a HTTP request. Thus, you have to specify the following configuration in WEB-INF/zk.xml to enforce the server to synchronize the states for each Ajax request.

<zk>
	<listener>
		<listener-class>org.zkoss.zkplus.cluster.ClusterSessionPatch</listener-class>
	</listener>
</zk>

---

Under the hub: ClusterSessionPatch is an ExecutionCleanup listener that updates an session attribute holding Session for each request.

weblogic.xml

• Add a weblogic.xml under XXX/WEB-INF folder(XXX is like ZKsandbox in the war file)

For example,

<!DOCTYPE weblogic-web-app PUBLIC "-//BEA Systems, Inc.//DTD Web Application 8.1//EN"
 "http://www.bea.com/servers/wls810/dtd/weblogic810-web-jar.dtd">

<weblogic-web-app>
  <session-descriptor>
    <session-param>
      <param-name>PersistentStoreType</param-name>
      <param-value>replicated</param-value>
    </session-param>
  </session-descriptor>
</weblogic-web-app>

As mentioned in Weblogic's document

replicated — Same as memory, but session data is replicated across the clustered servers.

Setting up Weblogic Clusters

After those things done above, please follow the official document to set up a Weblogic Cluster Server here.

Version History

Version	Date	Content
5.0.8	June 2011	Add ClusterSessionPatch listener to zk.xml for enforce Weblogic to write session.