[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