# Readme for using Mason in XCGI scripts running under Stunnix Perl Web Server

## Running a sample

To run a sample, just execute a script "startit.pl" in the current directory. It requires Perl to be installed in the system, and Mason modules with all its dependancies to be installed too! If this requirement is satisfied, just run that script in any filemanager or a shell (if using Windows - just doubleclick on it).

There is a sample CD prototype available for download Stunnix web site that includes Mason, all its dependancies and perl interpreters for Linux and Windows, with the same site as this archive.

When Mason-based site is run this way, all Mason modules are loaded only once after first access to the URL that needs to be handled with Mason similar to how Mason works in mod_perl or mod_fastcgi environment.

## Using a sample as a template for your Mason-based site

- Put a purchased perl modules of Stunnix Perl Web Server to 'stunnix-webserver/' (replacing all corresponding files);
- Put all static content to 'www/root';
- Put all Mason components to 'www/apps/mason-components' (if you wish to put put components to the $DOCUMENT_ROOT, put them to 'www/root' and disable passing parameter 'comp_root' in the construction of 'HTML::Mason::CGIHandler' in the 'www/apps/lib/mason.pm';
- If you need to alter parameters passed to 'HTML::Mason::CGIHandler', update 'www/apps/lib/mason.pm';
- Edit last portion of 'stunnix-webserver/httpd.conf' - the regular expression in 'LocationMatch' - to reflect the expression for selecting all files with mason components (in this sample, all files with '.zzhtml' extension are treated as Mason components and handled by Mason handler)