[teiid-commits] teiid SVN: r2517 - in branches/7.1.x/documentation/admin-guide/src/main/docbook/en-US: content and 1 other directory.

[teiid-commits at lists.jboss.org]

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">instructions</ulink> 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/JoinTheClusterBeforeUpdatingTheFarmDirectory">here</ulink>. 
+   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