Overview of Stunnix Perl Web Server package
Stunnix Perl Web Server comes as a .tar.gz archive that should be extracted using either WinZIP (on windows platforms) or by using tar and gzip utilities on unix-like OSes.
- /sample-image
- The files in this directory serves several purposes:
- This is a template of a directory root for multi-platform CDROM
image that includes
- copy of Stunnix Perl Web Server (located in /sample-image/site/stunnixwebsrv);
- dynamic web site (in /sample-image/site/www/root) that includes Project Manager for Stunnix Perl-Obfus;
- sample trivial XCGI script in /sample-image/site/www/apps/sample-lib/Mods/mod1.pm and an entry for it in /sample-image/site/www/root/sample-xcgi.xcgi;
- sample CGI script in /sample-image/site/www/root/sample-cgi.pl;
- copy of all documentation for Stunnix Perl Web Server (that's also a sample of Server-Parsed documents) in /sample-image/site/www/root/support/doc/ws/ (see on the recommended way of reading the documentation);
- Everything below /sample-image/site is an image from which single executable containing Perl interpreter, required core modules, Stunnix Perl Web Server and sample site can be built. Just run the script /sample-scripts/sample-make-exe.pl (after installing PAR and following all notes on installing PAR) and the executable file with name sample-site will be put into current directory.
- This is a template of a directory root for multi-platform CDROM
image that includes
- tools/
- contains various useful scripts, most notably packsite-par.pl
- sample-scripts/
- This directory contains sample scripts for performing various
tasks. Just execute sample-make-exe.pl script from there
without any arguments (after installing PAR and following all
notes on installing PAR)
to get a sample executable named 'sample-site' built with
Stunnix Perl Web Server included and Project Manager for
Stunnix Perl-Obfus as a sample site.
Executing sample-make-zip-with-deps.pl script from there without any arguments (after installing PAR and following all notes on installing PAR) will give you sample-site.zip in that directory containing all modules and their support files required for Stunnix Perl Web Server and sample site located in /sample-image.
Recommended way of reading documentation on Stunnix Perl Web Server
Documentation on Stunnix Perl Web Server comes in /sample-image/site/www/root/support/doc/ws/ and it contains Server Side Includes and other constructs available in Server Parsed documents. Due to this fact it's inconvenient to open documentation directly from your disk - the recommended way is to start Stunnix Perl Web Server (by executing /sample-image/site/stunnixwebsrv/startsite.pl - e.g. by double-clicking on it in Windows Explorer), and following the first link in the default document that is opened for the site.
Adding perl interpreter and core modules for running sample site on the system without Perl interpreter installed
In order to make the sample CDROM prototype not to require Perl interpreter in the system, you have to build a list of core modules required by web server and site (in general - by using tools/packsite-par.pl utility, for sample site - by invoking /sample-scripts/sample-make-zip-with-deps.pl script without any arguments). After using either of the methods, you'll get a .zip file in your current directory. You have to put the content of the 'lib' directory to the directory of the CDROM prototype corresponding to the operating system - /sample-image/perl/linux-x86/lib for Linux running on x86 CPUs and to /sample-image/perl/win32/lib for Windows OSes. You will also have to put Perl interpreter itself and its support files to the corresponding directory too - put /usr/bin/perl to /sample-image/perl/linux-x86/ for Linux on x86 CPUs, and put c:\perl\bin\wperl.exe and c:\perl\bin\perl58.dll or c:\perl\bin\perl56.dll to /sample-image/perl/win32/ for Windows platforms.
There are files named 'filelist' in /sample-image/perl/linux-x86/ and /sample-image/perl/win32/ listing all files that were put for some versions of the Perl interpreters.
The sample CD prototype with Perl interpreters included for Linux on x86 and Windows OSes is available online on Stunnix site - you can also just extract and copy content of the perl directory to the /sample-image/perl/ instead of making all steps outlined above.