ramkrishanbhatt / modwsgi

Automatically exported from code.google.com/p/modwsgi
0 stars 0 forks source link

InstallationOnWindows should mention limitations #248

Closed GoogleCodeExporter closed 8 years ago

GoogleCodeExporter commented 8 years ago
The http://code.google.com/p/modwsgi/wiki/InstallationOnWindows page should 
mention the limitations of mod_wsgi on Windows, i.e. that it does not support 
daemon mode.

Original issue reported on code.google.com by ch.zwerschke@gmail.com on 8 Oct 2011 at 11:32

GoogleCodeExporter commented 8 years ago
Front page of the mod_wsgi site says:

""'An alternate mode of operation available with Apache 2.X on UNIX is 'daemon' 
mode."""

and:

"""Daemon mode of mod_wsgi will however only be available on Apache 2.0 or 2.2 
running on UNIX, and only when the Apache runtime library underlying Apache has 
been compiled with support for threading."""

The documentation on the WSGIDaemonProcess directive says:

"""Note that the WSGIDaemonProcess directive and corresponding features are not 
available on Windows or when running Apache 1.3."""

There are various other references in documentation where it talks about daemon 
mode saying it it is available only on UNIX.

I can add something to the installation page for Windows, but it is meant to be 
about installation. It is not meant to try and condense into one page all the 
differences that exist when running on Windows. If that was done the page would 
be huge. So, it is sort of assumed that you would actually read the other 
documentation on the site in order to work out what mod_wsgi can do and how to 
set it up.

Original comment by Graham.Dumpleton@gmail.com on 8 Oct 2011 at 11:58

GoogleCodeExporter commented 8 years ago
Graham, you're right, but the problem here is that if you install it on Windows 
and use it with a configuration file with WSGIDaemonProcess in it (maybe just 
copying it from a Linux installation), then you get a misleading error message 
that looks like mod_wsgi is not properly installed, so you start looking for 
hints in the installation docs, not in the rest of the docs. And when googling 
for the error message, I found some forum postings of people who stumbled over 
the same problem, therefore my suggestions. You don't need to list all the 
differences, it will suffice if the page just gives a small hint saying that 
mod_wsgi under Windows does not support all features and directives, and refer 
people to the other docs for details.

Original comment by ch.zwerschke@gmail.com on 8 Oct 2011 at 12:26

GoogleCodeExporter commented 8 years ago
Yep, no problem with that. Just don't expect quick change, the documentation is 
being transitioned to github and ReadTheDocs at the moment and am quite busy.

Original comment by Graham.Dumpleton@gmail.com on 9 Oct 2011 at 1:10

GoogleCodeExporter commented 8 years ago
Closing out documentation issues. Will pick up another time on github side when 
get enough momentum to work on documentation again.

Original comment by Graham.Dumpleton@gmail.com on 12 Nov 2014 at 10:59