User: oleg
Date: 00/10/03 05:06:21
Modified: manual adv_config.html
Log:
Added directions for configuring incremental file logging and date/time formats
Revision Changes Path
1.7 +76 -62 jbossweb/manual/adv_config.html
Index: adv_config.html
===================================================================
RCS file: /products/cvs/ejboss/jbossweb/manual/adv_config.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- adv_config.html 2000/09/30 13:58:28 1.6
+++ adv_config.html 2000/10/03 12:06:21 1.7
@@ -56,11 +56,11 @@
<pre>
jdbc.drivers=oracle.jdbc.driver.OracleDriver,com.sybase.jdbc2.jdbc.SybDriver
</pre>
- <p>The next time you start jBoss, you should see output like the
- following listing each driver that was loaded. If instead you
- see an error for the driver (also shown below), make sure that
- you installed the required ZIPs and/or JARs to the
- <strong>lib/ext</strong> directory.</p>
+ <p>The next time you start jBoss, you should see output like the
+ following listing each driver that was loaded. If instead you
+ see an error for the driver (also shown below), make sure that
+ you installed the required ZIPs and/or JARs to the
+ <strong>lib/ext</strong> directory.</p>
<pre>
[JDBC] Loaded JDBC-driver:oracle.jdbc.driver.OracleDriver
[JDBC] Could not load driver:com.sybase.jdbc2.jdbc.SybDriver
@@ -145,17 +145,17 @@
</MLET>
</pre>
- <p>Second, you must add a section to <code>jboss.jcml</code> for
- each pool. This declares all the parameters for the pool, such as
- the size, username and password to use, etc. The parameters will
- be covered in detail next. The block you need to add is shown
- below. You only need to add lines for the parameters you want to
- override - anything you want to leave as the default you can omit.
- jBoss will add all those lines in when it runs, so you can see the
- default values. The example below is a simple configuration with
- only the JDBC URL, user name, and password. The one thing you
- need to change besides the parameter names and values is the pool
- name in the first line:</p>
+ <p>Second, you must add a section to <code>jboss.jcml</code> for
+ each pool. This declares all the parameters for the pool, such as
+ the size, username and password to use, etc. The parameters will
+ be covered in detail next. The block you need to add is shown
+ below. You only need to add lines for the parameters you want to
+ override - anything you want to leave as the default you can omit.
+ jBoss will add all those lines in when it runs, so you can see the
+ default values. The example below is a simple configuration with
+ only the JDBC URL, user name, and password. The one thing you
+ need to change besides the parameter names and values is the pool
+ name in the first line:</p>
<pre>
<mbean name="DefaultDomain:service=XADataSource,name=<b>PoolName</b>">
<attribute
name="<b>URL</b>"><b>jdbc:oracle:thin:@serverhostname:1521:ORCL</b></attribute>
@@ -304,20 +304,20 @@
<li>Oracle
<ul>
<li>lib/ext: <a
HREF="http://technet.oracle.com/software/tech/java/sqlj_jdbc/software_index.htm">classes12.zip</a></li>
- <li>jboss.properties
+ <li>jboss.properties
<pre>
jdbc.drivers=oracle.jdbc.driver.OracleDriver
</pre>
- </li>
- <li>jboss.conf
+ </li>
+ <li>jboss.conf
<pre>
<MLET CODE="org.jboss.jdbc.XADataSourceLoader" ARCHIVE="jboss.jar"
CODEBASE="../lib/ext/">
<ARG TYPE="java.lang.String" VALUE="<b>OracleDB</b>">
<ARG TYPE="java.lang.String"
VALUE="org.jboss.minerva.xa.XADataSourceImpl">
</MLET>
</pre>
- </li>
- <li>jboss.jcml
+ </li>
+ <li>jboss.jcml
<pre>
<mbean name="DefaultDomain:service=XADataSource,name=<b>OracleDB</b>">
<attribute
name="URL">jdbc:oracle:thin:@<b>host.domain.com</b>:1521:<b>instance</b></attribute>
@@ -325,107 +325,107 @@
<attribute name="JDBCUser"><b>tiger</b></attribute>
</mbean>
</pre>
- </li>
- </ul>
+ </li>
+ </ul>
</li>
<li>Hypersonic</li>
<ul>
<li>lib/ext: <a
HREF="http://hsql.oron.ch/hSqlDownload.html">hsql.jar</a></li>
- <li>jboss.properties
+ <li>jboss.properties
<pre>
jdbc.drivers=org.hsql.jdbcDriver
</pre>
- </li>
- <li>jboss.conf
+ </li>
+ <li>jboss.conf
<pre>
<MLET CODE="org.jboss.jdbc.XADataSourceLoader" ARCHIVE="jboss.jar"
CODEBASE="../lib/ext/">
<ARG TYPE="java.lang.String" VALUE="<b>Hypersonic</b>">
<ARG TYPE="java.lang.String"
VALUE="org.jboss.minerva.xa.XADataSourceImpl">
</MLET>
</pre>
- </li>
- <li>jboss.jcml
+ </li>
+ <li>jboss.jcml
<pre>
<mbean name="DefaultDomain:service=XADataSource,name=<b>Hypersonic</b>">
<attribute
name="URL">jdbc:HypersonicSQL:hsql://<b>localhost</b></attribute>
<attribute name="JDBCUser"><b>sa</b></attribute>
</mbean>
</pre>
- </li>
- </ul>
+ </li>
+ </ul>
</li>
<li>DB/2 (<i>Forthcoming...</i>)
<ul>
<li>lib/ext: <a
HREF="http://www-4.ibm.com/software/data/db2/java/">unknown.jar</a></li>
- <li>jboss.properties
+ <li>jboss.properties
<pre>
</pre>
- </li>
- <li>jboss.conf
+ </li>
+ <li>jboss.conf
<pre>
</pre>
- </li>
- <li>jboss.jcml
+ </li>
+ <li>jboss.jcml
<pre>
</pre>
- </li>
- </ul>
+ </li>
+ </ul>
</li>
<li>Sybase (<i>Forthcoming...</i>)
<ul>
<li>lib/ext: <a
HREF="http://www.sybase.com/detail_list/1,3153,2282,00.html">unknown.jar</a></li>
- <li>jboss.properties
+ <li>jboss.properties
<pre>
</pre>
- </li>
- <li>jboss.conf
+ </li>
+ <li>jboss.conf
<pre>
</pre>
- </li>
- <li>jboss.jcml
+ </li>
+ <li>jboss.jcml
<pre>
</pre>
- </li>
- </ul>
+ </li>
+ </ul>
</li>
<li>PostgreSQL (<i>Forthcoming...</i>)
<ul>
<li>lib/ext: <a
HREF="http://www.postgresql.org/sites.html">jdbc7.0-1.2.jar</a></li>
- <li>jboss.properties
+ <li>jboss.properties
<pre>
</pre>
- </li>
- <li>jboss.conf
+ </li>
+ <li>jboss.conf
<pre>
</pre>
- </li>
- <li>jboss.jcml
+ </li>
+ <li>jboss.jcml
<pre>
</pre>
- </li>
- </ul>
+ </li>
+ </ul>
</li>
<li>Interbase (<i>Forthcoming...</i>)
<ul>
<li>lib/ext: <a
HREF="http://www.borland.com/interbase/downloads/">interclient-core.jar</a></li>
- <li>jboss.properties
+ <li>jboss.properties
<pre>
</pre>
- </li>
- <li>jboss.conf
+ </li>
+ <li>jboss.conf
<pre>
</pre>
- </li>
- <li>jboss.jcml
+ </li>
+ <li>jboss.jcml
<pre>
</pre>
- </li>
- </ul>
+ </li>
+ </ul>
</li>
</ul>
@@ -477,7 +477,7 @@
<ARG TYPE="java.lang.String" VALUE="../../log/">
</MLET>
</pre>
- <p>Finally, if you want to change the output file later, you will
+ <p>If you want to change the output file later, you will
need to update the file name both here and in
<code>jboss.jcml</code>. Since it is both set at startup (so the
initial output is logged) and able to be set dynamically via the
@@ -486,6 +486,20 @@
<code>jboss.jcml</code> when you first switch to file logging,
because it will populate the correct default filename for you
automatically.</p>
+ <p>Finally, if you want to append the output file at startup
+ rather than to overwrite, you should add one more argument line
+ in jboss.conf:</p>
+<pre>
+<MLET CODE = "org.jboss.logging.FileLogging" ARCHIVE="jboss.jar"
CODEBASE="../lib/ext/">
+ <ARG TYPE="java.lang.String" VALUE="Information,Debug,Warning,Error">
+ <ARG TYPE="java.lang.String" VALUE="<b>{0,date,yyyy-MM-dd}
{0,time,hh:mm:ss}</b> [{2}] {4}">
+ <ARG TYPE="java.lang.String" VALUE="">
+ <ARG TYPE="java.lang.String" VALUE="FileName">
+ <ARG TYPE="java.lang.Boolean" VALUE="<b>true</b>">
+</MLET>
+</pre>
+ <p>In the second argument line above you can see an example
+ of setting date and time formats for the log file.</p>
<h4><a NAME="gui">Configuring GUI Logging</a></h4>
<p>For GUI logging, add an entry to jboss.conf that looks like
@@ -535,9 +549,9 @@
<attribute name="Port"><b>8082</b></attribute>
</mbean>
</pre>
- <p>To change the RMI port, change the following entry in
- <code>jboss.jcml</code> in the <strong>conf</strong> directory.
- Your clients should use the new port automatically.</p>
+ <p>To change the RMI port, change the following entry in
+ <code>jboss.jcml</code> in the <strong>conf</strong> directory.
+ Your clients should use the new port automatically.</p>
<pre>
<mbean name="DefaultDomain:service=Webserver">
<attribute name="Port"><b>8083</b></attribute>
