[jboss-cvs] JBossAS SVN: r92847 - projects/docs/enterprise/5.0/Administration_And_Configuration_Guide/en-US.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Wed Aug 26 20:25:30 EDT 2009
Author: irooskov at redhat.com
Date: 2009-08-26 20:25:30 -0400 (Wed, 26 Aug 2009)
New Revision: 92847
Modified:
projects/docs/enterprise/5.0/Administration_And_Configuration_Guide/en-US/Alternative_DBs.xml
projects/docs/enterprise/5.0/Administration_And_Configuration_Guide/en-US/Pooling.xml
Log:
adding in feedback
Modified: projects/docs/enterprise/5.0/Administration_And_Configuration_Guide/en-US/Alternative_DBs.xml
===================================================================
--- projects/docs/enterprise/5.0/Administration_And_Configuration_Guide/en-US/Alternative_DBs.xml 2009-08-26 20:37:27 UTC (rev 92846)
+++ projects/docs/enterprise/5.0/Administration_And_Configuration_Guide/en-US/Alternative_DBs.xml 2009-08-27 00:25:30 UTC (rev 92847)
@@ -25,6 +25,9 @@
<itemizedlist>
+ <listitem><para>MySQL JDBC drivers can be downloaded from the MySQL web site <ulink url="http://www.mysql.com/products/connector/">http://www.mysql.com/products/connector/</ulink>.</para></listitem>
+ <listitem><para>Postgres JDBC drivers can be downloaded from the Postgres web site <ulink url="http://jdbc.postgresql.org/">http://jdbc.postgresql.org/</ulink>.</para></listitem>
+ <listitem><para>Oracle JDBC drivers can be downloaded from the Oracle web site <ulink url="http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html">http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html </ulink>.</para></listitem>
<listitem><para>IBM DB2 JDBC drivers can be downloaded from the IBM web site <ulink url="http://www-306.ibm.com/software/data/db2/java/">http://www-306.ibm.com/software/data/db2/java/</ulink>.
</para></listitem>
@@ -92,9 +95,9 @@
<section id="Configuring_JDBC_DataSources">
<title>Configuring JDBC DataSources</title>
- <para>
+<!-- <para>
Rather than configuring the connection manager factory related MBeans discussed in the previous section via a mbean services deployment descriptor, JBoss provides a simplified datasource centric descriptor. This is transformed into the standard <literal>jboss-service.xml</literal> MBean services deployment descriptor using a XSL transform applied by the <literal>org.jboss.deployment.XSLSubDeployer</literal> included in the <literal>jboss-jca.sar</literal> deployment. The simplified configuration descriptor is deployed the same as other deployable components. The descriptor must be named using a <literal>*-ds.xml</literal> pattern in order to be recognized by the <literal>XSLSubDeployer</literal>.
- </para>
+ </para> -->
<para>
The schema for the top-level datasource elements of the <literal>*-ds.xml</literal> configuration deployment file is shown in <xref linkend="Configuring_JDBC_DataSources-The_simplified_JCA_DataSource_configuration_descriptor_top_level_schema_elements" />.
</para>
@@ -623,12 +626,12 @@
<para>The JMS service in the JBoss Enterprise Application Platform uses relational databases to persist its messages. For improved performance, we should change the JMS service to take advantage of the external database. To do that, we need to replace the file <literal>{jboss.dist}/server/${server}/deploy/messaging/${database}-persistence-service.xml</literal> with the file <literal>${jboss.dist}/docs/examples/jms/${database}-persistence-service.xml</literal> depending on your external database. Notice that if you are using the <literal>default</literal> server profile, the file path is <literal>{jboss.dist}/server/default/deploy/messaging/${database}-persistence-service.xml</literal>. <!--To do that, we need to replace the file <literal><JBoss_Home>/server/all/deploy/jms-singleton/hsqldb-jdbc2-service.xml</literal> with a file in <literal><JBoss_Home>/docs/examples/jms/</literal> depending on your external database. Notice that if you are using the <literal!
>default</literal> server profile, the file path is <literal><JBoss_Home>/server/default/deploy/jms/hsqldb-jdbc2-service.xml</literal>.--></para>
<itemizedlist>
- <listitem><para>MySQL: <literal>mysql-jdbc2-service.xml</literal></para></listitem>
- <listitem><para>PostgreSQL: <literal>postgres-jdbc2-service.xml</literal></para></listitem>
- <listitem><para>Oracle: <literal>oracle-jdbc2-service.xml</literal></para></listitem>
- <listitem><para>DB2: <literal>db2-jdbc2-service.xml</literal></para></listitem>
- <listitem><para>Sybase: <literal>sybase-jdbc2-service.xml</literal></para></listitem>
- <listitem><para>MS SQL Server: <literal>mssql-jdbc2-service.xml</literal></para></listitem>
+ <listitem><para>MySQL: <literal>mysql-persistence-service.xml</literal></para></listitem>
+ <listitem><para>PostgreSQL: <literal>postgres-persistence-service.xml</literal></para></listitem>
+ <listitem><para>Oracle: <literal>oracle-persistence-service.xml</literal></para></listitem>
+ <listitem><para>DB2: <literal>db2-persistence-service.xml</literal></para></listitem>
+ <listitem><para>Sybase: <literal>sybase-persistence-service.xml</literal></para></listitem>
+ <listitem><para>MS SQL Server: <literal>mssql-persistence-service.xml</literal></para></listitem>
</itemizedlist>
<note>
@@ -737,7 +740,7 @@
To change the JNDI name, just open the <literal>*-ds.xml</literal> file for your external database, and change the value of the <literal>jndi-name</literal> property to <literal>DefaultDS</literal>. For instance, in <literal>mysql-ds.xml</literal>, you'd change MySqlDS to DefaultDS and so on. You will need to remove the <literal><JBoss_Home>/server/all/deploy/hsqldb-ds.xml</literal> file after you are done to avoid duplicated <literal>DefaultDS</literal> definition.
</para>
<para>
- In the <literal>messaging/${database}-persistence-service.xml</literal> file, you should also change the datasource name in the <literal>depends</literal> tag for the <literal>PersistenceManagers</literal> MBean to <literal>DefaultDS</literal>. For instance, for <literal>mysql-jdbc2-service.xml</literal> file, we change the <literal>MySqlDS</literal> to <literal>DefaultDS</literal>.
+ In the <literal>messaging/${database}-persistence-service.xml</literal> file, you should also change the datasource name in the <literal>depends</literal> tag for the <literal>PersistenceManagers</literal> MBean to <literal>DefaultDS</literal>. For instance, for <literal>mysql-persistence-service.xml</literal> file, we change the <literal>MySqlDS</literal> to <literal>DefaultDS</literal>.
</para>
@@ -761,11 +764,13 @@
<listitem><para><literal>${jboss.dist}/server/${server}/conf/standardjbosscmp-jdbc.xml</literal>: This file configures the CMP beans in the EJB container.</para></listitem>
- <listitem><para><literal><JBoss_Home>/server/all/deploy/ejb-deployer.xml</literal>: This file configures the JBoss EJB deployer.</para></listitem>
+<!-- <listitem><para><literal><JBoss_Home>/server/all/deploy/ejb-deployer.xml</literal>: This file configures the JBoss EJB deployer.</para></listitem>
+-->
<listitem><para><literal>${jboss.dist}/server/${server}/deploy/ejb2-timer-service.xml</literal>: This file configures the EJB timer services.</para></listitem>
- <listitem><para><literal>${jboss.dist}/server/${server}/deploy/snmp-adaptor.sar/attributes.xml</literal>: This file is used by the SNMP service.</para></listitem>
+ <!-- <listitem><para><literal>${jboss.dist}/server/${server}/deploy/snmp-adaptor.sar/attributes.xml</literal>: This file is used by the SNMP service.</para></listitem>
+ -->
<listitem><para><literal>${jboss.dist}/server/${server}/deploy/juddi-service.sar/META-INF/jboss-service.xml</literal>: This file configures the UUDI service.</para></listitem>
Modified: projects/docs/enterprise/5.0/Administration_And_Configuration_Guide/en-US/Pooling.xml
===================================================================
--- projects/docs/enterprise/5.0/Administration_And_Configuration_Guide/en-US/Pooling.xml 2009-08-26 20:37:27 UTC (rev 92846)
+++ projects/docs/enterprise/5.0/Administration_And_Configuration_Guide/en-US/Pooling.xml 2009-08-27 00:25:30 UTC (rev 92847)
@@ -7,7 +7,7 @@
<section><title>Strategy</title>
<para>
<indexterm><primary>Pooling</primary><secondary>JBossJCA</secondary></indexterm>
-<ulink url="http://www.jboss.org/wiki/JBossJCA">JBossJCA</ulink> uses a <literal>ManagedConnectionPool</literal> to perform the pooling. The <literal>ManagedConnectionPool</literal> is made up of subpools depending upon the strategy chosen and other pooling parameters.
+ <ulink url="http://www.jboss.org/community/wiki/JBossJCA">JBossJCA</ulink> uses a <literal>ManagedConnectionPool</literal> to perform the pooling. The <literal>ManagedConnectionPool</literal> is made up of subpools depending upon the strategy chosen and other pooling parameters.
</para>
<informaltable frame="all">
@@ -135,8 +135,11 @@
Upto <max-pool-size/> threads can be inside the pool at the same time (or using connections from a pool).
</para>
<para>
-Once this limit is reached, threads wait for the <blocking-timeout-seconds/> to use the pool before throwing a <ulink url="http://www.jboss.org/wiki/WhatDoesTheMessageNoManagedConnectionsAvailableMean">No Managed Connections Available</ulink>
+ Once this limit is reached, threads wait for the <blocking-timeout-seconds/> to use the pool before throwing a <ulink url="http://www.jboss.org/community/wiki/WhatDoesTheMessageNoManagedConnectionsAvailableMean">No Managed Connections Available</ulink>
</para>
+<para>
+You may want to use the <allocation-retry/> and <allocation-retry-wait-millis/> elements to have the pool retry to obtain a connection before throwing the exception.
+</para>
</section>
<section><title>Pool Filling</title>
@@ -211,7 +214,7 @@
<itemizedlist>
<listitem>
-<para><ulink url="http://www.jboss.org/wiki/HowDoIChangeThePoolingParameters">change or flush()</ulink> the pool</para>
+ <para><ulink url="http://www.jboss.org/community/wiki/HowDoIChangeThePoolingParameters">change or flush()</ulink> the pool</para>
</listitem>
<listitem>
<para>closing/undeploying the pool will do a flush first</para>
@@ -221,7 +224,7 @@
</section>
<section><title>Other pooling</title>
-<para><ulink url="http://www.jboss.org/wiki/IWantToPluginACustomThirdpartyDataSource">Thirdparty Pools</ulink> - only if you know what you are doing</para>
+ <para><ulink url="http://www.jboss.org/community/docs/DOC-10020?uniqueTitle=false">Thirdparty Pools</ulink> - only if you know what you are doing</para>
</section>
</section>
More information about the jboss-cvs-commits
mailing list