[docs] docs - racke modified 2 files

docs@icdevgroup.org docs@icdevgroup.org
Mon Oct 14 09:17:00 2002


User:      racke
Date:      2002-10-14 13:16:45 GMT
Modified:  .        icadvanced.sdf icconfig.sdf
Log:
started documentation for usertracking features

Revision  Changes    Path
1.9       +23 -4     docs/icadvanced.sdf


rev 1.9, prev_rev 1.8
Index: icadvanced.sdf
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /var/cvs/docs/icadvanced.sdf,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- icadvanced.sdf	12 Apr 2002 22:53:18 -0000	1.8
+++ icadvanced.sdf	14 Oct 2002 13:16:45 -0000	1.9
@@ -1,10 +1,10 @@
 !init OPT_LOOK=3D"akopia"; OPT_STYLE=3D"manual"
-# $Id: icadvanced.sdf,v 1.8 2002/04/12 22:53:18 jon Exp $
+# $Id: icadvanced.sdf,v 1.9 2002/10/14 13:16:45 racke Exp $
=20
 !define DOC_NAME "Advanced Interchange Topics"
 !define DOC_TYPE ""
 !define DOC_CODE "icadvanced"
-!define DOC_VERSION substr('$Revision: 1.8 $',11, -2)
+!define DOC_VERSION substr('$Revision: 1.9 $',11, -2)
 !define DOC_STATUS "Draft"
 !define DOC_PROJECT "Interchange"
 !define DOC_URL "http://interchange.redhat.com/doc/icadvanced.html"
@@ -16,7 +16,8 @@
 * Interchange Administration Tool Development
 * Making catalog skeletons for use with makecat
 * Building custom link programs
-
+* Installation tips and troubleshooting
+* Usertracking
=20
 H1: Maintaining Interchange
=20
@@ -1016,6 +1017,24 @@
=20
 -The C<tlink> program does not have this problem, but it must have the pro=
per host name(s) and TCP ports set in the TcpHost and TcpMap directives in =
C<interchange.cfg>. Also, be careful of security if sensitive information, =
like customer credit card numbers, is being placed on a network wire.
=20
+H1: Usertracking
+
+Several actions from the user are recorded by Interchange's usertracking=
=20
+facility. The usertracking data is logged at two locations, depending on=
=20
+your setup.=20
+
+The first location is the one specified by the=20
+{{CMD[jump=3D"icconfig.html#TrackFile"]TrackFile}} configuration
+directive, e.g. C<logs/usertrack> in the foundation demo.
+
+The second location are the HTTP headers. You can configure Apache to
+write this header into the access logs.
+
+!block example
+LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %T=
 %v \"%{X-Track}o\"" track
+CustomLog /var/log/apache/access.log track
+!endblock
+
 Line:
=20
-N:Copyright 2001-2002 Red Hat, Inc. Freely redistributable under terms of =
the GNU General Public License.
+N:Copyright 2001-2002 Red Hat, Inc., and others. Freely redistributable un=
der terms of the GNU General Public License.



1.74      +5 -2      docs/icconfig.sdf


rev 1.74, prev_rev 1.73
Index: icconfig.sdf
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /var/cvs/docs/icconfig.sdf,v
retrieving revision 1.73
retrieving revision 1.74
diff -u -r1.73 -r1.74
--- icconfig.sdf	13 Sep 2002 15:17:33 -0000	1.73
+++ icconfig.sdf	14 Oct 2002 13:16:45 -0000	1.74
@@ -1,10 +1,10 @@
 !init OPT_LOOK=3D"akopia"; OPT_STYLE=3D"manual"
-# $Id: icconfig.sdf,v 1.73 2002/09/13 15:17:33 jon Exp $
+# $Id: icconfig.sdf,v 1.74 2002/10/14 13:16:45 racke Exp $
=20
 !define DOC_NAME "Configuration Reference"
 !define DOC_TYPE ""
 !define DOC_CODE "icconfig"
-!define DOC_VERSION substr('$Revision: 1.73 $',11, -2)
+!define DOC_VERSION substr('$Revision: 1.74 $',11, -2)
 !define DOC_STATUS "Draft"
 !define DOC_PROJECT "Interchange"
 !define DOC_URL "http://interchange.redhat.com/doc/icconfig.html"
@@ -2678,6 +2678,9 @@
 Name of a logfile that tracks user traffic. This is used in the back offic=
e administration report on traffic by affiliate.
=20
 The default is that no such file is kept.
+
+See {{CMD[jump=3D"icadvanced.html#Usertracking"]Usertracking}} for more
+information.
=20
 H2: UpsZoneFile
=20