dolphinharbor

Installation

Before you start

These packages are Dolphin 5 packages.

In the instructions that follow, the "A Dolphin 5 Image" directory contains a fresh Dolphin 5 image. The name of this directory is not significant, it is the image directory; the "$" folder in the Package Browser.

Download

Download the zip file to your image directory.

In the above screenshot, "A Dolphin 5 Image" is my image directory.

Expand the zip file in the image directory . This will create a "Steve Waring" directory, and a number of sub-directories. The "FS FastCGI" directory contains the main FastCGI packages.

Important: the "Steve Waring" directory must be a sub-directory of your image directory.

Install packages

Start the image and open the Package Browser. Install the "FS Dolphin" package from the "Steve Waring\FS FastCGI" folder.

Tests

The Tests packages in the "Steve Waring\FS FastCGI" folder can be installed and should run at 100%.

Install Apache

FastCGI support is currently only available for the Apache 1.3.* versions. To download a Win32 Apache binary see the Apache download page.

Install mod_fastcgi

The mod_fastcgi download can be found on the FastCGI homepage.

Apache FastCGI Module Installation

Note: The Win32 DLL download and install is a quick and easy way to get Apache+mod_fastcgi running. Download this DLL to your modules directory, and edit the DSO section of your httpd.conf file.

Configure Apache

The FastCGI homepage Apache mod_fastcgi documentation contains general information about mod_fastcgi as well as the directives you can use.

Note: The FastCgiExternalServer is a quick and easy way to configure mod_fastcgi for testing with a Dolphin FS FastCGI application.

Sample httpd.conf additions

      #Section 1:
      .
      .
      #Dynamic Shared Object (DSO) Support
      LoadModule fastcgi_module modules/mod_fastcgi.dll
      .
      AddModule mod_fastcgi.c
      .
      .
      #Section 2:
      .
      .
      FastCgiExternalServer /ns3 -host localhost:1990
      <Directory />
         SetHandler fastcgi-script
      </Directory>
      Alias /ns3 /ns3

      #To pass the full url namespace to the Fast application use:
      #Alias / /ns3

Testing the installation

Start Apache. The console window should show that mod_fastcgi is running.

In your Dolphin image evaluate:

FSDolphinDemoHandler startUp

Enter the port you used in the httpd.conf FastCgiExternalServer directive and hit Start.

In a browser go to the url you used in the http.conf:

Deployment

The "SV FastCGI DemoHandler" package contains a SessionManager which can be used to deploy the DemoHandler as a "ToGo" application. This application can be downloaded at: DHFSDemoHandler.zip (580k)

This application is running on dolphinharbor at: Demo Handler (Link will open in new browser).

The SessionManager recognizes certain command line parameters:

Steps