User: d_jencks
  Date: 01/09/20 19:20:17

  Modified:    src/xdocs jdbc-database.xml resource.xml
  Log:
  Updated jdbc-database for 2.4 and added examples to resource
  
  Revision  Changes    Path
  1.3       +50 -24    manual/src/xdocs/jdbc-database.xml
  
  Index: jdbc-database.xml
  ===================================================================
  RCS file: /cvsroot/jboss/manual/src/xdocs/jdbc-database.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- jdbc-database.xml 2001/09/14 10:05:12     1.2
  +++ jdbc-database.xml 2001/09/21 02:20:17     1.3
  @@ -1,7 +1,6 @@
   <?xml version="1.0" encoding="UTF-8"?>
  +<!-- $Id: jdbc-database.xml,v 1.3 2001/09/21 02:20:17 d_jencks Exp $ -->
   
  -<!-- $Id: jdbc-database.xml,v 1.2 2001/09/14 10:05:12 gropi Exp $ -->
  -
   <section>
   
       <title>Introduction</title>
  @@ -78,7 +77,7 @@
        <para>
            The mappings we have tested extensively include PostgreSQL,
            InstantDB, Hypersonic SQL, Oracle 7, Oracle 8, Sybase, DB2, and
  -         InterBase. Additional contributed mappings include PointBase, SOLID,
  +         InterBase/Firebird. Additional contributed mappings include PointBase, 
SOLID,
            mySQL, MS SQL Server and DB2/400. If you would like to support CMP
            for another DBMS, or have a working mapping to share, please contact
            the JBoss Mailing List.
  @@ -439,8 +438,8 @@
                <listitem>
   
                    <para>
  -                     Distributed transactions, in which multiple clients
  -                     (servlets, EJBs, ...) participate in the same
  +                     Distributed transactions, in which more than one resource 
