1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
<HTML>
<HEAD>
<TITLE>Now whom do we write to congress about?</TITLE>
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#00FFFF" VLINK="#FF00FF" ALINK="#FF0000">
<H1>FAQ.</H1>
<BR> <A HREF="#_1_1">So what is ModRelocate?</A></BR>
<BR> <A HREF="#_1_2">Where do I get it from?</A></BR>
<BR> <A HREF="#_1_3">What sort of license does it have?</A></BR>
<BR> <A HREF="#_1_4">How can I make suggestions for it?</A></BR>
<BR> <A HREF="#_1_5">How can I report a bug?</A></BR>
<BR> <A HREF="#_1_6">How do I install it?</A></BR>
<BR> <A HREF="#_1_7">How do I use it?</A></BR>
<BR> <A HREF="#_1_8">What are the directives?</A></BR>
<BR> <A HREF="#_1_9">So what are triggers and what can I do with them?</A></BR>
<BR> <A HREF="#_1_10">I already use _URL, is there a way to change it?</A></BR>
<BR><H3><A NAME="_1_1"></A>So what is ModRelocate?</H3>
<P>ModRelocate was designed to replace generic clickthrough
CGIs. It has the advantage that it works as a virtual document
and that it will pass along additional URI arguments to
the remote URL. All of this flexibility makes it easier to
provide yourself with useful log information.</P>
<BR><H3><A NAME="_1_2"></A>Where do I get it from?</H3>
<P>You can get it from either <A HREF="http://www.tangent.org/mod_relocate/download.html">here</A> via the web or <A HREF="ftp://www.tangent.org/pub/apache/">here</A> via ftp.
<BR><H3><A NAME="_1_3"></A>What sort of license does it have?</H3>
<P>You are pretty much free to use it as you please. Check
out the License file with the distribution for more details. In
all likelihood I will switch to either GNU or Apache style
licensing at some point in the future.</P>
<BR><H3><A NAME="_1_4"></A>How can I make suggestions for it?</H3>
<P>Send email to <A HREF="mailto:brian@tangent.org.">brian@tangent.org.</A></P>
<BR><H3><A NAME="_1_5"></A>How can I report a bug?</H3>
<P>Send email to <A HREF="mailto:brian@tangent.org.">brian@tangent.org</A>. </P>
<BR><H3><A NAME="_1_6"></A>How do I install it?</H3>
<P>From the INSTALL file:</P>
<BR>
<P>Do you use DSO? If so just type make and</P>
<P>as long as apxs is in your path all things</P>
<P>should go smoothly.</P>
<P>If you are not using DSO you should be :)</P>
<BR>
<P>If for some reason you need to compile
apache try the following:</P>
<P>1. Change the current directory to the directory containing your
apache source distribution.</P>
<BR>
<P>2. Call the configure script as you normally would and add the
switch:</P>
<P>--add-module=<path-to-mod_relocate-directory>/mod_relocate.c</P>
<BR>
<P>3. Make sure the build environment is clean by issuing the
following</P>
<P> command:</P>
<P>> make clean</P>
<BR>
<P>4. Build the new httpd binary with:</P>
<P>> make</P>
<BR>
<P>5. Install the new httpd binary with:</P>
<P>> make install</P>
<BR><H3><A NAME="_1_7"></A>How do I use it?</H3>
<P>Once you have mod_relocate set up and going, it's time to modify the
httpd.conf file to use it. Add a line that says:
<PRE>
AddHandler relocate .relo
</PRE>
At this point you can create URL's in your documents like:.
<PRE>
http://www.tangent.org/?_URL=http://www.slashdot.org&key=value
</PRE>
All key pairs other then the _URL are passed along.
</P>
<BR><H3><A NAME="_1_8"></A>What are the directives?</H3>
<LI>RelocateTrigger</LI>
<LI>RelocatURLKey</LI>
<BR>
<BR><H3><A NAME="_1_9"></A>So what are triggers and what can I do with them?</H3>
<P>Triggers are CGI's or servlets that run whenever a relocate URL is called. They have three additional environment variables that are added (RELOCATE_SCRIPT_NAME, RELOCATE_PATH_INFO and RELOCATE_QUERY_STRING) that can be used by the trigger to determine action. Please note that it is very important that triggers do not print any data out as this could cause the Locate to fail.</P>
<BR><H3><A NAME="_1_10"></A>I already use _URL, is there a way to change it?</H3>
<P> Yes. Just use the RelocatURLKey directive to change the _URL key to whatever you need it to be.</P>
</BODY>
</HTML>
|
