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 "Swazoo" directory contains the main Swazoo 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 "SZ Swazoo UI" package from the "Steve Waring\Swazoo" folder.

Tests

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

Configuration

The "Swazoo UI" package installs the "Swazoo Control" tool. This allows you to change configuration settings in the "User Preferences" folder.

The "configurationFolder" and "logFolder" are pathNames relative to the imageDirectory. The default settings will be used in the Testing site (explained below).

Testing

Open the "Swazoo Control Shell", which is found in the Tools/Additional Tools menu.

In the configuration menu, choose the "Test" command to create and start a Site with a number of sample resources.

In your browser go to the following urls:

• http://localhost/Howdy A SwazooHelloWorld resource.
• http://localhost/GDay A SwazooHelloWorld resource which delays 5 seconds before responding.
• http://localhost/oops A Resource that signals an Error (Try evaluating "HTTPResponse isDebug: true").
• http://localhost/chunked A ChunkedTransfer resource which transfers chunks 5 seconds apart.
• http://localhost/session/test Example use of the CookieResource and sessions.
• http://localhost/files/test.html Example use of the FileResource.

Deploying

You can create a Swazoo Site (and start a server on it) by:

• Creating a SwazooScript file (*.ssst) or a Swazoo configuration file (*.cnf). Examples can be found in the "Swazoo\conf\" folder. The disadvantage of this approach is that the scripts contain executable code and may fail if the prerequiste resources are not installed in the image.
• Using a SessionManager.

The "SV Swazoo TestSample" package contains a SessionManagerwhich can be used to deploy the TestSample as a "ToGo" application. This application can be downloaded at: DHSZTestSample.zip (610k)

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

The SessionManager recognizes certain command line parameters: