3:28 p.m.
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
"<jboss-as>/server/<profile>/deploy/teiid/teiid-cache-manager-jboss-beans-rename-me.xml"
file
+ to
"<jboss-as>/server/<profile>/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