Index: openacs-4/packages/acs-core-docs/www/analog-setup.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/analog-setup.adp,v
diff -u -N
--- /dev/null	1 Jan 1970 00:00:00 -0000
+++ openacs-4/packages/acs-core-docs/www/analog-setup.adp	23 Sep 2015 11:54:19 -0000	1.1.2.1
@@ -0,0 +1,72 @@
+
+<property name="context">{/doc/acs-core-docs {Documentation}} {Set up Log Analysis Reports}</property>
+<property name="doc(title)">Set up Log Analysis Reports</property>
+<master>
+<include src="/packages/acs-core-docs/lib/navheader"
+		    leftLink="install-ssl" leftLabel="Prev"
+		    title="
+Chapter 6. Production Environments"
+		    rightLink="uptime" rightLabel="Next">
+		<div class="sect1">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="analog-setup" id="analog-setup"></a>Set up Log Analysis Reports</h2></div></div></div><p>Analog is a program with processes webserver access logs,
+performs DNS lookup, and outputs HTML reports. Analog should
+<a class="link" href="analog-install" title="Install Analog web file analyzer">already be installed.</a> A
+modified configuration file is included in the OpenACS tarball.</p><div class="orderedlist"><ol class="orderedlist" type="1">
+<li class="listitem">
+<pre class="screen">
+[root src]# <strong class="userinput"><code>su - $OPENACS_SERVICE_NAME</code></strong>
+[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <strong class="userinput"><code>cd /var/lib/aolserver/$OPENACS_SERVICE_NAME</code></strong>
+[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <strong class="userinput"><code>mkdir www/log</code></strong>
+[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <strong class="userinput"><code>cp -r /usr/share/analog-5.32/images www/log/</code></strong>
+[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <span class="action"><span class="action">
+su - $OPENACS_SERVICE_NAME
+cd /var/lib/aolserver/$OPENACS_SERVICE_NAME
+cp /var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/acs-core-docs/www/files/analog.cfg.txt etc/analog.cfg
+mkdir www/log
+cp -r /usr/share/analog-5.32/images www/log/</span></span>
+</pre><p>Edit <code class="computeroutput">/var/lib/aolserver/$OPENACS_SERVICE_NAME/etc/analog.cfg</code>
+and change the variable in <code class="computeroutput">HOSTNAME
+"[my organisation]"</code> to reflect your website title. If you
+don't want the traffic log to be publicly visible, change
+<code class="computeroutput">OUTFILE
+/var/lib/aolserver/$OPENACS_SERVICE_NAME/www/log/traffic.html</code>
+to use a private directory. You'll also need to edit all instances
+of service0 to your $OPENACS_SERVICE_NAME.</p>
+</li><li class="listitem">
+<p>Run it.</p><pre class="screen">
+[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <strong class="userinput"><code>/usr/share/analog-5.32/analog -G -g/var/lib/aolserver/$OPENACS_SERVICE_NAME/etc/analog.cfg</code></strong>
+/usr/share/analog-5.32/analog: analog version 5.32/Unix
+/usr/share/analog-5.32/analog: Warning F: Failed to open DNS input file
+  /home/$OPENACS_SERVICE_NAME/dnscache: ignoring it
+  (For help on all errors and warnings, see docs/errors.html)
+/usr/share/analog-5.32/analog: Warning R: Turning off empty Search Word Report
+[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$
+</pre><p>Verify that it works by browing to <code class="computeroutput">http://yourserver.test:8000/log/traffic.html</code>
+</p>
+</li><li class="listitem">
+<p>Automate this by creating a file in <code class="computeroutput">/etc/cron.daily</code>.</p><pre class="screen">
+[$OPENACS_SERVICE_NAME $OPENACS_SERVICE_NAME]$ <strong class="userinput"><code>exit</code></strong>
+logout
+
+[root root]# <strong class="userinput"><code>emacs /etc/cron.daily/analog</code></strong>
+</pre><p>Put this into the file:</p><pre class="programlisting">
+#!/bin/sh
+
+/usr/share/analog-5.32/analog -G -g/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/etc/analog.cfg
+</pre><pre class="screen">
+[root root]# <strong class="userinput"><code>chmod 755 /etc/cron.daily/analog</code></strong>
+</pre><p>Test it by running the script.</p><pre class="screen">
+[root root]# <strong class="userinput"><code>sh /etc/cron.daily/analog</code></strong>
+</pre><p>Browse to <code class="computeroutput">http://<span class="replaceable"><span class="replaceable">yourserver.test</span></span>/log/traffic.html</code>
+</p>
+</li>
+</ol></div>
+</div>
+<include src="/packages/acs-core-docs/lib/navfooter"
+		    leftLink="install-ssl" leftLabel="Prev" leftTitle="Installing SSL Support for an OpenACS
+service"
+		    rightLink="uptime" rightLabel="Next" rightTitle="External uptime validation"
+		    homeLink="index" homeLabel="Home" 
+		    upLink="maintenance-web" upLabel="Up"> 
+		
\ No newline at end of file