|
|||||||
1. Introduction
2. Installing Karrigell 3. The Web server 4. Configuration options 5. Working with Apache, LightTPD or Xitami 5.1 Apache 5.2 lighttpd 5.3 Xitami 6. Programming 7. Debugging 8. Python scripts 9. Karrigell Services 10. Python Inside HTML 11. HTML Inside Python 12. HTMLTags - generate HTML in Python 13. Including documents 14. Sessions 15. Authentication 16. Translation and Unicode |
5. Karrigell with Apache, lighttpd and XitamiAlthough Karrigell can work stand-alone with the integrated web server, you may want to use it with an external server. Apache is the most widespread server in the world, it has excellent performance and stability, it can work on secure mode (SSL), offers log services, etc.5.1 Apache5.1.1 IntroductionTo use Karrigell in Apache you'll need to download and install the following: I recommend you install the latest, stable version of each of the above. Apache will be used as a proxy between the client and the built-in server, so you have to configure Apache so that it sends the requests to the built-in server. Suppose you start Apache on port 80 and the built-in server on port 8081 I copy most of this section from Remi Delon's CherryPy documentation : http://www.cherrypy.org/wiki/BehindApache For Apache, all you need to do now is add a few lines to Apache's config file
In the Dynamic Shared Object (DSO) section, uncomment the lines LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so LoadModule rewrite_module modules/mod_rewrite.soSomewhere else in the main server configuration section, add the following lines to enable the proxy mode : ProxyRequests On <Proxy *> Order allow,deny Deny from none Allow from all </Proxy> To ask Apache to send the requests to the built-in server, use mod_rewrite. This module parses the original url and changes it according to regular expressions. Here the lines to add are : RewriteEngine On RewriteCond %{SCRIPT_FILENAME} !autostart\.cgi$ RewriteRule ^(.*) http://localhost:8081$1 [P] ErrorDocument 502 /cgi-bin/autostart.cgiThe main functionality is provided by the RewriteRule : it tells Apache to rewrite all the urls to an absolute url corresponding to the built-in server running on port 8081 and use the proxy mode to pass the request If the built-in server is not running, an HTTP error 502 is returned ; the last
line tells Apache to call the script autoscript.cgi is a short script, looking like this on Linux/Unix :
All you have to adapt is the location of python on the first line, and the
path to Start the built-in web server on port 8081 and start Apache. This should be
enough to get it going. Depending on what For security reasons, on Linux Karrigell should be started on a port above 1024 and not as root 5.1.2 Virtual HostsVirtual hosts can be used with Apache to serve different hosts on the same machine with the same server. Since version 2.2, Karrigell has support for virtual hosts, so that you can serve all the virtual hosts with the same instance of the built-in serverIf you have configured
NameVirtualHost 127.0.0.1:80 <VirtualHost 127.0.0.1:80> ServerName karrigell # for use with Karrigell RewriteEngine On RewriteCond %{SCRIPT_FILENAME} !autostart\.cgi$ RewriteRule ^(.*) http://karrigell:8081$1 [P] ErrorDocument 502 /cgi-bin/autostart.cgi </VirtualHost> Of course you change the address and port in <Virtual Host> to the appropriate values 5.2 lighttpdIn their own words :Security, speed, compliance, and flexibility--all of these describe LightTPD which is rapidly redefining efficiency of a webserver; as it is designed and optimized for high performance environments. With a small memory footprint compared to other web-servers, effective management of the cpu-load, and advanced feature set (FastCGI, CGI, Auth, Output-Compression, URL-Rewriting and many more) LightTPD is the perfect solution for every server that is suffering load problems. And best of all it's Open Source licensed under the revised BSD license. Configuration for Karrigell by Laurent Pointal
|