paulsp 01/09/28 22:20:33
Modified: docs/site config_guide.html
Log:
Add Configuration Guide to project menu
Revision Changes Path
1.3 +581 -32 jakarta-jetspeed/docs/site/config_guide.html
Index: config_guide.html
===================================================================
RCS file: /home/cvs/jakarta-jetspeed/docs/site/config_guide.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- config_guide.html 2001/09/06 14:15:53 1.2
+++ config_guide.html 2001/09/29 05:20:32 1.3
@@ -69,6 +69,8 @@
</ul>
<p><strong>Documentation</strong></p>
<ul>
+ <li> <a href="./config_guide.html">Configuration Guide</a>
+</li>
<li> <a
href="http://www.bluesunrise.com/jetspeed-docs/javadocs/";>Javadoc</a>
</li>
<li> <a href="./application-development.html">Development</a>
@@ -92,14 +94,30 @@
</li>
<li> <a href="./psml.html">PSML</a>
</li>
- <li> <a href="./icalendar.html">iCalendar</a>
-</li>
</ul>
</td>
<td width="80%" align="left" valign="top">
<table
border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Status of this document"><strong>Status of this
document</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ This document is very much a "Work in Progress". Although some sections
are incomplete, I hope what is here is helpful.
+ Comments and suggestions are welcome and encouraged. They can be set to <a
href="mailto:[EMAIL PROTECTED]";>
+ [EMAIL PROTECTED]</a>
+ </p>
+ </blockquote>
+ </p>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0" cellspacing="0"
cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
<a name="General Configuration steps"><strong>General Configuration
steps</strong></a>
</font>
</td></tr>
@@ -110,12 +128,15 @@
</p>
<ul>
<li><a href="install.html#Installation">Install Jetspeed</a></li>
+<!--
<li><a href="psml_db.html">Configure and build PSML database</a></li>
<li><a href="#Configure User Database">Configure and build user
database</a></li>
+-->
<li><a href="#Define portlets in local-portlets">Define portlets in
local-portlets</a></li>
<li><a href="#Define skins in local-skins.xreg">Define skins in
local-skins.xreg</a></li>
<li><a href="#Define local controls and controllers in
local-managers.xreg">Define local controls and controllers in
local-managers.xreg</a></li>
<li><a href="#Define content feeds">Define content feeds</a></li>
+ <li><a href="#Configure the layout and navigaton bars">Configure the layout
and navigaton bars</a></li>
<li><a href="#Configure default home page">Configure default home
page</a></li>
<li><a href="#Define users">Define users</a></li>
<li><a href="#Configure the admin and turbine users">Configure the admin
and turbine users</a></li>
@@ -133,15 +154,17 @@
<table border="0" cellspacing="0"
cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Configure User Database"><strong>Configure User
Database</strong></a>
+ <a name="Define portlets in local-portlets"><strong>Define portlets in
local-portlets</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
+ <p>
+ Any site specific portlets should be define in
<tt><jetspeed_home>/WEB-INF/conf/local-portlets.xreg</tt>.
+ because this file will not be overwritten by upgrades.
+ </p>
<p>
- The user configuration can be stored in a database instead of text files.
Storing
- user information in the database has the advantage of performance.
+ See the <a href="catalog">Portlet Catalog</a> for portlet configuration
documentation.
</p>
</blockquote>
</p>
@@ -151,18 +174,15 @@
<table border="0" cellspacing="0"
cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Define portlets in local-portlets"><strong>Define portlets in
local-portlets</strong></a>
+ <a name="Define skins in local-skins.xreg"><strong>Define skins in
local-skins.xreg</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
- <p>
- Any site specific portlets should be define in
<jetspeed_home>/WEB-INF/conf/local-portlets.xreg.
+ <p>
+ Any site specific skins should be define in
<tt><jetspeed_home>/WEB-INF/conf/local-skins.xreg</tt>.
because this file will not be overwritten by upgrades.
</p>
- <p>See the <a
href="catalog">Portlet Catalog</a> for portlet configuration documentation.
- </p>
</blockquote>
</p>
</td></tr>
@@ -171,14 +191,13 @@
<table border="0" cellspacing="0"
cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Define skins in local-skins.xreg"><strong>Define skins in
local-skins.xreg</strong></a>
+ <a name="Define local controls and controllers in
local-managers.xreg"><strong>Define local controls and controllers in
local-managers.xreg</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
- <p>
- Any site specific skins should be define in
<jetspeed_home>/WEB-INF/conf/local-skins.xreg.
+ <p>
+ Any site specific controls and controllers should be define in
<tt><jetspeed_home>/WEB-INF/conf/local-managers.xreg</tt>.
because this file will not be overwritten by upgrades.
</p>
</blockquote>
@@ -189,15 +208,13 @@
<table border="0" cellspacing="0"
cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Define local controls and controllers in
local-managers.xreg"><strong>Define local controls and controllers in
local-managers.xreg</strong></a>
+ <a name="Define content feeds"><strong>Define content feeds</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
+ <p><center>This section is
incomplete</center></p>
<p>
- Any site speific controls and controllers should be define in
<jetspeed_home>/WEB-INF/conf/local-managers.xreg.
- because this file will not be overwritten by upgrades.
</p>
</blockquote>
</p>
@@ -207,15 +224,53 @@
<table border="0" cellspacing="0"
cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Define content feeds"><strong>Define content feeds</strong></a>
+ <a name="Configure the layout and navigaton bars"><strong>Configure the
layout and navigaton bars</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
+ <p><center>This section is
incomplete</center></p>
<p>
+ The look of Jetspeed's portal is controlled by the layout and nagivation
templates. Below are some of the
+ file that define that look.
</p>
+ <table border="0"
cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Velocity Layout Manager - 1.3a2 default"><strong>Velocity Layout
Manager - 1.3a2 default</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <ul>
+
<li><tt><jetspeed_home>/WEB-INF/template/vm/layouts/html/<i>language/country/</i>default.vm</tt></li>
+
<li><tt><jetspeed_home>/WEB-INF/template/vm/navigations/html/<i>language/country/</i>top.vm</tt></li>
+
<li><tt><jetspeed_home>/WEB-INF/template/vm/navigations/html/<i>language/country/</i>left.vm</tt></li>
+
<li><tt><jetspeed_home>/WEB-INF/template/vm/navigations/html/<i>language/country/</i>bottom.vm</tt></li>
+ </ul>
</blockquote>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0"
cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="JSP Layout Manager - 1.3a1 default"><strong>JSP Layout Manager -
1.3a1 default</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <ul>
+
<li><tt><jetspeed_home>/WEB-INF/template/jsp/layouts/html/<i>language/country/</i>default.jsp</tt></li>
+
<li><tt><jetspeed_home>/WEB-INF/template/jsp/navigations/html/<i>language/country/</i>top.jsp</tt></li>
+
<li><tt><jetspeed_home>/WEB-INF/template/jsp/navigations/html/<i>language/country/</i>left.jsp</tt></li>
+
<li><tt><jetspeed_home>/WEB-INF/template/jsp/navigations/html/<i>language/country/</i>bottom/jsp</tt></li>
+ </ul>
+ </blockquote>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ </blockquote>
</p>
</td></tr>
<tr><td><br/></td></tr>
@@ -228,8 +283,11 @@
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
+ <p><center>This section is
incomplete</center></p>
<p>
+ The default home page is stored in the
<tt><jetspeed_home>/WEB-INF/psml/anon</tt> directory. Currently this
+ is not directly configurable with the customizer. A suggested procedure is
to create a <i>HomePageUser</i>,
+ do the desired configuration as that user, then copy the resulting files to
the default home page.
</p>
</blockquote>
</p>
@@ -244,7 +302,7 @@
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
+ <p><center>This section is
incomplete</center></p>
<p>
</p>
</blockquote>
@@ -260,8 +318,9 @@
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
+ <p><center>This section is
incomplete</center></p>
<p>
+ <center><font size="+2"><strong>Change the
passwords!</strong></font></center>
</p>
</blockquote>
</p>
@@ -276,8 +335,9 @@
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
- <p>
+ <p>
+ A new users home page is coppied from the user <tt>TURBINE</tt>. Thus you
should customized the <tt>TURBINE</tt>'s
+ user home page to refect the desired default home page for new users.
</p>
</blockquote>
</p>
@@ -292,7 +352,7 @@
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
+ <p><center>This section is
incomplete</center></p>
<p>
</p>
</blockquote>
@@ -308,9 +368,497 @@
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
+ <p>
+ Jetspeed utilizes the logging services provided by Turbine. The logfile(s)
are
+ a valuable tool in trouble shooting problems and monitoring the general
health of
+ Jetspeed an it's portlets.
+ </p>
+ <p>
+ The logging level should be set according the the current needs. DEBUG
logging is
+ suggested during portlet testing, while INFO logging is appropriate for
every-day
+ activity in a stable environment.
+ </p>
+ <p>
+ Not all of Turbine's logging services are included. Additional
documentation can
+ be found at <a
href="http://jakarta.apache.org/turbine";>http://jakarta.apache.org/turbine</a>.
+ </p>
+ <table>
+ <tr>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Facility
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Description
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ rotation
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ Rotation of log files. This will limit the amount of disk space
+ consumed by the log file. Not supported by all loggers.
+
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ schedule
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ A facility for the scheduler service
+ To disable started/stopped messages set the level to ERROR
+
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ security
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ A facility for security audit. NOTE! As of 23 Jan 2001
+ Turbine does not have any standard security auditing
+ functionality. It's up to your application.
+
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ system
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ A facility for system logging.
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ sql
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ A facility for SQL query logging
+ To enable SQL query logging, set the level to DEBUG
+
+ </font>
+</td>
+ </tr>
+ </table>
+ <table border="0"
cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="FileLogger"><strong>FileLogger</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ This is a logging service provide with Turbine.
+ </p>
<p>
- </p>
+ Additional information can be found at <a
href="http://jakarta.apache.org/turbine";>
+ http://jakarta.apache.org/turbine</a>
+ </p>
+ <table>
+ <tr>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Facility
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Description
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ destination.file
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Name of the log file relative to <jetspeed-home>
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ className
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ org.apache.turbine.services.logging.FileLogger
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ level
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ <table>
+ <tr>
+ <th>Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>FATAL</td>
+ <td>Designates very severe error events that will presumably lead
the application to abort.</td>
+ </tr>
+ <tr>
+ <td>ERROR</td>
+ <td>Designates error events that might still allow the
application to continue running</td>
+ </tr>
+ <tr>
+ <td>WARN</td>
+ <td>Designates potentially harmful situations</td>
+ </tr>
+ <tr>
+ <td>INFO</td>
+ <td>Designates informational messages that highlight the progress
of the application at coarse-grained level.</td>
+ </tr>
+ <tr>
+ <td>DEBUG</td>
+ <td>Designates fine-grained informational events that are most
useful to debug an application</td>
+ </tr>
+ </table>
+
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ destination.console
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Optional, default = false <br />
+ <table>
+ <tr>
+ <th>Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>false</td>
+ <td>message will NOT be sent to the console</td>
+ </tr>
+ <tr>
+ <td>true</td>
+ <td>message will ALSO be sent to the console</td>
+ </tr>
+ </table>
+
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ </font>
+</td>
+ </tr>
+ </table>
+ </blockquote>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0"
cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Log4JavaLoggger"><strong>Log4JavaLoggger</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ This is a more functional logging service that can interact with
operating specific
+ facilities like UNIX's syslog and Window's Event Logger
+ </p>
+ <p>
+ Additional information can be found at <a
href="http://jakarta.apache.org/log4j";>
+ http://jakarta.apache.org/log4j</a> and <a
href="http://jakarta.apache.org/turbine";>
+ http://jakarta.apache.org/turbine</a>
+ </p>
+ <p>
+ Configuration notes:
+ <ul>
+ <li>
+ All loggers define in <tt>services.LoggingService.facilities</tt>
must
+ be the same type when using the Log4J services.
+ </li>
+ <li>
+ When using log file rotation, the rotation facility must be the first
in the
+ <tt>services.LoggingService.facilities</tt> list.
+ </li>
+ </ul>
+ </p>
+ <table>
+ <tr>
+ <td bgcolor="#039acc" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Facility
+ </font>
+</td>
+ <td bgcolor="#039acc" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Description
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ destination.file
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Name of the log file relative to <jetspeed-home>
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ className
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ org.apache.turbine.services.logging.Log4JavaLogger
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ level
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ <table>
+ <tr>
+ <th>Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>FATAL</td>
+ <td>Designates very severe error events that will presumably lead
the application to abort.</td>
+ </tr>
+ <tr>
+ <td>ERROR</td>
+ <td>Designates error events that might still allow the
application to continue running</td>
+ </tr>
+ <tr>
+ <td>WARN</td>
+ <td>Designates potentially harmful situations</td>
+ </tr>
+ <tr>
+ <td>INFO</td>
+ <td>Designates informational messages that highlight the progress
of the application at coarse-grained level.</td>
+ </tr>
+ <tr>
+ <td>DEBUG</td>
+ <td>Designates fine-grained informational events that are most
useful to debug an application</td>
+ </tr>
+ </table>
+
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ destination.console
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Optional, default = false <br />
+ <table>
+ <tr>
+ <th>Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>false</td>
+ <td>message will NOT be sent to the console</td>
+ </tr>
+ <tr>
+ <td>true</td>
+ <td>message will ALSO be sent to the console</td>
+ </tr>
+ </table>
+
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ file.size
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ Approximate log file size in bytes. 1MB = 1048576 bytes
+ </font>
+</td>
+ </tr>
+ <tr>
+ <td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top"
align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+ file.backups
+ </font>
+</td>
+ <td bgcolor="#a0ddf0" colspan="" rowspan=""
valign="top" align="left">
+ <font color="#000000" size="-1" face="arial,helvetica,sanserif">
+
+ Number of backup log files to maintain. The actual number of log
files
+ will be file.backups + 1.
+
+ </font>
+</td>
+ </tr>
+ </table>
+ </blockquote>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
+ <table border="0"
cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#828DA6">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Example configuration"><strong>Example configuration</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+ <p>
+ The following confuration will rotate the logging among 6 files. All
logging
+ will be at the DEBUG level.
+ </p>
+ <div align="left">
+ <table cellspacing="4" cellpadding="0" border="0">
+ <tr>
+ <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ </tr>
+ <tr>
+ <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#ffffff"><pre>
+# -------------------------------------------------------------------
+#
+# L O G S
+#
+# -------------------------------------------------------------------
+# This is the configuration for the logging system. In most cases
+# you don't need to modify anything. However, if you wish to add more
+# facilities or modify the existing settings, then you can do so.
+#
+# destination.file: A path relative to the web app root
+# -------------------------------------------------------------------
+services.LoggingService.facilities=rotation,system,debug
+services.LoggingService.default=rotation
+services.LoggingService.loggingConfig=org.apache.turbine.services.logging.PropertiesLoggingConfig
+
+# A facility for system logging.
+services.LoggingService.system.destination.file=/WEB-INF/log/jetspeed.log
+services.LoggingService.system.className=org.apache.turbine.services.logging.Log4JavaLogger
+services.LoggingService.system.level=DEBUG
+
+# A facility for the scheduler service
+# To disable started/stopped messages set the level to ERROR
+services.LoggingService.scheduler.destination.file=/WEB-INF/log/jetspeed.log
+services.LoggingService.scheduler.className=org.apache.turbine.services.logging.Log4JavaLogger
+services.LoggingService.scheduler.level=DEBUG
+
+# A facility for debugging applications. Messages will go both
+# to the log file and the server console.
+services.LoggingService.debug.destination.file=/WEB-INF/log/jetspeed.log
+services.LoggingService.debug.destination.console=true
+services.LoggingService.debug.className=org.apache.turbine.services.logging.Log4JavaLogger
+services.LoggingService.debug.level=DEBUG
+
+# A facility for SQL query logging
+# To enable SQL query logging, set the level to DEBUG
+services.LoggingService.sql.destination.file=/WEB-INF/log/jetspeed.log
+services.LoggingService.sql.className=org.apache.turbine.services.logging.Log4JavaLogger
+services.LoggingService.sql.level=DEBUG
+
+# A facility for security audit. NOTE! As of 23 Jan 2001
+# Turbine does not have any standard security auditing
+# functionality. It's up to your application.
+services.LoggingService.security.destination.file=/WEB-INF/log/jetspeed.log
+services.LoggingService.security.className=org.apache.turbine.services.logging.Log4JavaLogger
+services.LoggingService.security.level=DEBUG
+
+# An example configuration for automatic log rotation using Log4Java
+# This will keep the log file size under 1MB and save up to 5 backup copies
+services.LoggingService.rotation.destination.file=/WEB-INF/log/jetspeed.log
+services.LoggingService.rotation.file.size=1048576
+services.LoggingService.rotation.file.backups=5
+services.LoggingService.rotation.className=org.apache.turbine.services.logging.Log4JavaLogger
+services.LoggingService.rotation.level=DEBUG
+
+</pre></td>
+ <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
+ </tr>
+ <tr>
+ <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
+ <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
+ </tr>
+ </table>
+ </div>
+ </blockquote>
+ </td></tr>
+ <tr><td><br/></td></tr>
+ </table>
</blockquote>
</p>
</td></tr>
@@ -324,7 +872,7 @@
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
+ <p><center>This section is
incomplete</center></p>
<p>
</p>
</blockquote>
@@ -340,8 +888,9 @@
</td></tr>
<tr><td>
<blockquote>
- <p><center><strong>This section is
incomplete</strong></center></p>
+ <p><center>This section is
incomplete</center></p>
<p>
+ Backup early and often!
</p>
</blockquote>
</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
