3 *** Apache FastCGI Module Installation ***
9 See docs/mod_fastcgi.html for configuration information.
11 This module supports Apache 1.3+. If your server is 1.2 based, either
12 upgrade or use mod_fastcgi v2.0.18.
14 mod_fastcgi has not been tested on all of the Apache supported
15 platforms. These are known to work: SunOS, Solaris, SCO, Linux,
16 Digital Unix, IRIX, FreeBSD and QNX (Inet sockets only). The Windows
17 NT port is available for beta testing. If you're successful in using
18 this module on other platforms, please email
19 fastcgi-developers@fastcgi.com.
21 This module is maintained at http://www.fastcgi.com.
23 See the web page for mailing list information.
29 There are three approaches to configure, compile, and install Apache.
31 o APACI - (Apache 1.3+) described in <apache_dir>/INSTALL
33 o manual - (original) described in <apache_dir>/src/INSTALL
35 o DSO (Dynamic Shared Object) - described in
36 <apache_dir>/htdocs/manual/dso.html
38 If you have a binary Apache distribution, such as Red Hat's Secure
39 Server (or prefer a DSO based Apache), you have to build mod_fastcgi
40 as a Dynamic Shared Object (DSO) - see Section 3.
42 If your on Windows NT, see Section 4.
45 1) Installing mod_fastcgi with APACI
46 ====================================
48 1. Copy or move the mod_fastcgi distribution directory to
49 <apache_dir>/src/modules/fastcgi.
51 2. Specify "--activate-module=src/modules/fastcgi/libfastcgi.a" as an
52 argument to ./configure from the <apache_dir> directory. If you've
53 previously used APACI to configure Apache, you can also specify this
54 as an argument to ./config.status (Apache 1.3.1+) in order to
55 preserve the existing configuration.
57 <apache_dir>$ ./configure \
58 --activate-module=src/modules/fastcgi/libfastcgi.a
62 <apache_dir>$ ./config.status \
63 --activate-module=src/modules/fastcgi/libfastcgi.a
65 3. Rebuild and reinstall Apache.
68 <apache_dir>$ make install
70 4. Edit the httpd configuration files to enable your FastCGI
71 application(s). See docs/mod_fastcgi.html for details.
73 5. Stop and start the server.
75 <apache_dir>$ /usr/local/apache/sbin/apachectl stop
76 <apache_dir>$ /usr/local/apache/sbin/apachectl start
79 2) Installing mod_fastcgi manually
80 ==================================
82 1. Copy or move the mod_fastcgi distribution directory to
83 <apache_dir>/src/modules/fastcgi.
85 2. Add the FastCGI module to <apache_dir>/src/Configuration. Note
86 that modules are listed in reverse priority order --- the ones that
87 come later can override the behavior of those that come earlier. I
88 put mine just after the mod_cgi entry.
90 AddModule modules/fastcgi/libfastcgi.a
92 3. From the <apache_dir>/src directory, reconfigure and rebuild Apache.
94 <apache_dir>/src$ ./Configure
95 <apache_dir>/src$ make
97 Install the new httpd.
99 4. Edit the httpd configuration files to enable your FastCGI
100 application(s). See docs/mod_fastcgi.html for details.
102 5. Stop and start the server.
104 $ kill -TERM `cat <run_dir>/logs/httpd.pid`
105 $ <run_dir>/bin/httpd -f <run_dir>/conf/httpd.conf
108 3) Installing mod_fastcgi as a DSO
109 ==================================
111 NOTE: If you use FastCgiSuexec, mod_fastcgi cannot reliably
112 determine the suexec path when built as a DSO. To workaround
113 this, provide the full path in the FastCgiSuexec directive.
115 1. From the mod_fastcgi directory, compile the module.
117 $ cd <mod_fastcgi_dir>
118 <mod_fastcgi_dir>$ apxs -o mod_fastcgi.so -c *.c
120 2. Install the module.
122 <mod_fastcgi_dir>$ apxs -i -a -n fastcgi mod_fastcgi.so
124 This should create an entry in httpd.conf that looks like this:
126 LoadModule fastcgi_module <some_path>/mod_fastcgi.so
128 Note that if there's a ClearModuleList directive after new entry,
129 you'll have to either move the LoadModule after the ClearModuleList
132 AddModule mod_fastcgi.c
134 3. Edit the httpd configuration file(s) to enable your FastCGI
135 application(s). See docs/mod_fastcgi.html for details.
137 If you want to wrap the mod_fastcgi directives, use:
139 <IfModule mod_fastcgi.c>
144 4. Stop and start the server.
146 $ <run_dir>/bin/apachectl stop
147 $ <run_dir>/bin/apachectl start
153 To build mod_fastcgi from the command line:
155 1. Edit the APACHE_SRC_DIR variable in Makefile.nt.
159 > nmake -f Makefile.nt CFG=[debug | release]
161 To build mod_fastcgi as a project you'll need M$ VC++ 6.0:
163 1. Open the mod_fastcgi project file with the VC++.
165 2. Edit the Project for your configuration.
167 a) Select Project->Settings or press <ALT+F7>.
169 b) Select "All Configurations" from "Settings For" drop-down menu.
171 c) Select the "C/C++" tab.
173 d) Select "Preprocessor" from the "Category" drop-down menu.
175 e) Edit the path in "Additional include directories" to include your
176 Apache source header files (e.g. C:\apache_1.3.12\src\include).
178 f) Select the "Link" tab.
180 g) Select "General" from the "Category" drop-down menu.
182 h) Select "Win32 Release" from "Settings For" drop-down menu.
184 i) Edit the path in "Object/library modules" to include your Apache
185 Release library (e.g. C:\apache_1.3.12\src\CoreR\ApacheCore.lib).
187 j) Select "Win32 Debug" from "Settings For" drop-down menu.
189 k) Edit the path in "Object/library modules" to include your Apache
190 Debug library (e.g. C:\apache_1.3.12\src\CoreD\ApacheCore.lib).
194 3. Select "Set Active Configuration" from the "Build" menu and choose
195 either a release or debug build.
197 4. Select "Build mod_fastcgi.dll" from the "Build" menu.
199 To install mod_fastcgi:
201 1. Copy the mod_fastcgi.dll (from either the Debug or Release
202 directory, as appropriate) to the Apache modules directory
203 (e.g. C:\Apache\modules)
205 2. Edit the httpd configurion file (e.g. C:\Apache\conf\httpd.conf)
208 LoadModule fastcgi_module modules/mod_fastcgi.dll
210 3. Edit the httpd configuration file(s) to enable your FastCGI
211 application(s). See docs/mod_fastcgi.html for details.