Author: smumford Date: 2011-07-25 21:27:26 -0400 (Mon, 25 Jul 2011) New Revision: 14008 Modified: docs/enterprise/trunk/Tuning_Guide/en-US/Book_Info.xml docs/enterprise/trunk/Tuning_Guide/en-US/Revision_History.xml docs/enterprise/trunk/Tuning_Guide/en-US/clustering.xml docs/enterprise/trunk/Tuning_Guide/en-US/jbossweb.xml docs/enterprise/trunk/Tuning_Guide/en-US/jvm.xml docs/enterprise/trunk/Tuning_Guide/publican.cfg Log: Updated old and broken hyperlinks. Modified: docs/enterprise/trunk/Tuning_Guide/en-US/Book_Info.xml =================================================================== --- docs/enterprise/trunk/Tuning_Guide/en-US/Book_Info.xml 2011-07-26 01:16:27 UTC (rev 14007) +++ docs/enterprise/trunk/Tuning_Guide/en-US/Book_Info.xml 2011-07-26 01:27:26 UTC (rev 14008) @@ -4,35 +4,33 @@ %BOOK_ENTITIES; ]> <bookinfo id="book-Tuning_Guide-Tuning_Guide"> - <title>Tuning Guide</title> - <subtitle>A guide to tuning the performance of JBoss Enterprise Portal Platform 4.3.</subtitle> - <edition>1</edition> - <pubsnumber>1.4</pubsnumber> - <productname>JBoss Enterprise Portal Platform</productname> - <productnumber>4.3</productnumber> - <pubdate>Jan, 2009</pubdate> - <isbn>N/A</isbn> - <abstract> - <para> - This Installation Guide documents tuning of JBoss Enterprise Portal Platform - </para> + <title>Tuning Guide</title> + <subtitle>A guide to tuning the performance of JBoss Enterprise Portal Platform 4.3.</subtitle> + <productname>JBoss Enterprise Portal Platform</productname> + <productnumber>4.3</productnumber> + <edition>1</edition> + <pubsnumber>1.5</pubsnumber> + <abstract> + <para> + This Installation Guide documents tuning of JBoss Enterprise Portal Platform. + </para> - </abstract> - <corpauthor> - <inlinemediaobject> - <imageobject> - <imagedata fileref="Common_Content/images/redhat-logo.svg" format="SVG" /> - </imageobject> + </abstract> + <corpauthor> + <inlinemediaobject> + <imageobject> + <imagedata fileref="Common_Content/images/redhat-logo.svg" format="SVG" /> + </imageobject> - </inlinemediaobject> + </inlinemediaobject> - </corpauthor> - <copyright> - <year>&YEAR;</year> - <holder>&HOLDER;</holder> + </corpauthor> + <copyright> + <year>&YEAR;</year> + <holder>&HOLDER;</holder> - </copyright> - <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + </copyright> + <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> </bookinfo> Modified: docs/enterprise/trunk/Tuning_Guide/en-US/Revision_History.xml =================================================================== --- docs/enterprise/trunk/Tuning_Guide/en-US/Revision_History.xml 2011-07-26 01:16:27 UTC (rev 14007) +++ docs/enterprise/trunk/Tuning_Guide/en-US/Revision_History.xml 2011-07-26 01:27:26 UTC (rev 14008) @@ -4,9 +4,23 @@ %BOOK_ENTITIES; ]> <appendix id="appe-Tuning_Guide-Revision_History"> - <title>Revision History</title> - <simpara> - <revhistory> + <title>Revision History</title> + <simpara> + <revhistory> + <revision> + <revnumber>1-1.5</revnumber> + <date>Fri Jul 15 2011</date> + <author> + <firstname>Scott</firstname> + <surname>Mumford</surname> + <email></email> + </author> + <revdescription> + <simplelist> + <member>Updated old and broken hyperlinks.</member> + </simplelist> + </revdescription> + </revision> <revision> <revnumber>1-1.4</revnumber> <date>Fri Apr 08 2011</date> @@ -21,60 +35,60 @@ </simplelist> </revdescription> </revision> - <revision> - <revnumber>1-1.3</revnumber> - <date>Tue Oct 26 2010</date> - <author> - <firstname>Scott</firstname> - <surname>Mumford</surname> - <email&gt;smumford(a)redhat.com&lt;/email&gt; - </author> - <revdescription> - <simplelist> - <member>Rebuilt for new Publican version features.</member> - </simplelist> - </revdescription> - </revision> + <revision> + <revnumber>1-1.3</revnumber> + <date>Tue Oct 26 2010</date> + <author> + <firstname>Scott</firstname> + <surname>Mumford</surname> + <email&gt;smumford(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Rebuilt for new Publican version features.</member> + </simplelist> + </revdescription> + </revision> - <revision> - <revnumber>1-1.2</revnumber> - <date>Thu 21 Oct 2010</date> - <author> - <firstname>Scott</firstname> - <surname>Mumford</surname> - <email&gt;smumford(a)redhat.com&lt;/email&gt; + <revision> + <revnumber>1-1.2</revnumber> + <date>Thu 21 Oct 2010</date> + <author> + <firstname>Scott</firstname> + <surname>Mumford</surname> + <email&gt;smumford(a)redhat.com&lt;/email&gt; - </author> - <revdescription> - <simplelist> - <member>Added syntax highlighting and updated for new Publican version.</member> + </author> + <revdescription> + <simplelist> + <member>Added syntax highlighting and updated for new Publican version.</member> - </simplelist> + </simplelist> - </revdescription> + </revdescription> - </revision> - <revision> - <revnumber>1-1.0</revnumber> - <date>Thu 22 Jan 2009</date> - <author> - <firstname></firstname> - <surname></surname> - <email></email> + </revision> + <revision> + <revnumber>1-1.0</revnumber> + <date>Thu 22 Jan 2009</date> + <author> + <firstname></firstname> + <surname></surname> + <email></email> - </author> - <revdescription> - <simplelist> - <member>Initial creation of book in Publican.</member> + </author> + <revdescription> + <simplelist> + <member>Initial creation of book in Publican.</member> - </simplelist> + </simplelist> - </revdescription> + </revdescription> - </revision> + </revision> - </revhistory> + </revhistory> - </simpara> + </simpara> </appendix> Modified: docs/enterprise/trunk/Tuning_Guide/en-US/clustering.xml =================================================================== --- docs/enterprise/trunk/Tuning_Guide/en-US/clustering.xml 2011-07-26 01:16:27 UTC (rev 14007) +++ docs/enterprise/trunk/Tuning_Guide/en-US/clustering.xml 2011-07-26 01:27:26 UTC (rev 14008) @@ -4,53 +4,53 @@ %BOOK_ENTITIES; ]> <chapter id="chap-Tuning_Guide-Clustering_Tuning"> - <title>Clustering Tuning</title> - <section id="sect-Tuning_Guide-Clustering_Tuning-Enable_Buddy_Replication_for_Portal_and_Portlet_SessionClustering"> - <title> Enable Buddy Replication for Portal and Portlet Session Clustering</title> - <para> - Portal and Portlet Session are merely wrappers around HttpSession so most of HTTP session clustering optimization applies to JBPP as well. EPP uses clustering configuration of JBoss Web so changes go to <filename> jboss-web-cluster.sar/META-INF/jboss-service.xml </filename> . To enable buddy replication, change the value of <emphasis>buddyReplicationEnabled</emphasis> to true. - </para> + <title>Clustering Tuning</title> + <section id="sect-Tuning_Guide-Clustering_Tuning-Enable_Buddy_Replication_for_Portal_and_Portlet_SessionClustering"> + <title> Enable Buddy Replication for Portal and Portlet Session Clustering</title> + <para> + Portal and Portlet Session are merely wrappers around HttpSession so most of HTTP session clustering optimization applies to JBoss Enterprise Portal Platform as well. JBoss Enterprise Portal Platform uses clustering configuration of JBoss Web so changes go to <filename> jboss-web-cluster.sar/META-INF/jboss-service.xml </filename> . To enable buddy replication, change the value of <emphasis>buddyReplicationEnabled</emphasis> to true. + </para> - </section> - - <section id="sect-Tuning_Guide-Clustering_Tuning-Hibernate_and_JBoss_Cache_Configuration"> - <title>Hibernate and JBoss Cache Configuration</title> - <para> - EPP uses JBoss Cache as a second level cache for Hibernate and this configuration is not defined in JBoss Cache definition used for Portal and Portlet Session. Instead the configuration is defined at <filename> jboss-portal-ha.sar/META-INF/jboss-service.xml </filename> - </para> + </section> + + <section id="sect-Tuning_Guide-Clustering_Tuning-Hibernate_and_JBoss_Cache_Configuration"> + <title>Hibernate and JBoss Cache Configuration</title> + <para> + EPP uses JBoss Cache as a second level cache for Hibernate and this configuration is not defined in JBoss Cache definition used for Portal and Portlet Session. Instead the configuration is defined at <filename> jboss-portal-ha.sar/META-INF/jboss-service.xml </filename> + </para> - </section> - - <section id="sect-Tuning_Guide-Clustering_Tuning-Optimistic_Locking_OL"> - <title>Optimistic Locking (OL)</title> - <para> - Our tests have shown that optimistic locking performs better under heavy load and it scales (horizontally) better as well. However, your use case may not show the same behavior and for you pessimistic locking may be a better configuration. To enable optimistic locking, modify TreeCache mbean definition as follows: + </section> + + <section id="sect-Tuning_Guide-Clustering_Tuning-Optimistic_Locking_OL"> + <title>Optimistic Locking (OL)</title> + <para> + Our tests have shown that optimistic locking performs better under heavy load and it scales (horizontally) better as well. However, your use case may not show the same behavior and for you pessimistic locking may be a better configuration. To enable optimistic locking, modify TreeCache mbean definition as follows: <programlisting language="XML" role="XML">&lt;attribute name="NodeLockingScheme"&gt;OPTIMISTIC&lt;/attribute&gt; &lt;attribute name="CacheMode"&gt;INVALIDATION_SYNC&lt;/attribute&gt; </programlisting> - <note> - <para> - If you have not disabled query cache, then you should not use INVALIATION_SYNC as CACHE_MODE. Use REPL_SYNC instead. - </para> + <note> + <para> + If you have not disabled query cache, then you should not use INVALIDATION_SYNC as CACHE_MODE. Use REPL_SYNC instead. + </para> - </note> + </note> - </para> + </para> - </section> - - <section id="sect-Tuning_Guide-Clustering_Tuning-Pessimistic_Locking_PL"> - <title>Pessimistic Locking (PL)</title> - <para> - When using Pessimistic Locking (PL), change isolation level to READ_COMMITTED (RC). Please see <ulink url="http://lists.jboss.org/pipermail/jbosscache-dev/2008-July/00240... /> to see why it is okay to relax the isolation level from REPEATABLE_READ (RR). As expected, RC has better performance than RR. - </para> + </section> + + <section id="sect-Tuning_Guide-Clustering_Tuning-Pessimistic_Locking_PL"> + <title>Pessimistic Locking (PL)</title> + <para> + When using Pessimistic Locking (PL), change isolation level to READ_COMMITTED (RC). Please see <ulink url="http://lists.jboss.org/pipermail/jbosscache-dev/2008-July/00240... /> to see why it is okay to relax the isolation level from REPEATABLE_READ (RR). As expected, RC has better performance than RR. + </para> - </section> - - <section id="sect-Tuning_Guide-Clustering_Tuning-Cache_Eviction_Policy"> - <title>Cache Eviction Policy</title> - <para> - If you disabled lazy loading, then you can control number of objects and time they can reside in memory by configuring EvictionPolicyConfig attribute of TreeCache at <filename> jboss-portal- ha.sar/META-INF/jboss-service.xml </filename> + </section> + + <section id="sect-Tuning_Guide-Clustering_Tuning-Cache_Eviction_Policy"> + <title>Cache Eviction Policy</title> + <para> + If you disabled lazy loading, then you can control number of objects and time they can reside in memory by configuring EvictionPolicyConfig attribute of TreeCache at <filename> jboss-portal- ha.sar/META-INF/jboss-service.xml </filename> <programlisting language="XML" role="XML">&lt;attribute name="EvictionPolicyConfig"&gt; &lt;config&gt; &lt;attribute name="wakeUpIntervalSeconds"&gt;5&lt;/attribute&gt; @@ -59,12 +59,12 @@ &lt;attribute name="timeToLiveSeconds"&gt;1000&lt;/attribute&gt; &lt;/region&gt; &lt;/config&gt; -&lt;/attribute&gt; +&lt;/attribute&gt; </programlisting> - </para> + </para> - </section> + </section> </chapter> Modified: docs/enterprise/trunk/Tuning_Guide/en-US/jbossweb.xml =================================================================== --- docs/enterprise/trunk/Tuning_Guide/en-US/jbossweb.xml 2011-07-26 01:16:27 UTC (rev 14007) +++ docs/enterprise/trunk/Tuning_Guide/en-US/jbossweb.xml 2011-07-26 01:27:26 UTC (rev 14008) @@ -4,32 +4,32 @@ %BOOK_ENTITIES; ]> <chapter id="chap-Tuning_Guide-JBoss_Web_Tuning"> - <title>JBoss Web Tuning</title> - <section id="sect-Tuning_Guide-JBoss_Web_Tuning-_HTTPAJP_connector_threads_"> - <title> HTTP/AJP connector threads </title> - <para> - Increase number of HTTP/AJP connector threads. It's recommended to set this value to <emphasis> 250 * n </emphasis> where n is number of CPU in your server. Depending on nature of your application, this can be set higher or lower. Modify value of maxThreads in in <filename>deploy/jboss-web.deployer/server.xml</filename> + <title>JBoss Web Tuning</title> + <section id="sect-Tuning_Guide-JBoss_Web_Tuning-_HTTPAJP_connector_threads_"> + <title> HTTP/AJP connector threads </title> + <para> + Increase number of HTTP/AJP connector threads. It's recommended to set this value to <emphasis> 250 * n </emphasis> where n is number of CPU in your server. Depending on nature of your application, this can be set higher or lower. Modify value of maxThreads in <filename>deploy/jboss-web.deployer/server.xml</filename> <programlisting language="XML" role="XML">&lt;Connector port="8009" address="${jboss.bind.address}" protocol="AJP/1.3" emptySessionPath="true" enableLookups="false" -redirectPort="8443" maxThreads="1500" /&gt; +redirectPort="8443" maxThreads="1500" /&gt; </programlisting> - </para> + </para> - </section> - - <section id="sect-Tuning_Guide-JBoss_Web_Tuning-_Global_Session_Timeout_"> - <title> Global Session Timeout </title> - <para> - Reduce global session timeout to your need. The default value of 30 min is too high for most use cases. A lower session timeout results into a more consistent memory footprint and more consistent throughput. Modify <filename>deploy/jboss-web.deployer/conf/web.xml</filename> + </section> + + <section id="sect-Tuning_Guide-JBoss_Web_Tuning-_Global_Session_Timeout_"> + <title> Global Session Timeout </title> + <para> + Reduce global session timeout to your need. The default value of 30 min is too high for most use cases. A lower session timeout results into a more consistent memory footprint and more consistent throughput. Modify <filename>deploy/jboss-web.deployer/conf/web.xml</filename> <programlisting language="XML" role="XML">&lt;session-config&gt; &lt;session-timeout&gt;15&lt;/session-timeout&gt; -&lt;/session-config&gt; +&lt;/session-config&gt; </programlisting> - </para> + </para> - </section> + </section> </chapter> Modified: docs/enterprise/trunk/Tuning_Guide/en-US/jvm.xml =================================================================== --- docs/enterprise/trunk/Tuning_Guide/en-US/jvm.xml 2011-07-26 01:16:27 UTC (rev 14007) +++ docs/enterprise/trunk/Tuning_Guide/en-US/jvm.xml 2011-07-26 01:27:26 UTC (rev 14008) @@ -8,7 +8,7 @@ <section id="sect-Tuning_Guide-JVM_Tuning-Use_Large_Pages"> <title>Use Large Pages</title> <para> - When using 64 bit Linux systems , use Linux's large memory page support. Without large page support, increasing heap size may not increase your performance. Modify JAVA_OPTS under <filename>$JBOSS_HOME/bin/run.conf</filename> to add -XX:+ UseLargePages. + When using 64 bit Linux systems, use Linux's large memory page support. Without large page support, increasing heap size may not increase your performance. Modify JAVA_OPTS under <filename>$JBOSS_HOME/bin/run.conf</filename> to add -XX:+ UseLargePages. </para> </section> Modified: docs/enterprise/trunk/Tuning_Guide/publican.cfg =================================================================== --- docs/enterprise/trunk/Tuning_Guide/publican.cfg 2011-07-26 01:16:27 UTC (rev 14007) +++ docs/enterprise/trunk/Tuning_Guide/publican.cfg 2011-07-26 01:27:26 UTC (rev 14008) @@ -5,3 +5,6 @@ xml_lang: en-US brand: JBoss +cvs_branch: DOCS-RHEL-6 +cvs_root: :ext:cvs.devel.redhat.com:/cvs/dist +cvs_pkg: JBoss_Enterprise_Portal_Platform-Tuning_Guide-4.3-web-__LANG__ \ No newline at end of file