User: vlada
Date: 01/03/31 18:14:14
Modified: src/docs jdbc-database.xml basicconfiguration.xml
Log:
links - lets use them any time we can + tobias's section on jdbc pupgrade that I
accidentally erase
Revision Changes Path
1.6 +91 -30 manual/src/docs/jdbc-database.xml
Index: jdbc-database.xml
===================================================================
RCS file: /cvsroot/jboss/manual/src/docs/jdbc-database.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- jdbc-database.xml 2001/04/01 00:30:12 1.5
+++ jdbc-database.xml 2001/04/01 02:14:14 1.6
@@ -52,14 +52,14 @@
</para>
</listitem>
<listitem>
- <para>Add intruction to load driver in jboss.jcml
file</para>
+ <para>Add intruction to load driver in <link
linkend="jboss.jcml-file">jboss.jcml</link> file</para>
<para> For example <xref
linkend="jdbc-driver-inclusion"/> shows how JBoss two default
database drivers are included. If you are using
database other than default, add your driver class name
- to the list of drivers in this mbean element of your
jboss.jcml. </para>
+ to the list of drivers in this mbean element of your
<link linkend="jboss.jcml-file">jboss.jcml</link>. </para>
<figure id="jdbc-driver-inclusion">
- <title>Default driver loading instruction from
jboss.jcml</title>
+ <title>Default driver loading instruction from
<link linkend="jboss.jcml-file">jboss.jcml</link></title>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute
name="Drivers">org.hsql.jdbcDriver,org.enhydra.instantdb.jdbc.idbDriver</attribute>
@@ -73,7 +73,7 @@
include reference to your Oracle driver like shown in
<xref linkend="jdbc-driver-inclusion2"/></para>
<figure id="jdbc-driver-inclusion2">
- <title>Oracle driver loading instruction from
jboss.jcml</title>
+ <title>Oracle driver loading instruction from
<link linkend="jboss.jcml-file">jboss.jcml</link></title>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">oracle.jdbc.driver.OracleDriver</attribute>
@@ -108,7 +108,7 @@
a number of reasons. For example, you may want a dedicated pool for an
application that requires
very high reponse time, while other applications share a pool of
limited size.</para>
- <para>To add a pool, you need to add sections to jboss.conf and
jboss.jcml, both of which can be
+ <para>To add a pool, you need to add sections to <link
linkend="jboss.conf-file">jboss.conf</link> and <link
linkend="jboss.jcml-file">jboss.jcml</link>, both of which can be
found in the conf directory.</para>
<section>
<title>The JDBC 2.0 Optional Package</title>
@@ -150,8 +150,8 @@
<section>
<title>Minerva configuration</title>
<para>After you have successfully installed your JDBC driver
as described in <xref linkend="installing-jdbc-driver"/>
- , you are ready to define pool settings. All pool entries are
specified in jboss.jcml file. Take a look at
- <xref linkend="minerva-configuration-example"/> pool
configuration example. It defines , in jboss.jcml, pool name "DefaultDS"
+ , you are ready to define pool settings. All pool entries are
specified in <link linkend="jboss.jcml-file">jboss.jcml</link> file. Take a look at
+ <xref linkend="minerva-configuration-example"/> pool
configuration example. It defines , in <link
linkend="jboss.jcml-file">jboss.jcml</link>, pool name "DefaultDS"
that uses underlying Hypersonic database.
All database pool attributes are discussed in details
below.</para>
@@ -205,8 +205,8 @@
</para>
<section>
<title>Connection Pool Parameters</title>
- <para>Here is the list of possible parameters for each
pool's entry in jboss.jcml. Again, after you run
- JBoss once with your new pool, it will add entries for
all of these to jboss.jcml, using the default
+ <para>Here is the list of possible parameters for each
pool's entry in <link linkend="jboss.jcml-file">jboss.jcml</link>. Again, after you run
+ JBoss once with your new pool, it will add entries for
all of these to <link linkend="jboss.jcml-file">jboss.jcml</link>, using the default
values for anything you didn't specify.</para>
<table>
<title>Connection pool parameters</title>
@@ -374,7 +374,7 @@
<programlisting>jboss.xa.xidclass=oracle.jdbc.xa.OracleXid
</programlisting>
</listitem>
- <listitem><para>jboss.jcml</para>
+ <listitem><para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">oracle.jdbc.driver.OracleDriver</attribute>
@@ -383,7 +383,7 @@
</programlisting>
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.XADataSourceLoader"
name="DefaultDomain:service=XADataSource,name=OracleDB">
<attribute name="PoolName">OracleDS</attribute>
@@ -412,7 +412,7 @@
<listitem>
<para><link
linkend="lib-and-libext-dir">lib/ext</link>: classes12.zip</para>
</listitem>
- <listitem><para>jboss.jcml</para>
+ <listitem><para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">oracle.jdbc.driver.OracleDriver</attribute>
@@ -421,7 +421,7 @@
</programlisting>
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.XADataSourceLoader"
name="DefaultDomain:service=XADataSource,name=OracleDB">
<attribute name="PoolName">OracleDS</attribute>
@@ -443,7 +443,7 @@
<listitem>
<para><link
linkend="lib-and-libext-dir">lib/ext</link>: hsql.jar</para>
</listitem>
- <listitem><para>jboss.jcml</para>
+ <listitem><para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">org.hsql.jdbcDriver</attribute>
@@ -453,7 +453,7 @@
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.XADataSourceLoader"
name="DefaultDomain:service=XADataSource,name=Hypersonic">
<attribute name="PoolName">HypersonicDS</attribute>
@@ -485,7 +485,7 @@
<para><link
linkend="lib-and-libext-dir">lib/ext</link>: db2java.zip</para>
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">COM.ibm.db2.jdbc.net.DB2Driver</attribute>
@@ -493,7 +493,7 @@
</programlisting>
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <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>
@@ -515,7 +515,7 @@
<listitem>
<para><link
linkend="lib-and-libext-dir">lib/ext</link> : jt400.jar </para>
</listitem>
- <listitem><para>jboss.jcml</para>
+ <listitem><para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">com.ibm.as400.access.AS400JDBCDriver</attribute>
@@ -524,7 +524,7 @@
</programlisting>
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <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>
@@ -555,7 +555,7 @@
<listitem>
<para><link
linkend="lib-and-libext-dir">lib/ext</link> :jconn2.jar</para>
</listitem>
- <listitem><para>jboss.jcml</para>
+ <listitem><para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">com.sybase.jdbc2.jdbc.SybDriver</attribute>
@@ -564,7 +564,7 @@
</programlisting>
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <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>
@@ -590,7 +590,7 @@
<listitem>
<para><link
linkend="lib-and-libext-dir">lib/ext</link>: jdbc7.0-1.2.jar</para>
</listitem>
- <listitem><para>jboss.jcml</para>
+ <listitem><para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">org.postgresql.Driver</attribute>
@@ -599,7 +599,7 @@
</programlisting>
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <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>
@@ -631,7 +631,7 @@
<listitem>
<para><link
linkend="lib-and-libext-dir">lib/ext</link>:interclient-core.jar</para>
</listitem>
- <listitem><para>jboss.jcml</para>
+ <listitem><para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">interbase.interclient.Driver</attribute>
@@ -641,7 +641,7 @@
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <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>
@@ -667,7 +667,7 @@
copy the jar to <filename>lib/ext/</filename>
</literallayout>
</listitem>
- <listitem><para>jboss.jcml</para>
+ <listitem><para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">org.gjt.mm.mysql.Driver</attribute>
@@ -676,7 +676,7 @@
</programlisting>
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <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>
@@ -708,7 +708,7 @@
<listitem>
<para><link
linkend="lib-and-libext-dir">lib/ext</link> :Sun JRE's rt.jar if your not running on a
Sun virtual machine, otherwise none </para>
</listitem>
- <listitem><para>jboss.jcml</para>
+ <listitem><para><link
linkend="jboss.jcml-file">jboss.jcml</link></para>
<programlisting><![CDATA[
<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
<attribute name="Drivers">sun.jdbc.odbc.JdbcOdbcDriver</attribute>
@@ -717,7 +717,7 @@
</programlisting>
</listitem>
<listitem>
- <para>jboss.jcml</para>
+ <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>
@@ -741,5 +741,66 @@
</listitem>
</itemizedlist>
</section>
- </section>
+ </section>
+ <section>
+ <title>Upgrading from JBoss 2.0 FINAL</title>
+ <para>Author:<author>
+ <firstname>Tobias</firstname>
+ <surname>Frech</surname>
+ </author>
+ </para>
+ <para>In order to upgrade your database configuration files
from version 2.0 FINAL you have to do the following. </para>
+ <itemizedlist>
+ <listitem>
+ <formalpara>
+ <title>jboss.properties:</title>
+ <para>Driver listing from this file is
ignored and you have to move it to <link linkend="jboss.jcml-file">jboss.jcml</link>.
For example,
+ Orace driver inclusion is shown in
<xref linkend="new-driver-inclusion"/>
+ <figure id="new-driver-inclusion">
+ <title>Example of driver
inclusion , Oracle driver</title>
+ <programlisting><![CDATA[
+<mbean code="org.jboss.jdbc.JdbcProvider" name="DefaultDomain:service=JdbcProvider">
+ <attribute name="Drivers">oracle.jdbc.driver.OracleDriver</attribute>
+</mbean>
+ ]]>
+ </programlisting>
+ </figure>
+ </para>
+ </formalpara>
+ </listitem>
+ <listitem>
+ <formalpara>
+ <title><link
linkend="jboss.conf-file">jboss.conf</link>:</title>
+ <para>This information is no longer
needed.</para>
+ </formalpara>
+ </listitem>
+ <listitem>
+ <formalpara>
+ <title><link
linkend="jboss.jcml-file">jboss.jcml</link>:</title>
+ <para>Find the entry
+ <programlisting><![CDATA[
+<mbean code="org.jboss.jdbc.XADataSourceLoader"
+name="DefaultDomain:service=XADataSource,name=DefaultDS">
+...
+</mbean>
+]]></programlisting> Either you want to change the default Datasource, then change
the
+ contents of this entry directly, or you want to add a new
+ datasource. For the second
+ case create a copy of the whole entry after
+ the already existing one.
+ Now change the two occurences of the <quote>DefaultDS</quote>
+ string (in <quote>name=...</quote> and attribute <quote>PoolName</quote>) to
the name you want
+ to specify for your new datasource.
+ Also adjust at least the following entries according to your
+ configuration and to the data given in the example:
+ <programlisting><![CDATA[
+<attribute name="URL">jdbc:url/with/your/database/name/like/in/example</attribute>
+<attribute name="JDBCUser">DatabaseUserNameHere</attribute>
+<attribute name="Password">DatabasePasswordHere</attribute>
+]]></programlisting></para>
+ </formalpara>
+ </listitem>
+ </itemizedlist>
+ <para>Note that driver installation instructions are in <xref
linkend ="installing-jdbc-driver"/></para>
+ </section>
</chapter>
1.5 +7 -8 manual/src/docs/basicconfiguration.xml
Index: basicconfiguration.xml
===================================================================
RCS file: /cvsroot/jboss/manual/src/docs/basicconfiguration.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- basicconfiguration.xml 2001/04/01 00:30:12 1.4
+++ basicconfiguration.xml 2001/04/01 02:14:14 1.5
@@ -137,7 +137,7 @@
</para>
<itemizedlist>
<listitem>
- <para>jboss.conf</para>
+ <para id="jboss.conf-file">jboss.conf</para>
<para>
Configuration file jboss.conf contains only those core services that are
@@ -166,7 +166,7 @@
<listitem>
- <para>jboss.jcml</para>
+ <para id="jboss.jcml-file">jboss.jcml</para>
<para>
This file lists all JMX MBeans (services) that are going to be included
@@ -218,7 +218,7 @@
</listitem>
<listitem>
- <para>jboss.dependencies</para>
+ <para id="jboss.dependencies-file">jboss.dependencies</para>
<para>
For the reason of simplicity and ease of configuration JBoss's
DependancyManager
was deprecated in 2.1 release. </para>
@@ -231,7 +231,7 @@
<listitem>
- <para>jboss-auto.jcml</para>
+ <para id="jboss-auto-file">jboss-auto.jcml</para>
<para>
JBoss has a very powerful feature of being able to record runtime snapshot
@@ -275,7 +275,7 @@
<listitem>
- <para>mail.properties</para>
+ <para id="mail.properties-file">mail.properties</para>
<para>
JBoss , according to EJB spec provides mail resource access utilizing
standard JavaMail APIs.
This file specifies provider properties, i.e where to find smtp server, pop
server, as well
@@ -289,7 +289,7 @@
</listitem>
<listitem>
- <para>
+ <para id="jndi.properties-file">
jnp.properties and jndi.properties</para>
<para>
@@ -309,8 +309,7 @@
<listitem>
- <para>
- standardjaws.xml</para>
+ <para id="standardjaws.xml-file">standardjaws.xml</para>
<para>
Represents a default configuration file for JBossCMP engine. It contains
jndi name of a default
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
http://lists.sourceforge.net/lists/listinfo/jboss-development
