Mercurial > p > roundup > code
comparison doc/installation.txt @ 3736:a2d22d0de0bc
WSGI support via roundup.cgi.wsgi_handler
| author | Richard Jones <richard@users.sourceforge.net> |
|---|---|
| date | Thu, 09 Nov 2006 00:36:21 +0000 |
| parents | e6ef9abfe403 |
| children | 9f4dd27ae843 |
comparison
equal
deleted
inserted
replaced
| 3735:e8d4ac23692f | 3736:a2d22d0de0bc |
|---|---|
| 316 | 316 |
| 317 1. `web server cgi-bin`_ | 317 1. `web server cgi-bin`_ |
| 318 2. `stand-alone web server`_ | 318 2. `stand-alone web server`_ |
| 319 3. `Zope product - ZRoundup`_ | 319 3. `Zope product - ZRoundup`_ |
| 320 4. `Apache HTTP Server with mod_python`_ | 320 4. `Apache HTTP Server with mod_python`_ |
| 321 5. `WSGI handler`_ | |
| 321 | 322 |
| 322 You may need to give the web server user permission to access the tracker home | 323 You may need to give the web server user permission to access the tracker home |
| 323 - see the `UNIX environment steps`_ for information. You may also need to | 324 - see the `UNIX environment steps`_ for information. You may also need to |
| 324 configure your system in some way - see `platform-specific notes`_. | 325 configure your system in some way - see `platform-specific notes`_. |
| 325 | 326 |
| 345 | 346 |
| 346 More information about ISS setup may be found at: | 347 More information about ISS setup may be found at: |
| 347 | 348 |
| 348 http://support.microsoft.com/default.aspx?scid=kb%3Ben-us%3B276494 | 349 http://support.microsoft.com/default.aspx?scid=kb%3Ben-us%3B276494 |
| 349 | 350 |
| 350 Copy the ``cgi-bin/roundup.cgi`` file to your web server's ``cgi-bin`` | 351 Copy the ``frontends/roundup.cgi`` file to your web server's ``cgi-bin`` |
| 351 directory. You will need to configure it to tell it where your tracker home | 352 directory. You will need to configure it to tell it where your tracker home |
| 352 is. You can do this either: | 353 is. You can do this either: |
| 353 | 354 |
| 354 Through an environment variable | 355 Through an environment variable |
| 355 Set the variable TRACKER_HOMES to be a colon (":") separated list of | 356 Set the variable TRACKER_HOMES to be a colon (":") separated list of |
| 505 </Directory> | 506 </Directory> |
| 506 <Directory /var/db/roundup/devel> | 507 <Directory /var/db/roundup/devel> |
| 507 PythonOption TrackerHome /var/db/roundup/devel | 508 PythonOption TrackerHome /var/db/roundup/devel |
| 508 </Directory> | 509 </Directory> |
| 509 | 510 |
| 511 WSGI Handler | |
| 512 ~~~~~~~~~~~~ | |
| 513 | |
| 514 The WSGI handler is quite simple. The following sample code shows how | |
| 515 to use it:: | |
| 516 | |
| 517 from wsgiref.simple_server import make_server | |
| 518 | |
| 519 # obtain the WSGI request dispatcher | |
| 520 from roundup.cgi.wsgi_handler import RequestDispatcher | |
| 521 tracker_home = 'demo' | |
| 522 app = RequestDispatcher(tracker_home) | |
| 523 | |
| 524 httpd = make_server('', 8917, app) | |
| 525 httpd.serve_forever() | |
| 526 | |
| 527 To test the above you should create a demo tracker with ``python demo.py``. | |
| 528 Edit the ``config.ini`` to change the web URL to "http://localhost:8917/". | |
| 529 | |
| 510 | 530 |
| 511 Configure an Email Interface | 531 Configure an Email Interface |
| 512 ---------------------------- | 532 ---------------------------- |
| 513 | 533 |
| 514 If you don't want to use the email component of Roundup, then remove the | 534 If you don't want to use the email component of Roundup, then remove the |