Configuring FastCGI on Apache on Windows

1. (And adding it as a local service)

Moin in the standard CGI configuration is perfectly fine for small workgroups or internal wiki's. But, if you want to take your wiki performance to the next level, FastCGI is the way to go. FastCGI will have a noticeable and dramatic impact on speed, which is particularly noticeable on pages with lots of images. Among other tricks, FastCGI works by keeping the python process open, thereby reducing the small delay caused by waiting for a python process to open for each request. More info is available on the FastCGI webpage.

This document borrows from HelpOnInstalling/FastCgi; but here I try to provide a concrete example that will give you a working wiki on the Windows platform, detailing all the files that need to be configured within your moin setup.

2. Prerequisites & Requirements

  1. You already have working copy of MoinMoin on Windows - (See HelpOnInstalling/ApacheOnWin32)

  2. You're running Moin version 1.5.x or later.

  3. Assumes your wiki instance is located at d:\moin\mywiki (You will have to adjust these instructions to your specific set up).

  4. If you run (or anticipate running) multiple wiki's on the same server, you will want to have your wiki-farm configured and working first. (You will make life easier for yourself-- because of how FastCGI works, you will not be able to easily call two .FCG files at the same time (nor will it make sense to) from setting up the WikiFastCGIservice below, etc. If you are only setting up one wiki, then by all means, proceed... (see also HelpOnConfiguration and FarmQuestions).

(See also HelpOnInstalling/FastCgi)

3. Install FastCGI

  1. Download the latest compiled mod_fastcgi.dll from http://fastcgi.com/dist/ e.g., mod_fastcgi-SNAP-0404142202-AP2.dll

  2. Optionally rename it to mod_fastcgi.dll (if you choose not to rename it, be sure to specify the full name in the LoadModule line on the httpd.conf file).

  3. Copy it into the Apache2\modules folder at c:\Program Files\Apache Software\Apache2\modules\.

4. FastCGI MoinMoin Configuration

  1. Copy moin.fcg from d:\Python25\share\moin\server to your instance home, d:\Moin\mywiki

  2. Modify the moin.fcg to match your configuration:

    1. Change the first-line shebang statement to point to your python installation. This would be exactly has your old working moin.cgi file: 

       #! d:/Python25/python

    2. change the sys.path.insert like to point to your wikiconfig.py file (again, just like in your old working moin.cgi file). If you're using a farm, point instead to your farmconfig.py file: 

      sys.path.insert(0, r'd:\moin\mywiki\wikiconfig.py')

    3. The last lines of the moin.fcg file will be similar to below. For Windows, we need to specify a port number. You can select other port number other than 9001, but it should match the one in httpd.conf (see next section below). (note: in case your browser window wraps the below example, the fcg = thfcgi.FCGI is all one line, and fcg.run() is on it's own separate line). 

      if __name__ == '__main__':
    fcg = thfcgi.FCGI(handle_request, port=9001, max_requests=max_requests, backlog=backlog, max_threads=max_threads)
    fcg.run()

5. httpd.conf Configuration

Open your Apache config file (c:\Program Files\Apache Software\Apache2\conf\), and add the following directives:

  1. Scroll down to the LoadModule section and add mod_fastcgi.dll, like in the example below (if you didn't rename your file, you'll need to exactly to match your file name): 

    LoadModule fastcgi_module modules/mod_fastcgi.dll

  2. Scroll down to the AddHandler section and add the following: 

    AddHandler fastcgi-script .fcg

  3. Modify your ScriptAlias line to point to your moin.fcg file (fas we configured in the section above). There are two options here; if you are running a single wiki, use i. If you have a wiki farm, use ii:

    1. Example if you're running a single wiki: 
      ScriptAlias /mywiki    "d:/Moin/mywiki/moin.fcg"
    2. Example if you're running multiple wiki's (i.e. a wiki farm): 
      ScriptAlias /mywiki     "d:/Moin/moin.fcg"
ScriptAlias /yourwiki   "d:/Moin/moin.fcg"
ScriptAlias /theirwiki  "d:/Moin/moin.fcg"

  4. Register the moin.fcg as an external server. This needs to match the port we specified in moin.fcg in the steps above (if you changed the port number). Make sure the path to moin.fcg points to the correct location. We'll also specify the loopback IP, instead of the interface IP, so that it will work even if the computer's IP address changes. 

    FastCgiExternalServer d:/Moin/mywiki/moin.fcg -host 127.0.0.1:9001

When finished, you should have something similar to this at the tail of your httpd.conf file: 

### point to the python wiki htdocs:
Alias       /wiki/    "D:/Python25/share/moin/htdocs/"
### Your ScriptAlias(es) need to point to your .fcg files:
ScriptAlias /mywiki    "D:/moin/moin.fcg"
ScriptAlias /yourwiki   "D:/moin/moin.fcg"
### Setting the external server:
FastCgiExternalServer d:/Moin/moin.fcg -host 127.0.0.1:9001

Move your old moin.cgi elsewhere to ensure that it's not being called.

You're done! Now it's time to test.

Open a commandline window (Start > Run... > type cmd), navigate to your moin.fcg location, and type the following command (substituting your python path, as necessary). Leave the window open while you test (closing it will quit the python process). 

d:\python25\python moin.fcg

If all went well (and you marveled at how much faster moin is now), you can now proceed to the next section to register moin.fcg as a local service. This ensures that moin will come up across restarts.