Author: rareddy Date: 2010-09-01 16:28:35 -0400 (Wed, 01 Sep 2010) New Revision: 2517 Added: branches/7.1.x/documentation/admin-guide/src/main/docbook/en-US/content/clustering.xml Modified: branches/7.1.x/documentation/admin-guide/src/main/docbook/en-US/admin_guide.xml Log: TEIID-1104: adding documentation about clustering in Teiid. Modified: branches/7.1.x/documentation/admin-guide/src/main/docbook/en-US/admin_guide.xml =================================================================== --- branches/7.1.x/documentation/admin-guide/src/main/docbook/en-US/admin_guide.xml 2010-09-01 17:53:53 UTC (rev 2516) +++ branches/7.1.x/documentation/admin-guide/src/main/docbook/en-US/admin_guide.xml 2010-09-01 20:28:35 UTC (rev 2517) @@ -49,6 +49,7 @@ <xi:include href="content/vdb-deployment.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="content/security.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="content/logging.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="content/clustering.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="content/admin-console.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="content/adminshell.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> <xi:include href="content/appendix-a.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> Added: branches/7.1.x/documentation/admin-guide/src/main/docbook/en-US/content/clustering.xml =================================================================== --- branches/7.1.x/documentation/admin-guide/src/main/docbook/en-US/content/clustering.xml (rev 0) +++ branches/7.1.x/documentation/admin-guide/src/main/docbook/en-US/content/clustering.xml 2010-09-01 20:28:35 UTC (rev 2517) @@ -0,0 +1,29 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> +<chapter id="clustering"> + <title>Clustering in Teiid</title> + <para>Since Teiid is installed in JBoss AS, there is no separate configuration needed on the part of the user to cluster the Teiid instances. + To cluster JBoss AS instances use these <ulink url="http://www.jboss.org/jbossas/docs/5-x.html">instruction... then Teiid instances + are clustered as well. Just make sure that you installed Teiid in every JBoss AS node before starting the cluster. + There is one specific configuration that needs to be done for enabling the replicated (distributed) cache in Teiid. + To enable distributed cache rename "&lt;jboss-as&gt;/server/&lt;profile&gt;/deploy/teiid/teiid-cache-manager-jboss-beans-rename-me.xml" file + to "&lt;jboss-as&gt;/server/&lt;profile&gt;/deploy/teiid/teiid-cache-manager-jboss-beans.xml". + </para> + + <para> + Typically users create clusters to improve the performance of the system through + <orderedlist> + <listitem> <para>Load Balancing: Take look at the Client developers guide on how to use load balancing between multiple nodes.</para> </listitem> + <listitem> <para>Fail Over: Take look at the Client developers guide on how to use fail over between multiple nodes.</para> </listitem> + <listitem> <para>Distributed Caching: This is automatically done for you once you configure it as specified above. </para> </listitem> + </orderedlist> + </para> + + <para>If would like a clustered deployment of the VDB and data-source artifacts, i.e. deploy artifacts to a central + location and let the system propagate deployments every where, then look into + <ulink url="http://community.jboss.org/wiki/JBossFarmDeployment">JBoss Farm Deployment</ulink>. Note that this only supports hot deployments. + Take look at some commonly asked questions <ulink url="http://community.jboss.org/wiki/JoinTheClusterBeforeUpdatingThe...;. + If you need more fine grained control, you can use script based deployment, where you control the deployment of artifacts into each node, or + JBoss AS "deploy" folder can be configured as a <emphasis>shared</emphasis> folder among all the clustered JBoss AS nodes to achieve farming.</para> + +</chapter> \ No newline at end of file Property changes on: branches/7.1.x/documentation/admin-guide/src/main/docbook/en-US/content/clustering.xml ___________________________________________________________________ Name: svn:mime-type + text/plain