Web Connector Installation

This section provides instructions for installing one the available Porcupine Web Connectors. Since Porcupine does dot include a web server the installation of a web connector is required in order to have a working installation. The Web Connectors available support a wide range of web servers. The supported protocols include Win32 CGI, WSGI and MOD_PYTHON.

All connectors come with a small configuration file named "server.ini". For the moment, this file only contains the address of the Porcupine server used for accepting incoming web requests as set in the main Porcupine configuration file (porcupine.conf). By default this address is set to "localhost:21567". If you need to have the web server and Porcupine running on different servers then edit this file accordingly.

Installing the WSGI connector

This connector is aimed for web servers that support the WSGI protocol including web servers such as Apache with MOD_WSGI or lighttpd.

This connector also comes with a script that allows Porcupine to run over wsgiServer (a simple Python based Web server) using WSGIUtils. If you have Python installed this is the simplest way of having a Porcupine installation up and running. Download the connector, unzip it and then run:

python ./wsgiServer.py

This script provides a minimalistic web server listening on port 1088. The Porcupine desktop is available at http://localhost:1088 (this of course requires that Porcupine is running). The port number can be easily changed by editing the aforementioned script file.

This article shows a straight forward way of how to configure WSGI with lighttpd.


Installing the Apache MOD_PYTHON connector

This connector requires MOD_PYTHON and is only targeted for the Apache web server.


Installing the win32 CGI connector

The win32 CGI connector is currently build with Python 2.6 and due to the fact that for every request an new Python interpreter executable is spawned, this connector is the most under performing one. Also, note that the latest Porcupine win32 binaries are built with Python 2.6. Before installing, ensure you have installed all of the required dependencies on the target machine. To check this run "porcupine.exe" from the command line.

If the output says "The system cannot execute the specified program" then you need to install the Microsoft's C++ 2008 redistributable package. Download it from here.

1. Installing the CGI connector on IIS.

2. Installing the CGI connector on Apache.


Post your comment


No one has commented on this page yet.

RSS feed for comments on this page | RSS feed for all comments

Clicky Web Analytics