INSTALL

   1
   2
   3              ***  Apache FastCGI Module Installation  ***
   4
   5
   6 Notes
   7 =====
   8
   9   See docs/mod_fastcgi.html for configuration information.
  10
  11   This module supports Apache 1.3+.  If your server is 1.2 based, either
  12   upgrade or use mod_fastcgi v2.0.18.
  13
  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.
  20
  21   This module is maintained at http://www.fastcgi.com.
  22
  23   See the web page for mailing list information.
  24
  25
  26 Introduction
  27 ============
  28
  29   There are three approaches to configure, compile, and install Apache.
  30
  31     o APACI - (Apache 1.3+) described in <apache_dir>/INSTALL
  32
  33     o manual - (original) described in <apache_dir>/src/INSTALL
  34
  35     o DSO (Dynamic Shared Object) - described in
  36       <apache_dir>/htdocs/manual/dso.html
  37
  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.
  41
  42   If your on Windows NT, see Section 4.
  43
  44
  45 1) Installing mod_fastcgi with APACI
  46 ====================================
  47
  48   1. Copy or move the mod_fastcgi distribution directory to
  49      <apache_dir>/src/modules/fastcgi.
  50
  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.
  56
  57        <apache_dir>$ ./configure  \
  58                   --activate-module=src/modules/fastcgi/libfastcgi.a
  59
  60      or
  61
  62        <apache_dir>$ ./config.status  \
  63                   --activate-module=src/modules/fastcgi/libfastcgi.a
  64
  65   3. Rebuild and reinstall Apache.
  66
  67        <apache_dir>$ make
  68        <apache_dir>$ make install
  69
  70   4. Edit the httpd configuration files to enable your FastCGI
  71      application(s).  See docs/mod_fastcgi.html for details.
  72
  73   5. Stop and start the server.
  74
  75        <apache_dir>$ /usr/local/apache/sbin/apachectl stop
  76        <apache_dir>$ /usr/local/apache/sbin/apachectl start
  77
  78
  79 2) Installing mod_fastcgi manually
  80 ==================================
  81
  82   1. Copy or move the mod_fastcgi distribution directory to
  83      <apache_dir>/src/modules/fastcgi.
  84
  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.
  89
  90        AddModule modules/fastcgi/libfastcgi.a
  91
  92   3. From the <apache_dir>/src directory, reconfigure and rebuild Apache.
  93
  94        <apache_dir>/src$ ./Configure
  95        <apache_dir>/src$ make
  96
  97      Install the new httpd.
  98
  99   4. Edit the httpd configuration files to enable your FastCGI
 100      application(s).  See docs/mod_fastcgi.html for details.
 101
 102   5. Stop and start the server.
 103
 104        $ kill -TERM `cat <run_dir>/logs/httpd.pid`
 105        $ <run_dir>/bin/httpd -f <run_dir>/conf/httpd.conf
 106
 107
 108 3) Installing mod_fastcgi as a DSO
 109 ==================================
 110
 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.
 114
 115   1. From the mod_fastcgi directory, compile the module.
 116
 117        $ cd <mod_fastcgi_dir>
 118            <mod_fastcgi_dir>$ apxs -o mod_fastcgi.so -c *.c
 119
 120   2. Install the module.
 121
 122            <mod_fastcgi_dir>$ apxs -i -a -n fastcgi mod_fastcgi.so
 123
 124      This should create an entry in httpd.conf that looks like this:
 125
 126        LoadModule fastcgi_module  <some_path>/mod_fastcgi.so
 127
 128      Note that if there's a ClearModuleList directive after new entry,
 129      you'll have to either move the LoadModule after the ClearModuleList
 130      or add:
 131
 132            AddModule mod_fastcgi.c
 133
 134   3. Edit the httpd configuration file(s) to enable your FastCGI
 135      application(s).  See docs/mod_fastcgi.html for details.
 136
 137      If you want to wrap the mod_fastcgi directives, use:
 138
 139            <IfModule mod_fastcgi.c>
 140        .
 141        .
 142        </IfModule>
 143
 144   4. Stop and start the server.
 145
 146        $ <run_dir>/bin/apachectl stop
 147        $ <run_dir>/bin/apachectl start
 148
 149
 150 4) Windows NT
 151 =============
 152
 153   To build mod_fastcgi from the command line:
 154
 155     1. Edit the APACHE_SRC_DIR variable in Makefile.nt.
 156
 157     2. Build the module
 158
 159          > nmake -f Makefile.nt CFG=[debug | release]
 160
 161   To build mod_fastcgi as a project you'll need M$ VC++ 6.0:
 162
 163     1. Open the mod_fastcgi project file with the VC++.
 164
 165     2. Edit the Project for your configuration.
 166
 167       a) Select Project->Settings or press <ALT+F7>.
 168
 169       b) Select "All Configurations" from "Settings For" drop-down menu.
 170
 171       c) Select the "C/C++" tab.
 172
 173       d) Select "Preprocessor" from the "Category" drop-down menu.
 174
 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).
 177
 178       f) Select the "Link" tab.
 179
 180       g) Select "General" from the "Category" drop-down menu.
 181
 182       h) Select "Win32 Release" from "Settings For" drop-down menu.
 183
 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).
 186
 187       j) Select "Win32 Debug" from "Settings For" drop-down menu.
 188
 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).
 191
 192       l) Select OK.
 193
 194     3. Select "Set Active Configuration" from the "Build" menu and choose
 195        either a release or debug build.
 196
 197     4. Select "Build mod_fastcgi.dll" from the "Build" menu.
 198
 199   To install mod_fastcgi:
 200
 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)
 204
 205     2. Edit the httpd configurion file (e.g. C:\Apache\conf\httpd.conf)
 206        and add a line like:
 207
 208          LoadModule fastcgi_module modules/mod_fastcgi.dll
 209
 210     3. Edit the httpd configuration file(s) to enable your FastCGI
 211        application(s).  See docs/mod_fastcgi.html for details.