Author: crossley
Date: Fri Mar 18 06:42:13 2011
New Revision: 1082828
URL: http://svn.apache.org/viewvc?rev=1082828&view=rev
Log:
Explain the log files.
Modified:
forrest/trunk/site-author/content/xdocs/zone.xml
Modified: forrest/trunk/site-author/content/xdocs/zone.xml
URL:
http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/zone.xml?rev=1082828&r1=1082827&r2=1082828&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/zone.xml (original)
+++ forrest/trunk/site-author/content/xdocs/zone.xml Fri Mar 18 06:42:13 2011
@@ -158,12 +158,29 @@ forrestbot operating with trunk-stable.
builds various sites, only runs when needed, triggered via cron.
Configuration files and the generated results are at $DOC_ROOT/fts/
</source>
+ </section>
+ <section id="logs">
+ <title>Log files</title>
+ <p>
+ Forrestbot logs are at <code>$CONFIG/forrestbot-trunk/logs/</code>
+ and old ones are cleaned up daily by the crontab.
+ The content is sent to the dev list whenever a non-successful build
happens.
+ </p>
<p>
- Forrestbot logs are at $CONFIG/forrestbot-trunk*/logs/ and old ones are
- cleaned up by the crontab. There is also a log file for each site that
+ The Cocoon logfiles for each built site are at
+ <code>$CONFIG/forrestbot-trunk/conf/work/*/webapp/WEB-INF/logs/</code>
+ (which of course are re-generated on each hourly run).
+ </p>
+ <p>
+ There is also a log file for each site that
forrestbot builds which captures the output of cron (cronout-*.txt). Be
sure to verify this logfile after making configuration changes.
</p>
+ <p>
+ Whenever the 'forrest' software automatically updates following
commits,
+ then there will be a logfile at the <code>$CONFIG</code> top-level
directory.
+ Old ones are cleaned up daily by the crontab.
+ </p>
</section>
<section id="admin">
<title>Administration</title>