managers 
  +                        such as databases participate in the same
                        transaction. This is done through the interfaces
                        <filename>javax.sql.XADataSource</filename> and
                        <filename>javax.sql.XAConnection</filename>.
  @@ -571,13 +570,13 @@
   
            <figure id="minerva-configuration-example">
   
  -             <title>Pool configuration MBean example</title>
  +             <title>Pool configuration MBean example for jboss 2.4</title>
   
                <programlisting>
                    <![CDATA[
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=DefaultDS">
    <attribute name="PoolName">DefaultDS</attribute>
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4, see note for proper class for JBoss 2.2.2]
    <attribute name="Properties"></attribute>
    <attribute name="URL">jdbc:HypersonicSQL:hsql://localhost:1476</attribute>
    <attribute name="GCMinIdleTime">1200000</attribute>
  @@ -588,6 +587,7 @@
    <attribute name="InvalidateOnError">false</attribute>
    <attribute name="TimestampUsed">false</attribute>
    <attribute name="Blocking">true</attribute>
  + <attribute name="BlockingTimeout">60000</attribute>[JBoss 2.4]
    <attribute name="GCInterval">120000</attribute>
    <attribute name="IdleTimeout">1800000</attribute>
    <attribute name="IdleTimeoutEnabled">false</attribute>
  @@ -603,6 +603,10 @@
   
        </para>
   
  +        <para>
  +            Important note for JBoss 2.2.2: the DataSourceClass should be 
org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl.
  +        </para>
  +
        <para>
            Note that the <literal>PoolName</literal> attribute defines the JNDI
            name under which this DataSource is going to be bound in the
  @@ -628,7 +632,7 @@
                    <![CDATA[
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=OracleDB">
    <attribute name="PoolName">OracleDB</attribute>
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
    <attribute name="URL">jdbc:oracle:thin:@serverhostname:1521:ORCL</attribute>
    <attribute name="JDBCUser">scott</attribute>
    <attribute name="Password">tiger</attribute>
  @@ -700,8 +704,7 @@
                            <entry>DataSourceClass</entry>
   
                            <entry>
  -                             The name of the Java class implementing the
  -                             Minerva pool.
  +                                The name of the Java class implementing the 
javax.sql.XADataSource interface.  Normally for non-xa drivers this will be the 
wrapper class org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl (JBoss 2.4) or 
org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl (JBoss 2.2.2).
                            </entry>
   
                            <entry/>
  @@ -793,7 +796,7 @@
                                pool connections that have been in use for a
                                long period of time, a process called garbage
                                collection and controlled by the
  -                             <literal>GCEnabled</literal> attribute.
  +                             <literal>GCEnabled</literal> attribute. Note that 
GCEnabled must also be true for idle timeout to occur. Note also that the usual use of 
this setting is to remove connections from the pool that the database is about to 
disconnect due to inactivity.
                            </entry>
   
                            <entry>false</entry>
  @@ -810,7 +813,7 @@
                                eliminated during the pool shrinkage process.
                                It has no effect if shrinkage is not enabled
                                through the
  -                             <literal>IdleTimeoutEnabled</literal> attribute.
  +                             <literal>IdleTimeoutEnabled</literal> and 
<literal>GCEnabled</literal> attributes.
                            </entry>
   
                            <entry>1800000 (30 minutes)</entry>
  @@ -910,6 +913,18 @@
   
                        <row>
   
  +                         <entry>BlockingTimeout[JBoss 2.4]</entry>
  +
  +                         <entry>
  +                             The number of milliseconds a request will block before 
throwing an exception.  Only has an effect if <literal>Blocking</literal> is set to 
true.
  +                         </entry>
  +
  +                         <entry>60000</entry>
  +
  +                     </row>
  +
  +                     <row>
  +
                            <entry>GCEnabled</entry>
   
                            <entry>
  @@ -929,7 +944,7 @@
                                different one than closing connections that have
                                been idle for a long period of time, a process
                                called shrinkage and controlled by the
  -                             <literal>IdleTimeoutEnabled</literal> attribute.
  +                             <literal>IdleTimeoutEnabled</literal> attribute.  
However, in order for <literal>IdleTimeoutEnabled</literal> set to true to have any 
effect, <entry>GCEnabled</entry> must be true also.
                            </entry>
   
                            <entry>false</entry>
  @@ -1103,7 +1118,8 @@
                                                        <programlisting><![CDATA[ 
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=OracleDB">
     <attribute name="PoolName">OracleDB</attribute>
  -  <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  +  <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  +  <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
     <attribute name="URL">jdbc:oracle:thin:@host.domain.com:1521:instance</attribute>
     <attribute name="JDBCUser">scott</attribute>
     <attribute name="Password">tiger</attribute>
  @@ -1141,7 +1157,8 @@
                                                        <programlisting><![CDATA[ 
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=OracleDB">
    <attribute name="PoolName">OracleDB</attribute>
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  +  <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  + <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
    <attribute name="URL">jdbc:oracle:thin:@host.domain.com:1521:instance</attribute>
    <attribute name="JDBCUser">scott</attribute>
    <attribute name="Password">tiger</attribute>
  @@ -1174,7 +1191,8 @@
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=Hypersonic">   
    <attribute name="PoolName">HypersonicDS</attribute> 
    <attribute name="URL">jdbc:HypersonicSQL:hsql://localhost</attribute>
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  + <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
    <attribute name="JDBCUser">sa</attribute>
   </mbean>
                                                        ]]></programlisting>
  @@ -1212,7 +1230,8 @@
                                                        <para><link 
linkend="jboss.jcml-file">jboss.jcml</link></para>
                                                        <programlisting><![CDATA[ 
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=DB2">
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  + <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
    <attribute name="PoolName">DB2DS</attribute>                
    <attribute name="URL">jdbc:db2://host.domain.com:port/database</attribute>
    <attribute name="JDBCUser">username</attribute>
  @@ -1243,7 +1262,8 @@
                                                        <para><link 
linkend="jboss.jcml-file">jboss.jcml</link></para>
                                                        <programlisting><![CDATA[ 
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=AS400">
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  + <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
    <attribute name="PoolName">AS400DS</attribute>              
    <attribute name="URL">jdbc:as400://hostname</attribute>
    <attribute name="JDBCUser">username</attribute>
  @@ -1283,7 +1303,8 @@
                                                        <para><link 
linkend="jboss.jcml-file">jboss.jcml</link></para>
                                                        <programlisting><![CDATA[ 
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=SybaseDB">
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  + <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
    <attribute name="PoolName">SybaseDS</attribute>             
    <attribute name="URL">jdbc:sybase:Tds:host.domain.com:4100/database</attribute>
    <attribute name="JDBCUser">username</attribute>
  @@ -1318,7 +1339,8 @@
                                                        <para><link 
linkend="jboss.jcml-file">jboss.jcml</link></para>
                                                        <programlisting><![CDATA[ 
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=PostgresDB">
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  + <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
    <attribute name="PoolName">PostgresDS</attribute>           
    <attribute name="URL">jdbc:postgresql://host.domain.com/database</attribute>
    <attribute name="JDBCUser">username</attribute>
  @@ -1375,7 +1397,8 @@
                    <programlisting>
                        <![CDATA[
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=PostgresDB">
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  + <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
    <attribute name="PoolName">PostgresDB</attribute>
    <attribute name="Properties"></attribute>
    <attribute name="URL">jdbc:postgresql://host.domain.com:5432/database</attribute>
  @@ -1432,7 +1455,8 @@
                                                        <para><link 
linkend="jboss.jcml-file">jboss.jcml</link></para>
                                                        <programlisting><![CDATA[ 
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=InterBaseDB">
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  + <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
    <attribute name="PoolName">InterBaseDS</attribute>          
    <attribute 
name="URL">jdbc:interbase://host.domain.com/path/to/database.gdb</attribute>
    <attribute name="JDBCUser">username</attribute>
  @@ -1467,7 +1491,8 @@
                                                        <para><link 
linkend="jboss.jcml-file">jboss.jcml</link></para>
                                                        <programlisting><![CDATA[ 
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=mySQLDB">
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  + <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
    <attribute name="PoolName">mySQLDS</attribute>              
    <attribute name="URL">jdbc:mysql://host/databasename</attribute>
    <attribute name="JDBCUser">username</attribute>
  @@ -1508,7 +1533,8 @@
                                                        <para><link 
linkend="jboss.jcml-file">jboss.jcml</link></para>
                                                        <programlisting><![CDATA[ 
   <mbean code="org.jboss.jdbc.XADataSourceLoader" 
name="DefaultDomain:service=XADataSource,name=JetEngineDB">
  - <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>
  + <attribute 
name="DataSourceClass">org.jboss.pool.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.4]
  + <attribute 
name="DataSourceClass">org.opentools.minerva.jdbc.xa.wrapper.XADataSourceImpl</attribute>[JBoss
 2.2.2]
    <attribute name="PoolName">InterBaseDS</attribute>          
    <attribute name="URL">jdbc:odbc:ODBC datasource name</attribute>
    <attribute name="JDBCUser">username</attribute>
  
  
  
  1.2       +139 -22   manual/src/xdocs/resource.xml
  
  Index: resource.xml
  ===================================================================
  RCS file: /cvsroot/jboss/manual/src/xdocs/resource.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- resource.xml      2001/08/29 09:19:36     1.1
  +++ resource.xml      2001/09/21 02:20:17     1.2
  @@ -260,12 +260,149 @@
   
       <section id="resource-db-specific">
         <title>Examples for specific databases</title>
  -      <para></para>
  +      <para>Please contribute your working example now!</para>
  +    <section id="mysql">
  +      <title>Mysql</title>
  +      <para>Here is a sample mysql-service.xml configuration file contributed by 
  +    <author>
  +      <firstname>Ignacio</firstname>
  +      <surname>Coloma</surname>
  +    </author>
  +    <email>[EMAIL PROTECTED]</email>
  +<programlisting><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
  +
  +
  +<!-- ===================================================================== -->
  +<!--                                                                       -->
  +<!--  foo App DataSource                                                   -->
  +<!--                                                                       -->
  +<!-- ===================================================================== -->
  +
  +<!-- $Id: resource.xml,v 1.2 2001/09/21 02:20:17 d_jencks Exp $ -->
  +
  +
  +<server>
  +
  +  <depends>JBOSS-SYSTEM:service=Naming</depends>
  +  <depends>JBOSS-SYSTEM:service=TransactionManager</depends>
  +
  +  <classpath archives="
  +      mm.mysql-2.0.4-bin.jar, 
  +      jbosscx.sar"/>
  +
  +  <!-- ==================================================================== -->
  +  <!-- JDBC - Initialize the databases                                      -->
  +  <!-- to ConnectionFactoryLoader                                           -->
  +  <!-- ==================================================================== -->
  +
  +  <mbean code="org.jboss.resource.ConnectionFactoryLoader" 
  +      name="DefaultDomain:service=ConnectionFactoryLoader,name=fooDS">
  +    <attribute 
name="ManagedConnectionFactoryProperties">ConnectionURL=jdbc:mysql://localhost/foo
  +      DriverClass=org.gjt.mm.mysql.Driver
  +      UserName=</attribute>
  +    <attribute name="JndiName">fooDS</attribute>
  +    <attribute name="TransactionManagerName">java:/TransactionManager</attribute>
  +    <attribute name="ResourceAdapterName">Minerva JDBC LocalTransaction 
ResourceAdapter</attribute>
  +    <attribute name="RARDeployerName">JCA:service=RARDeployer</attribute>
  +    <attribute 
name="ConnectionManagerFactoryName">MinervaSharedLocalCMFactory</attribute> 
  +    <attribute name="ConnectionManagerProperties">#
  +      #Wed Aug 15 16:17:29 EDT 2001
  +      InvalidateOnError=false
  +      BlockingTimeoutMillis=500000
  +      IdleTimeoutMillis=1800000
  +      MaxSize=10
  +      TimestampUsed=false
  +      IdleTimeoutEnabled=false
  +      CleanupIntervalMillis=120000
  +      MinSize=0
  +      GCMinIdleMillis=1200000
  +      GCEnabled=false
  +      MaxIdleTimeoutPercent=1.0
  +    </attribute>
  +    <attribute name="PrincipalMappingClass">
  +      org.jboss.resource.security.ManyToOnePrincipalMapping
  +    </attribute>
  +    <attribute name="PrincipalMappingProperties">UserName=</attribute>
  +  </mbean>
  +
  +</server>
  +]]></programlisting>
  +</para>
       </section>
  +    <section id="postgres">
  +      <title>Postgres</title>
  +      <para>Here is a sample postgres-service.xml configuration file contributed by 
  +    <author>
  +      <firstname>Ignacio</firstname>
  +      <surname>Coloma</surname>
  +    </author>
  +    <email>[EMAIL PROTECTED]</email>
  +<programlisting><![CDATA[<?xml version="1.0" encoding="UTF-8"?>
  +
  +
  +<!-- ===================================================================== -->
  +<!--                                                                       -->
  +<!--  foo App DataSource                                           -->
  +<!--                                                                       -->
  +<!-- ===================================================================== -->
  +
  +<!-- $Id: resource.xml,v 1.2 2001/09/21 02:20:17 d_jencks Exp $ -->
  +
  +<server>
  +
  +  <depends>JBOSS-SYSTEM:service=Naming</depends>
  +  <depends>JBOSS-SYSTEM:service=TransactionManager</depends>
  +
  +  <classpath archives="
  +      jdbc7.0-1.2.jar, 
  +      jbosscx.sar"/>
  +
  +  <!-- ==================================================================== -->
  +  <!-- JDBC - Initialize the databases                                      -->
  +  <!-- to ConnectionFactoryLoader                                           -->
  +  <!-- ==================================================================== -->
  +
  +  <mbean code="org.jboss.resource.ConnectionFactoryLoader" 
  +      name="DefaultDomain:service=ConnectionFactoryLoader,name=FooPostgresDS">
  +    <attribute 
name="ManagedConnectionFactoryProperties">ConnectionURL=jdbc:postgresql://192.168.0.4:5432/foo
  +  DriverClass=org.postgresql.Driver
  +  UserName=postgres
  +  Password=postgres</attribute>
  +    <attribute name="JndiName">FooPostgresDS</attribute>
  +    <attribute name="TransactionManagerName">java:/TransactionManager</attribute>
  +    <attribute name="ResourceAdapterName">Minerva JDBC LocalTransaction 
ResourceAdapter</attribute>
  +    <attribute name="RARDeployerName">JCA:service=RARDeployer</attribute>
  +    <attribute 
name="ConnectionManagerFactoryName">MinervaSharedLocalCMFactory</attribute> 
  +    <attribute name="ConnectionManagerProperties">#
  +      #Wed Aug 15 16:17:29 EDT 2001
  +      InvalidateOnError=false
  +      BlockingTimeoutMillis=500000
  +      IdleTimeoutMillis=1800000
  +      MaxSize=10
  +      TimestampUsed=false
  +      IdleTimeoutEnabled=false
  +      CleanupIntervalMillis=120000
  +      MinSize=0
  +      GCMinIdleMillis=1200000
  +      GCEnabled=false
  +      MaxIdleTimeoutPercent=1.0
  +    </attribute>
  +    <attribute name="PrincipalMappingClass">
  +      org.jboss.resource.security.ManyToOnePrincipalMapping
  +    </attribute>
  +    <attribute name="PrincipalMappingProperties">UserName=</attribute>
  +  </mbean>
  +
  +</server>
  +]]></programlisting>
  +</para>
  +    </section>
  +    </section>
       <section id="resource-migration">
         <title>Migration from older jboss versions</title>
         <para>Previous versions of jboss provided database connectivity and 
connection pooling through the XADataSourceLoaderMBean.  This was normally used with 
the XADataSourceImpl, which provided an xa interface for a non-xa jdbc driver.  Of 
course, since the underlying driver did not support xa transactions, neither did the 
XA wrapper.  These drivers can now be used with the Minerva JDBC LocalTransaction 
ResourceAdapter, which works with the transaction manager using local, non-xa 
transactions, eliminating the confusion of imitating but not implementing xa 
semantics.  If you have a true XADataSource implementation for your database, you can 
instead use the Minerva JDBC XATransaction ResourceAdapter, which provides full xa 
support.</para>
  -      <para>In this version of jboss, the XADataSourceLoader has been rewritten to 
assist you in migrating to this new architecture.  This mbean now accepts the 
configuration information from jboss.jcml, and creates a ConnectionFactoryLoader mbean 
with the appropriate connection pool and Minerva Resource Adapter and equivalent 
configuration.  You can complete the conversion by saving your mbean configuration to 
a file using the ConfigurationService mbean, copying the new ConnectionFactoryLoader 
mbean configuration into your jboss.jcml file, and removing the 
XADataSourceLoader.</para>
  +      <para>Most of the parameters in an XADataSourceLoader configuration have 
direct parallels in a ConnectionFactoryLoader configuration.  The table below 
indicates the correspondence with notes on areas of non-equivalence.</para>
  +    <para>COMING SOON.... The following is incomplete.</para>
         <para>The migration results in the following conversions:
           <orderedlist>
             <listitem>
  @@ -279,26 +416,6 @@
           </listitem>
         </orderedlist>
       </para>
  -    <para>Here are the migration steps:<itemizedlist>
  -        <listitem>
  -          <para>Make sure the jca-related mbeans (the RARDeployer and the three 
ConnectionManagerFactoryLoaders) are before any database-related mbeans (such as 
JDBCProvider, XADataSourceLoader, and JDBCDataSourceLoader).  You may follow the 
example of the current jboss.jcml</para>
  -        </listitem>
  -        <listitem>
  -          <para>Start jboss. You should see in the log your XADataSourceLoader or 
JDBCDataSourceLoader mbeans load and start, each creating a ConnectionFactoryLoader 
mbean.  The connection factory loaders should start successfully.</para>
  -        </listitem>
  -        <listitem>
  -          <para>You may wish to check that your applications work as expected, at 
least as far as database access is concerned.  Although you can continue to run your 
application in this way, we recommend that you continue with the rest of the 
migration.</para>
  -        </listitem>
  -        <listitem>
  -          <para>Using the jmx management facility at port 8082, go to the 
ConfigurationService and press the SaveConfiguration button.  This will write the 
state of all mbeans to jboss-auto.jcml.</para>
  -        </listitem>
  -        <listitem>
  -          <para>In this jboss-auto.jcml, locate the ConnectionFactoryLoader mbean 
configurations corresponding to the XADataSourceLoader mbean configurations.  Copy 
these xml chunks to your jboss.jcml file and remove the equivalent XADataSourceLoader 
mbean configurations.</para>
  -        </listitem>
  -
  -      </itemizedlist>
  -    </para>
  -    <para>The XADataSourceLoader and JDBCDataSourceLoader mbeans will be removed in 
a future jboss release.  Convert Now!!</para>
       </section>
   </chapter>
   <!-- Local Variables:
  
  
  

_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development

Reply via email to